Cortex Agentsを共有する¶

プロバイダーとして、既存のCortex AgentをSnowflake上の他の組織と共有することができます。これにより、エージェントのユーザーベースを拡大し、その価値を他のSnowflakeのお客様にもたらすことができます。Cortex Agentは Snowflake Marketplace または指定のアカウントのいずれかで共有できます。Snowflake Marketplace のプロバイダーになるための詳細については、プロバイダーとしてのリストを使用するをご参照ください。

共有Cortex Agentのコンシューマーとして、使いやすいインターフェースにアクセスし、共有された構造化データまたは非構造化データからインサイトを得ることができます。Cortex Agentの消費に関する詳細については、コンシューマーとしてのリストを使用するおよびコンシューマーとしてのSnowflake Native Appsの使用と管理をご参照ください。

要件¶

Cortex Agentを共有するには、以下が必要です。

セマンティックビューやCortex Search Serviceなど、リンクされているすべてのオブジェクトを共有します。共有の作成と設定パラメーターで指定。詳細については、共有の作成と設定およびセマンティックビューの共有をご参照ください。
共有リンクオブジェクトは、共有Cortex Agentと同じデータベースにある必要があります。
セマンティックビュー、Cortex Search Service、および関数のツールタイプを使用するエージェントのみを共有できます。プロシージャ、スキル、MCPコネクタなどの他のツールタイプを使用するエージェントは共有できません。

Cortex Agentを共有として設定する¶

Cortex Agentは、 Provider Studio を通じて、 Snowflake Marketplace のプロバイダーとして共有できます。

また、エージェントをSQLステートメントと共有するように設定することもできます。次の例では、エージェント my_agent を共有 my_share に追加しています。

GRANT USAGE ON AGENT my_agent TO SHARE my_share;

エージェントがセマンティックビュー、Cortex Search Service、関数などのリンクされたオブジェクトを使用する場合、それらのオブジェクトを共有に付与する必要があります。

GRANT USAGE ON AGENT my_agent TO SHARE my_share;
GRANT SELECT, REFERENCES ON SEMANTIC VIEW my_sv TO SHARE my_share;
GRANT USAGE ON CORTEX SEARCH SERVICE my_css TO SHARE my_share;
GRANT USAGE ON FUNCTION my_function TO SHARE my_share;

エージェントを既存の共有に追加すると、共有をインストールしたコンシューマーユーザーに、エージェントを試すためのメール通知が送信されます。

Snowsightで共有エージェントを特定する¶

ナビゲーションメニューで AI & ML » Agents を選択します。ソース 列は、各エージェントが ローカル か共有かを示します。この列を使用して、アカウントで作成されたエージェントと、別のアカウントから共有されているエージェントをすばやく区別できます。

共有されたCortex Agentを消費する¶

共有されたCortex Agentを含むリストを取得すると、そのエージェントをSnowflake Intelligenceに追加できます。そのためには、リストを取得したときに、 Add to Snowflake Intelligence トグルを有効のままにします。これにより、共有エージェントはSnowflake Intelligence内のデータソースとして利用できるようになります。

リストを取得するときに、Add Agent to Snowflake Intelligenceトグルが有効になります。

ウェアハウスの選択¶

デフォルトでは、共有エージェントはデフォルトのウェアハウスを使用して実行されます。クエリおよびツール実行用のカスタムウェアハウスを指定することで、コンピューティングリソースおよびコストを制御できます。

共有エージェントのカスタムウェアハウスを構成するには、以下を行います。

Snowsightにサインインします。
ナビゲーションメニューで AI & ML » Agents を選択します。
共有エージェントを選択します。共有エージェントは ソース 列で識別できます。
More options menu (...) ‣ Configure warehouses for tools を選択します。
Custom を選択し、ウェアハウスを選択してから、Save を選択します。

カスタムウェアハウスを構成すると、共有エージェントは指定されたウェアハウスを使用してクエリを実行し、ツールを実行します。

複製¶

共有Cortex Agentは複製をサポートします。リストの自動複製はエージェントを他のリージョンに複製し、異なるリージョンのコンシューマーが共有エージェントにアクセスできるようにします。

制限事項¶

共有されたCortex Agentには以下の制限が適用されます。

SQLテーブル関数は共有できますが、Pythonユーザー定義のテーブル関数は共有できません。
新しいツール（セマンティックビュー、Cortex Search Service、または関数など）を使用するように共有エージェントを更新する場合は、それらの新しいツールも共有に付与する必要があります。新しいツールは自動的に追加されません。

コストの考慮事項¶

共有Cortex Agentのプロバイダーに支払われるコストに加えて、コンシューマーは以下の料金を請求されます。

共有エージェントのコンシューマーによる呼び出しで使用される入出力トークン。
SQLクエリとツールの実行のためのコンシューマーのウェアハウス使用状況。

プロバイダーに支払われるコストの詳細については、リストに対して支払うをご参照ください。Snowflakeコストの詳細については、 ` Snowflakeサービス利用表`_ をご参照ください。