Snowflake Intelligence の概要¶

Snowflake Intelligence オブジェクトを作成する¶

Snowflake Intelligence オブジェクトの作成には Snowflake Intelligence UI または SQL を使用できます。

Snowflake Intelligence UISQL

Snowflakeは Snowflake Intelligence を初めて変更した際に自動的に Snowflake Intelligence オブジェクトを作成します。UI を使用して作成された場合、Snowflake Intelligence オブジェクトは SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT という名前になります。別の名前は指定できません。

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

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

3. Snowflake Intelligence タブを選択します。

4. Open settings を選択します。その Snowflake Intelligence オブジェクトがまだ存在しない場合は自動的に作成されます。その後、オブジェクトにエージェントを追加できます。

エージェントを追加¶

Snowflake Intelligence オブジェクトは、エージェントのリストを含むアカウントレベルのオブジェクトです。このオブジェクトからエージェントを追加または削除すると、ユーザー用のエージェントの厳選されたリストを作成できます。エージェントの追加または削除の詳細については、Snowflake Intelligence でエージェントの可視性を構成する をご参照ください。

Snowflake Intelligence 権限を付与する¶

次の権限は Snowflake Intelligence オブジェクトへのアクセスを制御します。

• CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT:Snowflake Intelligence オブジェクトの作成を可能にするアカウントレベルの権限。この権限はデフォルトでは ACCOUNTADMIN に付与されます。

  この権限を別のロールに付与するには、次のコマンドを実行します。

  GRANT CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT TO ROLE <role_name>;
  

  Copy

• USAGE:ユーザーが Snowflake Intelligence オブジェクトに追加されたエージェントのリストを表示し、構成値を確認できるようにするオブジェクトレベルの権限。

  この権限を付与するには、次のコマンドを実行します。

  GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
  

  Copy

• ALTER:ユーザーが Snowflake Intelligence オブジェクトからエージェントを追加または削除できる、および構成値を変更できるオブジェクトレベルの権限。アカウント管理者にはデフォルトでこの権限があります。

  この権限を付与するには、次のコマンドを実行します。

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

  Copy

Snowflake Intelligence オブジェクトをすべてのユーザーに表示するには、PUBLIC ロールに対してオブジェクトの USAGE 権限を付与します。

GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE PUBLIC;

ADMIN として、 Snowflake Intelligence オブジェクト に対する ALTER 権限も持ちます。これにより、オブジェクトにエージェントを追加または削除して、ユーザー用のエージェントの厳選されたリストを作成できます。

ユーザーに Snowflake Intelligence を設定するには、エージェント権限を構成する必要があります。エージェントに必要な権限については、アクセス制御の要件 をご参照ください。

Snowflake Intelligence オブジェクトを使用したエージェントの管理¶

Snowflake Intelligence オブジェクトにエージェントを追加するには、次のコマンドを使用します。

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

Snowflake Intelligence オブジェクトからエージェントを削除するには、次のコマンドを使用します。

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

エージェントの可視化ロジック¶

Snowflake Intelligence は、次のロジックを使用して、ユーザーに表示されるエージェントを決定します。

1. Snowflake Intelligence オブジェクトが存在し、1つ以上のエージェントを含んでいる場合、ユーザーは、この厳選されたリストから個々のエージェントがアクセスできることを確認できます。

2. Snowflake Intelligence オブジェクトは存在するがエージェントが含まれていない AND 1つ以上のエージェントを含む SNOWFLAKE_INTELLIGENCE.AGENTS スキーマが存在する場合、ユーザーには SNOWFLAKE_INTELLIGENCE.AGENTS スキーマのエージェントが表示されます。これによりエージェントをまだ移行していない場合、Snowflake Intelligence は中断されません。

3. Snowflake Intelligence オブジェクトが存在しないか、エージェントがゼロ AND SNOWFLAKE_INTELLIGENCE.AGENTS スキーマが存在しないか、エージェントが含まれていない場合、ユーザーにはアカウントでアクセスできるすべてのエージェントが表示されます。

Migrating from managing agent visibility with the SNOWFLAKE_INTELLIGENCE.AGENTS schema¶

If you're using the SNOWFLAKE_INTELLIGENCE.AGENTS schema, your agents will continue to work, as detailed in エージェントの可視化ロジック. However, migrating to the Snowflake Intelligence object provides the following benefits:

• 柔軟性:アカウントのどこでもエージェントを作成および管理できます。エージェントは単一のスキーマに一元化する必要がありません。

• 権限管理の改善:エージェントを作成する機能と、Snowflake Intelligence で公開する機能を分離します。

• 名前の衝突を避ける:SNOWFLAKE_INTELLIGENCE.AGENTS スキーマ名との潜在的な競合を排除します。

• より簡単なエージェントの可視性管理: 単一のオブジェクトを使用して、すべてのユーザーに表示されるエージェントを制御します。

エージェントを移行する前に Snowflake Intelligence オブジェクトを作成したことを確認してください。Snowflake Intelligence オブジェクトの作成の詳細については、Snowflake Intelligence を設定する をご参照ください。

オブジェクトを作成したら、次のコードを使用してエージェントを Snowflake Intelligence オブジェクトに追加します。

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

Copy

前提条件¶

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

• AWS PrivateLink とSnowflake の手順に従って AWS PrivateLink を設定するか、 Azure Private LinkとSnowflake の手順に従ってAzure Private Linkを設定します。

• Ensure that a regionless-snowsight-privatelink-url is available by calling the SYSTEM$GET_PRIVATELINK_CONFIG function using the ACCOUNTADMIN system role.

Snowflake 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認証プロセスを使用します。このプロセスでは、ログインページでアカウント識別子、ユーザー名、パスワードを入力する必要があります。