参照情報

このページでは、|sf-intelligence|の操作に関する参照情報を提供します。ここでは、以下の概念について説明します。

  • Cortex Agentの作成、管理、操作に使用可能なREST APIエンドポイントおよびSQLコマンド

  • サポートされるAIモデルとそのリージョンの可用性

  • モデルの使用とデータ分類に関する法的通知

SQLコマンドおよびAPI参照

Snowflakeは、|sf-intelligence|で使用するCortex Agentの作成およびやり取りのための、プログラムによる以下のメソッドを提供します。

Cortex AgentオブジェクトREST API

Cortex AgentオブジェクトREST APIは、|sf-intelligence|と統合するAI駆動型アプリケーションを構築するための包括的なエンドポイントのセットを提供します。REST APIを使用して、エージェントオブジェクトを管理し、データの操作をオーケストレーションできます。

エージェント管理操作

AgentオブジェクトREST APIは、Cortex Agentオブジェクトを管理するための以下の操作をサポートしています。

操作

エンドポイント

説明

作成する

POST /api/v2/databases/{database}/schemas/{schema}/agents

指定された属性とツール構成で新しいCortex Agentを作成します。

説明

GET /api/v2/databases/{database}/schemas/{schema}/agents/{name}

既存のエージェントの構成とメタデータを取得します。

更新

PUT /api/v2/databases/{database}/schemas/{schema}/agents/{name}

既存のエージェントの構成、ツール、または指示を変更します。

リスト

GET /api/v2/databases/{database}/schemas/{schema}/agents

指定されたデータベースとスキーマ内のすべてのエージェントを、フィルタリングオプション付きでリストします。

削除

DELETE /api/v2/databases/{database}/schemas/{schema}/agents/{name}

アカウントからエージェントを削除します。

リクエストパラメーター、応答スキーマ、例などの詳細なAPI仕様について詳しくは、:doc:`/user-guide/snowflake-cortex/cortex-agents-rest-api`を参照してください。

Agents SQLコマンド

Snowflakeは、|sf-intelligence|で使用する:doc:`Cortex Agent</user-guide/snowflake-cortex/cortex-agents>`オブジェクトを作成および管理するためのSQLコマンドを提供します。

エージェント管理コマンド

Cortex Agentを管理するため、次のSQLコマンドを使用できます。

コマンド

説明

CREATE AGENT

指定された属性、プロファイル設定、およびYAML仕様を使用して、新しいCortex Agentを作成するか、既存のものを置き換えます。

DESCRIBE AGENT

既存のエージェントの完全な構成、仕様、およびメタデータを取得します。

SHOW AGENTS

アクセス権限を持つすべてのCortex Agentを、フィルタリングオプションとページネーションオプション付きでリストします。

DROP AGENT

現在のスキーマまたは指定されたスキーマからエージェントを削除します。

SQL構文、パラメーター、および例について詳しくは、:doc:`Cortex Agentコマンド</sql-reference/commands-cortex-agent>`を参照してください。

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

|sf-intelligence|は、label-cortex_agents_models`にリストされているモデルをサポートしています。これらのモデルは、アカウントにアクセスがある限り使用できます。詳細については、 :ref:`label-cortex_llm_access_control をご参照ください。

エージェントを作成する際には、モデルに Auto を選択することをお勧めします。これにより、Snowflake Intelligence がアカウントの最高品質モデルを自動的に選択し、新しいモデルが利用可能になると自動的に改善します。

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

  • AWSUS - AWS において、Claude 4+は最高の品質と最高のスピードパフォーマンスを提供します。aws_us では、最高のパフォーマンスを得るために、Claude 4 を使用するCortexクロスリージョン推論を設定することを推奨します。Cortex クロスリージョン推論がない場合、 aws_us でClaude 3.5を使用することは制限されます。

  • Azure US - Snowflake Intelligence を東 US で使用している場合はCortexクロスリージョン推論なしの GPT 4.1+を使用できます。その他のリージョンとモデルの組み合わせでは、 azure_us 用にCortexクロスリージョン推論設定が必要です。

  • AWSEU - aws_eu 用にCortexクロスリージョン推論を構成する限り、このリージョンではClaude 4+を使用することができます。

  • AWSAPJ - aws_apj 用にCortexクロスリージョン推論を構成する限り、このリージョンではClaude 4+を使用することができます。