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 を選択します。

3. Agents を選択します。

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

5. Edit を選択します。

6. Tools を選択します。

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

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

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

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

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

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

13. :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 を選択します。

2. Agents を選択します。

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

4. Edit を選択します。

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

6. 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のドキュメントについてエージェントに質問します。

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 が付与されます。