Snowflake Intelligence の概要

Snowflake Intelligence を使用して、組織内のデータに基づいて洞察を得てアクションを実行します。使用 |sf-intelligence|により、次が可能になります。

  • 自然言語を使用してチャートを作成し、即座に回答を取得します。技術的な専門知識やカスタムダッシュボードを待つことなく、傾向を発見し、データを分析することができます。

  • 構造化データと非構造化データを一緒に含む、何千ものデータソースにアクセスして分析します。スプレッドシート、ドキュメント、画像、データベースから同時にインサイトを接続できます。

Snowflake Intelligence uses agents, which are AI models that are connected to one or more semantic views, semantic models, Cortex search services, and tools. Agents can answer questions, provide insights, and show visualizations. Snowflake Intelligence is powered by Cortex AI Functions, Cortex Analyst, and Cortex Search.

次のセクションを使用して設定を行い、 Snowflake Intelligence を開始して、データから価値を引き出します。Snowflake Intelligence に関するクイックスタートガイド については、 Snowflakeインテリジェンスの基本操作 を参照してください。

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

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

  • Claude 4.5

  • Claude 4.0

  • Claude 3.7

  • Claude 3.5

  • GPT 5

  • GPT 4.1

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

When creating an agent, we recommend selecting Auto for the model. This lets Snowflake Intelligence automatically select the highest quality model for your account and automatically improves as new models become available.

  • AWS US - In AWS, Claude 4+ offers the highest quality and best speed performance. We recommend that you set up Cortex Cross-region inference for aws_us to use Claude 4 and get the best performance. Without Cortex Cross-region inference, you are restricted to using Claude 3.5 in aws_us.

  • Azure US - If you are using Snowflake Intelligence in East US, you can use GPT 4.1+ without Cortex Cross-region inference. Other region and model combinations require Cortex Cross-region inference setup for azure_us.

  • AWS EU - You can use Claude 4+ in this region as long as you configure Cortex Cross-region inference for aws_eu.

  • AWS APJ - You can use Claude 4+ in this region as long as you configure Cortex Cross-region inference for aws_apj.

Snowflake Intelligence を設定する

To set up Snowflake Intelligence for your users, do the following:

注釈

  • The ACCOUNTADMIN role is the only role that has the CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT privilege required to create a Snowflake Intelligence object.

  • Create a Snowflake Intelligence object. The Snowflake Intelligence object is a single object meant to manage all agents used with Snowflake Intelligence in your account. You can only have one Snowflake Intelligence object in your account.

  • Add agents to the Snowflake Intelligence object.

  • GRANT USAGE privileges to the Snowflake Intelligence object.

Create a Snowflake Intelligence object

You can either use the Snowflake Intelligence UI or SQL to create a Snowflake Intelligence object.

Snowflake automatically creates the Snowflake Intelligence object when you modify the Snowflake Intelligence settings for the first time. When created using the UI, the Snowflake Intelligence object is named SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT. You can't specify a different name.

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

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

  3. Select the Snowflake Intelligence tab.

  4. Select Open settings. The Snowflake Intelligence object is created automatically if it doesn't already exist. You can then add agents to the object.

Add agents

The Snowflake Intelligence object is an account-level object that contains a list of agents. You can add or remove agents from this object to create a curated list of agents for your users. For more information about adding or removing agents, see Configure the visibility of agents in Snowflake Intelligence.

Grant Snowflake Intelligence privileges

The following privileges control access to Snowflake Intelligence objects:

  • CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT: Account-level privilege that allows creating a Snowflake Intelligence object. This privilege is granted to ACCOUNTADMIN by default.

    To grant this privilege to another role, run the following command:

    GRANT CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT TO ROLE <role_name>;
    
    Copy
  • USAGE: Object-level privilege that allows users to view the list of agents added to the Snowflake Intelligence object and see configuration values.

    To grant this privilege, run the following command:

    GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
    
    Copy
  • ALTER: Object-level privilege that allows users to add or remove agents from the Snowflake Intelligence object and change configuration values. Account administrators have this privilege by default.

    To grant this privilege, run the following command:

    GRANT MODIFY ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
    
    Copy

