Snowflake Intelligence の概要¶

サポートされているモデルとリージョン¶

Snowflake Intelligence は以下のモードをサポートしています。これらのモデルは、アカウントにアクセスがある限り使用できます。詳細については、 モデルアクセスの制御 をご参照ください。

• Claude 4.0

• Claude 3.7

• Claude 3.5

• GPT 4.1

リストされたモデルは すべての地域 で利用できない場合がありますが、Snowflake Intelligence Cortex クロスリージョン推論を使用すれば、任意のクラウドやリージョンでも使用できます。これには、モデルが利用できないクラウドやリージョンが含まれます。Cortex クロスリージョン推論 の設定に関する詳細情報については、クロスリージョン推論 をご参照ください。

• AWSUS - AWS において、Claude 4は最高の品質と最高のスピードパフォーマンスを提供します。aws_us では、最高のパフォーマンスを得るために、Claude 4 を使用するCortexクロスリージョン推論を設定することを推奨します。Cortex クロスリージョン推論がない場合、aws_us でClaude 3.5を使用することは制限されます。

• Azure US - |sf-intelligence|を EASTUS 使用している場合はCortex クロスリージョン推論なしの GPT 4.1を使用できます。その他のリージョンとモデルの組み合わせでは、azure_us 用にCortexクロスリージョン推論設定が必要です。

• AWSEU - aws_eu 用にCortexクロスリージョン推論を構成する限り、このリージョンではClaude 4を使用することができます。

Snowflake Intelligence を設定する¶

ユーザーのために Snowflake Intelligence を設定するには、エージェント権限を構成する必要があります。

1. データベースを作成する。これは、構成オブジェクトと、Snowflake Intelligence をサポートするために使用される他のオブジェクトを保持します。

   CREATE DATABASE IF NOT EXISTS snowflake_intelligence;
   GRANT USAGE ON DATABASE snowflake_intelligence TO ROLE PUBLIC;
   

   Copy

2. snowflake_intelligence データベースを設定した後、次の SQL コマンドを使用して、エージェントを格納するスキーマを作成し、全員が発見できるようにします。

   CREATE SCHEMA IF NOT EXISTS snowflake_intelligence.agents;
   GRANT USAGE ON SCHEMA snowflake_intelligence.agents TO ROLE PUBLIC;
   

   Copy

3. |sf-intelligence|用のエージェントを作成できるようにするには、agents スキーマに対して CREATEAGENT 権限を付与する必要があります。

   GRANT CREATE AGENT ON SCHEMA snowflake_intelligence.agents TO ROLE <role>;
   

   Copy

エージェントの作成¶

|sf-web-interface|UI のエージェント管理者ページからエージェントを作成し、質問に回答、洞察を提供します。エージェントは、セマンティックビュー、セマンティックモデル、 Cortex Search Service、またはこれらの組み合わせを使用して回答を提供します。これらのツールを使用しない基本的なエージェントを作成することはできますが、その基本的なエージェントは、ベースモデルのみを使用して回答を提供します。その結果、エージェントはSnowflakeアカウント内のデータにアクセスできず、回答のためのコンテキストが限られます。

セマンティックビューまたはモデルは、Snowflakeのテーブルと構造化データに使用されます。このデータは、テーブルがSnowflakeによってクエリ可能であれば、任意のテーブルに存在できます。Cortex Searchは、ドキュメント、会話、文字起こしなど、多くのテキストを含むデータのインデックスを作成し、検索するのに便利です。

エージェントにカスタムツールを追加する¶

カスタムツールを追加することで、エージェントの機能を拡張することができます。カスタムツールを使用すると、エージェントは定義したストアドプロシージャや関数を呼び出して、アクションを実行したり計算を実行したりできます。プロシージャと関数については、 関数とプロシージャによるSnowflakeの拡張 をご参照ください。

カスタムツールを追加するには、以下の手順に従います。

1. Snowsight にサインインします。

2. ナビゲーションメニューで AI & ML » Agents を選択します。

3. エージェントのリストからエージェントを選択します。

4. Edit を選択します。

5. Tools を選択します。

6. Custom tools を検索し、+ Add ボタンを選択します。

7. Name のカスタムツールの名前を入力します。

8. Resource type では、カスタムツールが関数かプロシージャかを選択します。関数を使用するかプロシージャを使用するかどうかの情報については、ストアドプロシージャとユーザー定義関数のどちらを記述するかの選択 をご参照ください。

9. :ui:`Custom tool identifier`の場合、カスタムツールとして追加する既存の関数またはプロシージャを選択します。

10. 関数またはプロシージャの関連パラメーターが自動的に表示されます。名前、タイプ、説明を追加し、パラメーターが必須かどうかを選択すると、カスタムツールのパラメーターを手動で追加できます。自動的に入力されるパラメーターを変更することもできます。

11. Warehouse では、エージェントがカスタムツールを実行するために使用するウェアハウスを選択します。手動でウェアハウスを選択する必要があります。

12. :ui:`Description`では、カスタムツールとその使用方法について説明します。

カスタムツールを作成したら、カスタムツールとしてユーザーが追加した関数またはプロシージャに対してUSAGE 権限が付与されていることを確認してください。ストアドプロシージャを使用する場合 Snowflake Intelligence は、プロシージャが所有者権限で実行されるか、呼び出し元権限で実行されるかを維持します。所有者と呼び出し元の権利については、呼び出し元権限と所有者権限のストアドプロシージャについて をご参照ください。

エージェントを使用する¶

エージェントを作成したら、データからインサイトを得るために質問することができます。エージェントは、次のような質問に答えることができます。

