Cortex Agents¶

概要¶

Cortex Agentは、構造化データソースと非構造化データソースの両方をオーケストレーションしてインサイトを提供します。タスクを計画し、ツールを使用してこれらのタスクを実行し、応答を生成します。Agentは、LLMs とともに |cortex-analyst|（構造化）とCortex Search（非構造化）をツールとして使用し、データを分析します。Cortex Searchは非構造化ソースからインサイトを抽出しますが、|cortex-analyst| は SQL を生成して構造化データを処理します。さらに、ストアドプロシージャとユーザー定義関数（UDFs）を使用してカスタムツールを実装できます。ツールの識別とツールの実行を包括的にサポートすることで、エンタープライズデータに基づいた高度なアプリケーションの配信を可能にします。

ワークフローには4つのキーコンポーネントがあります：

1. 計画: アプリケーションは構造化ソースと非構造化ソースのデータを切り替えて処理することがよくあります。例えば、ユーザーのクエリに答えるように設計された会話アプリを考えてみましょう。ビジネスユーザーは、まず売上高上位の販売代理店を尋ね（構造化）、次に契約に関する問い合わせ（非構造化）に切り替えることができます。Cortex Agentは、リクエストを解析してプランをオーケストレーションし、ソリューションまたはレスポンスに到達します。

   1. オプションの探索: ユーザーが曖昧な質問（例えば、"Acme Suppliesについて教えてください"）を投げかけると、Agentは曖昧さをなくし、精度を向上させるために、製品、場所、営業担当者など、さまざまな組み合わせを検討します。

   2. サブタスクへの分割:Cortex Agentは、タスクやリクエスト（例えば、「Acme SuppliesとAcme Stationeryの契約条件の違いは何か」）を複数の部分に分割して、より的確な回答を得ることができます。

   3. ツール間のルーティング:Agentは、Cortex AnalystまたはCortex Searchという適切なツールを選択し、統制されたアクセスと企業ポリシーの遵守を保証します。

2. ツールの使用: プランがあれば、Agent は効率的にデータを取得します。Cortex Searchは非構造化ソースから洞察を抽出し、Cortex Analystは構造化データを処理するために SQL を生成します。ツールの識別と実行を包括的にサポートすることで、企業データに基づいた高度なアプリケーションの提供が可能になります。

3. 振り返り: 各ツールの使用後、エージェントは結果を評価し、次のステップ（説明を求める、反復する、最終的な回答を生成する）を決定します。このオーケストレーションにより、Snowflakeのセキュアな境界内で正確性とセキュリティを確保しながら、複雑なデータクエリを処理することができます。

4. 監視と反復: 導入後、継続的な改善のために、メトリクスを追跡し、パフォーマンスを分析し、動作を改善することができます。クライアントアプリケーション開発者は、 TruLens を使用して Agent とのインタラクションを監視できます。ガバナンスコントロールを継続的に監視し改善することで、企業はセキュリティとコンプライアンスを維持しながら、 AI エージェントを自信を持って拡張することができます。

チュートリアルについては、 Cortex Agentチュートリアル を参照してください。

アクセス制御の要件¶

agent:run API を介してCortex Agentにリクエストを行うには、SNOWFLAKE.CORTEX_USER または SNOWFLAKE.CORTEX_AGENT_USER ロールが付与されたロールを使用します。CORTEX_USER が、Cortex Agentを含むすべての対象 AI 機能へのアクセスを提供する一方、CORTEX_AGENT_USER は Agent機能へのアクセスを提供します。

セマンティックモデルで Cortex Agent を使用するには、以下の権限も必要です。

Cortex Agent API へのリクエストには認証トークンが含まれている必要があります。API への認証コードの詳細については、 Snowflakeでの Snowflake REST APIs 認証 をご参照ください。このトピックの例では、セッショントークンを使用してSnowflakeアカウントを認証していることに注意してください。

特定のロールへのアクセス制限

デフォルトでは、CORTEX_USERロールはPUBLICロールに付与されます。PUBLIC ロールは、すべてのユーザーとロールに自動的に付与されます。すべてのユーザーにこの権限を与えたくない場合は、PUBLICロールのアクセス権を取り消し、特定のロールにアクセス権を与えることができます。詳細については、 必要な権限 をご参照ください。