To make the Snowflake Intelligence object visible to all of your users, grant USAGE privileges on the object to the PUBLIC role:

GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE PUBLIC;
Copy

As an ADMIN, you also have ALTER privileges on the Snowflake Intelligence object. This allows you to add or remove agents from the object to create a curated list of agents for your users.

To set up Snowflake Intelligence for your users, you must configure agent privileges. For information about the privileges required for agents, see アクセス制御の要件.

重要

デフォルトでは、 Snowflake Intelligence は、ユーザーのデフォルトのロールとデフォルトのウェアハウスを使用します。他の Snowflake Intelligence を使用を招待する際は、デフォルトのロールとウェアハウスが設定されていることを確認してください。

注釈

Snowflake Intelligence からのすべてのクエリはユーザーの認証情報を使用します。ユーザーに関連付けられたすべてのロールベースのアクセス制御およびデータマスキングポリシーは、エージェントとのすべての相互作用と会話に自動的に適用されます。

エージェントの作成

To get started, create an agent that users can interact with in Snowflake Intelligence. For information about creating an agent, see Create an agent. For best practices when creating an agent, see Best Practices to Building Cortex Agents.

Configure the visibility of agents in Snowflake Intelligence

If you haven't created a Snowflake Intelligence object and added agents to it, users see all agents they have access to in your account.

For the optimal experience, create a curated list of agents by adding them to the Snowflake Intelligence object. This allows you to control which agents appear in the Snowflake Intelligence interface for all users.

To see whether the Snowflake Intelligence object has been created in your account, use the following command:

SHOW SNOWFLAKE INTELLIGENCES;
Copy

注釈

Only one Snowflake Intelligence object can exist in an account.

Managing agents with the Snowflake Intelligence object

To add agents to the Snowflake Intelligence object, use the following command:

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT ADD AGENT <db.schema.agent_name>;
Copy

To remove agents from the Snowflake Intelligence object, use the following command:

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT DROP AGENT <db.schema.agent_name>;
Copy

注釈

Any user or admin with the right database and schema privileges can create agents. However, agents are not automatically added to the Snowflake Intelligence object. Users must have the ALTER privilege on the Snowflake Intelligence object and USAGE privileges on the agent to add an agent to the Snowflake Intelligence object.

Administrators must have the USAGE privilege on the agent to add it to the Snowflake Intelligence object.

Agent visibility logic

Snowflake Intelligence uses the following logic to determine which agents are visible to users:

  1. If the Snowflake Intelligence object exists and contains one or more agents, users see the individual agents from this curated list that they have access.

  2. If the Snowflake Intelligence object exists but contains zero agents AND the SNOWFLAKE_INTELLIGENCE.AGENTS schema exists with one or more agents, users see agents from the SNOWFLAKE_INTELLIGENCE.AGENTS schema. This ensures that Snowflake Intelligence doesn't break if you haven't migrated your agents yet.

  3. If the Snowflake Intelligence object doesn't exist or contains zero agents AND the SNOWFLAKE_INTELLIGENCE.AGENTS schema doesn't exist or contains zero agents, users see all agents that they have access to in the account.

Migrating from the deprecated SNOWFLAKE_INTELLIGENCE.AGENTS schema

重要

The SNOWFLAKE_INTELLIGENCE.AGENTS schema is deprecated. If you're currently using this schema, we recommend migrating to the Snowflake Intelligence object.

If you're using the SNOWFLAKE_INTELLIGENCE.AGENTS schema, your agents will continue to work. However, migrating to the Snowflake Intelligence object provides the following benefits:

  • Flexibility: Create and manage agents anywhere in your account without needing to centralize them in a single schema.

  • Improved permission management: Separate the ability to create agents from the ability to publish them in Snowflake Intelligence.

  • Avoid naming conflicts: Eliminate potential conflicts with the SNOWFLAKE_INTELLIGENCE.AGENTS schema name.

  • Easier agent visibility management: Use a single object to control which agents appear to all users.

Make sure you've created a Snowflake Intelligence object before you migrate your agents. For information about creating a Snowflake Intelligence object, see Snowflake Intelligence を設定する.