• 最終四半期の平均販売額は？

• 先月最も多くのユニットを販売した製品は何ですか？

• 前年の売上傾向を表示できますか？

また、以下のような可視化も可能です。

• 棒グラフ

• 折れ線グラフ

• 円グラフ

エージェントを使用するには、次のステップに従います。

1. 左側のナビゲーションから、AI & ML を選択するか、 Snowflakeインテリジェンスランディングページ に移動します。

2. Snowflake Intelligence を選択します。ナビゲーションが変更され、Snowflake Intelligence に焦点が当てられます。Snowflake Intelligence アプリケーションを使用している間に、Snowsight専用の新しいブラウザタブを開くことをお勧めします。個別のブラウザタブを使用することで、Snowsightインターフェースと Snowflake Intelligence アプリケーションを切り替えることができます。

3. チャットウィンドウで、ドロップダウンからエージェントを選択します。

4. エージェントが使用するデータソースを選択します。

5. エージェントに質問するか、データの可視化を依頼します。

既存の共有を変更する¶

既存のエージェントの構成を変更するには、次のステップを実行します：

1. ナビゲーションメニューで AI & ML » Agents を選択します。

2. エージェントのリストから、変更するエージェントを選択します。これにより、エージェントのすべての構成の詳細を含むペインが開きます。

3. Edit を選択します。

4. 必要な構成の詳細を変更します。

5. Save を選択します。

チュートリアル - Snowflakeドキュメントを使用するエージェントの作成¶

このチュートリアルでは、Snowflakeドキュメントをナレッジベースとして使用するエージェントを作成する方法を説明します。エージェントは、Snowflakeの機能とベストプラクティスに関する質問に回答できます。

1. Snowflake Marketplace からSnowflakeドキュメント用Cortexナレッジ拡張機能をインストールするには、 Get を選択します。

   • インストールプロンプトで、Cortex ナレッジ拡張機能がインストールされているデータベース名をメモします。これは、後でエージェントを作成するときに使用されます。

2. エージェントを作成するロールに、新しく作成されたデータベースの権限を追加します。これらの権限は、データベースにアクセスするために必要です。

   GRANT IMPORTED PRIVILEGES ON DATABASE <database_name> TO ROLE <role>;
   

   Copy

3. 次の変更を使用して、Cortex Search Serviceを使用するエージェントを作成する のステップに従ってエージェントを作成します。

   • Cortex Search Serviceを追加する場合、新しく作成されたデータベースと SHARED スキーマを選択してください。

   • Search service に対して CKE_SNOWFLAKE_DOCS_SERVICE の検索サービスを追加します。

   • Add を選択します。

4. エージェントを保存します。

5. Snowflakeインテリジェンスランディングページ に移動します。

6. 作成したエージェントを選択し、Snowflakeドキュメント用Cortex ナレッジ拡張機能をソースとして選択します。

7. Snowflakeのドキュメントについてエージェントに質問します。

エージェントのユーザーフィードバックを表示する¶

組織内のユーザーがエージェントと対話すると、ユーザーはエージェントが提供する応答に関するフィードバックを提供できます。このフィードバックは、ユーザーの満足度に関する大まかなインサイトを提供します。

エージェントのユーザーフィードバックを表示するには、次のステップを実行します。

1. フィードバックにアクセスするロールが次を持っていることを確認してください。

   • AI_OBSERVABILITY_EVENTS_LOOKUP アプリケーションのロール

   • エージェントに対する MONITOR 権限

2. 次の SQL コマンドを実行します。

   SELECT * FROM TABLE(SNOWFLAKE.LOCAL.GET_AI_OBSERVABILITY_EVENTS('<database_name>', '<schema_name>', '<agent_name>', 'CORTEX AGENT')) WHERE RECORD:name='CORTEX_AGENT_FEEDBACK';
   

   Copy

結果のテーブルには、エージェント、フィードバックを提供したユーザー、ユーザーから提供されたフィードバック、フィードバックがポジティブなものかそうでないかを含む列が含まれます。

Snowflake Intelligence を AWS PrivateLink を使用して構成する¶

Snowflake Intelligence は AWS プライベートリンクとの統合をサポートしており、これを利用することで、仮想プライベートクラウド（VPC）および Snowflake Intelligence の間に安全なプライベート接続を確立できます。AWSPrivateLink には、このプライベート接続を介してトラフィックを|sf-intelligence| に誘導するための適切な DNS を設定する必要があります。

AWS PrivateLink は、Snowflakeが提供するサービスではないことに注意してください。PrivateLinkは、SnowflakeがSnowflakeアカウントでの使用をサポートしている AWS のサービスです。

トラブルシューティング¶

table / search service / stage does not exist エラーが発生した場合、権限に問題がある可能性があります。次の権限が正しく設定されていることを確認します：

• 各セマンティックモデルについて：

  • ユーザーのデフォルトのロールには、セマンティックモデルステージまたはビュー、およびテーブルのデータベースとスキーマ上でUSAGE 権限が付与されます。

  • ユーザーのデフォルトのロールには、セマンティックモデル ファイルを格納するステージ上のREAD が付与されます。

  • ビューを使用する場合、ユーザーのデフォルトのロールは、セマンティックビューに対して、REFERENCES付与されます。

  • セマンティックモデルまたはビューで定義された各テーブルのユーザーのデフォルトのロールに SELECT が付与されます。

• 各Cortex検索サービスについて：

  • ユーザーのデフォルトのロールには、Cortex検索サービスのデータベースとスキーマの USAGE が付与されます。

  • ユーザーには、Cortex検索サービス上の USAGE が付与されます。