Cortex Agentに選択的なアクセス権を提供し、ユーザーのサブセットのみがこの機能にアクセスできるようにするには、CORTEX_AGENTS_USER ロールを使用します。

Cortex Agentユーザーロールを使用したアクセス制限

特定のユーザーにCortex Agentへの選択的なアクセス権を提供するには、SNOWFLAKE.CORTEX_AGENT_USER データベースロールを使用します。このロールには、Cortex Agent API を呼び出すのに必要な権限が含まれます。

REVOKE DATABASE ROLE SNOWFLAKE.CORTEX_USER FROM ROLE agent;

Cortex Agentにアクセス権を提供するには、ACCOUNTADMIN ロールを使用して以下を実行します。

1. SNOWFLAKE.CORTEX_AGENT_USER データベースロールをカスタムロールに付与します。

2. このカスタムロールをユーザーに割り当てます。

次の例では、

1. カスタムロール cortex_agent_user_role を作成します。

2. これに CORTEX_AGENT_USER データベースロールを付与します。

3. このロールを example_user に割り当てます。

USE ROLE ACCOUNTADMIN;
CREATE ROLE cortex_agent_user_role;
GRANT DATABASE ROLE SNOWFLAKE.CORTEX_AGENT_USER TO ROLE cortex_agent_user_role;

GRANT ROLE cortex_agent_user_role TO USER example_user;

既存のロールを介してCortex Agentへのアクセス権を付与することもできます。たとえば、組織でエージェントが使用する agent ロールがある場合、単一の GRANT ステートメントでアクセス権を付与できます。

GRANT DATABASE ROLE SNOWFLAKE.CORTEX_AGENT_USER TO ROLE agent;

認証¶

Snowflake REST APIs は、プログラムアクセストークン (PATs) による認証コード、 JSON Web トークン (JWTs) を使用したキーペア認証、および OAuth をサポートしています。詳細については、 Snowflakeでの Snowflake REST APIs 認証 をご参照ください。

コストの考慮事項¶

プレビューでは、Cortex Agentには、Cortex SearchとCortex Analystの基礎となる機能に関連するコスト以外のコストは考慮されません。Cortex SearchサービスとCortex Analystサービスでは、Snowflakeサービス利用表 <https://www.snowflake.com/legal-files/CreditConsumptionTable.pdf>`__に記載されている詳細ごとにコストが発生します。また、カスタムツールの使用により :doc:`ウェアハウスコスト </user-guide/cost-understanding-compute> が発生する可能性があります。

モデル¶

Cortex Agentでは以下のモデルを使用できます。モデルがローカルリージョンで利用できない場合は、クロスリージョン推論を使用する必要があります。

• claude-4-sonnet

• claude-3-7-sonnet

• claude-3-5-sonnet

• openai-gpt-5

Cortex Agentの概念¶

Cortex Agentは、Cortex Analyst、Cortex Search、カスタムツールを使用して、タスクを計画し、応答を生成します。指示によりオーケストレーションに影響を与えることができます。また、属性を指定して、ビジネスロジックに基づいて動的にツールを選択することもできます。

対話中、Agentはスレッドを使用してコンテキストを維持します。スレッドでは、アプリケーションロジックで使用するために、会話コンテキスト全体を簡単に取得できます。

継続的に反復してAgentを改良する際に、エンドユーザーからのフィードバックを収集できます。主観的なフィードバック（テキスト）と結び付いた明示的なフィードバックメカニズム（正/負の評価）により、Agentのライフサイクル全体でユーザー入力をキャプチャできます。

エージェントとのやり取り¶

Cortex Agentは、REST API を介してエージェントとやり取りするために2つの異なる方法をサポートしています。

• エージェントオブジェクトがエージェントとやり取りするように構成する:このメソッドでは、まず、インタラクション全体で再利用できるエージェントオブジェクトを構成します。エージェントオブジェクトを構成すると、クライアントコードが簡素化され、エンタープライズ対応アプリケーションの CI/CD が可能になります。

• エージェントオブジェクトなしでやりとりする:このメソッドでは、すべてのインタラクションリクエストの一部としてエージェント構成を渡す必要があります。エージェントオブジェクトなしのインタラクションにより、ユースケースを迅速に試し、さまざまなシナリオを実験できます。

これらのメソッドの詳細については、エージェントの構成と操作 をご参照ください。