After you've created an object, use the following code to add an agent to the Snowflake Intelligence object:

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT ADD AGENT SNOWFLAKE_INTELLIGENCE.AGENTS.<agent_name>;
Copy

You can rename or drop the SNOWFLAKE_INTELLIGENCE database or AGENTS schema after the migration. For more information, see ALTER SCHEMA.

プライベート接続で Snowflake Intelligence を構成する

Snowflake Intelligence は AWS PrivatelinkおよびAzure Private Linkとの統合をサポートしており、これを利用することで、仮想プライベートクラウド(VPC)または仮想ネットワーク(VNet)と Snowflake Intelligence との間に安全なプライベート接続を確立できます。プライベート接続を構成するには、このプライベート接続を介してトラフィックを Snowflake Intelligence サービスに誘導するための適切な DNS 解決を設定する必要があります。

なお、AWS PrivateLink とAzure Private LinkはSnowflakeが提供するサービスではありません。これらはそれぞれ、SnowflakeがSnowflakeアカウントでの使用をサポートしている、AWS のサービスとMicrosoftのサービスです。

前提条件

プライベート接続で Snowflake Intelligence に接続する前に、次の前提条件を完了します。

重要

Snowflake Intelligence はプライベート接続アクセスに、リージョンレス URL 形式のみを使用します。Snowflakeで使用される他のプライベート接続 URLs と異なり、us-west-2, などのリージョン識別子をホスト名に含める必要がありません。リージョン固有の URL を使用する接続試行は失敗します。

|sf-intelligence|に接続する

Snowflake Intelligence に接続するには、Snowflake Intelligence が サブドメインを使用するように DNS を構成します。

  • プライベート DNS ゾーン privatelink.snowflakecomputing.com に CNAME レコードを作成し、次の URL を VPC または VNET エンドポイントの DNS 名にマッピングします。

    si-<org-acct>.privatelink.snowflakecomputing.com
    
    Copy

構成が完了すると、ネットワーク内のユーザーは URL から Snowflake Intelligence にアクセスできます:

https://si-<org-acct>.privatelink.snowflakecomputing.com
Copy

接続は、プライベート接続上で安全にルーティングされます。

プライベート接続によるユーザー認証

プライベート接続で Snowflake Intelligence にアクセスするユーザーは、標準的なSnowflake認証プロセスを使用します。このプロセスでは、ログインページでアカウント識別子、ユーザー名、パスワードを入力する必要があります。

Use the Snowflake-managed MCP server to connect to your agents

Any agent that you create in Snowflake, or the tools that the agent is connected to, can have a managed endpoint for other systems to connect with MCP. This provides a seamless integration layer for tools like Claude Desktop, Langgraph, and other tools that integrate with MCP.

The MCP server provides a standards-based interface that allows AI agents to discover and invoke tools, such as Cortex Analyst and Cortex Search, and retrieve the data they need. For more information, see Snowflake管理の MCP サーバー.

Update Snowflake Intelligence settings

You can modify settings for the Snowflake Intelligence interface that users interact with Cortex Agents through.

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

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

  3. Select the Snowflake Intelligence tab.

  4. Select Open settings.

  5. From the General settings section, you can modify the following settings:

    • Brand display name: The name of the Snowflake Intelligence interface that is displayed to users.

    • Welcome message: The message that is displayed when users first open the Snowflake Intelligence interface.

    • Primary domain: The domain that users use to access Snowflake Intelligence.

  6. Save を選択します。

  7. From the Custom appearance section, you can modify the following settings:

    • Color theme: The color theme of the Snowflake Intelligence interface. You can provide a custom primary color in hexadecimal format.

    • Full-length logo and Compact logo: The logos that are displayed when the navigation pane is expanded or collapsed, respectively.

    • Favicon: The icon that is displayed in the browser tab.

  8. Save を選択します。

トラブルシューティング

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

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

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

    • If using the older semantic model, the user's default role is granted READ on the stage that stores the semantic model file.

    • If using a semantic view, the user's default role is granted REFERENCES on the semantic view.

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

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

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

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