ALTER EXTERNAL AGENT

既存の外部エージェントのプロパティを変更します。外部エージェントは、 AI 可観測性 で使用するためのSnowflakeにおける生成型 AI アプリケーションを表します。

こちらもご参照ください。

CREATE EXTERNAL AGENT, DROP EXTERNAL AGENT, SHOW EXTERNAL AGENTS, DESCRIBE EXTERNAL AGENT

構文

ALTER EXTERNAL AGENT [ IF EXISTS ] <name> SET
  [ COMMENT = '<comment>' ]

ALTER EXTERNAL AGENT [ IF EXISTS ] <name> ADD VERSION <version_name>

必須パラメーター

name

変更する外部エージェントの識別子（つまり、名前）を指定する文字列。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

オプションのパラメーター

SET ...

外部エージェントの1つ以上の指定されたプロパティを設定します。

COMMENT = comment

外部エージェントの説明を指定します。

ADD VERSION version_name

外部エージェントに新しいバージョンを追加します。バージョンは、異なる取得者、プロンプト、 LLMs または 推論構成など、アプリケーションの異なる実装を表します。

アクセス制御の要件

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

オブジェクト

メモ

OWNERSHIP

外部エージェント

OWNERSHIP は、オブジェクトを作成したロールに自動的に付与されるオブジェクトに対する特別な権限ですが、所有ロール（または MANAGEGRANTS 権限のある任意のロール）によって GRANTOWNERSHIP コマンドを使用して別のロールに譲渡することもできます。

スキーマ内のオブジェクトを操作するには、親データベースの少なくとも1つの権限と、親スキーマの少なくとも1つの権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

  • メタデータについて:

    注意

    Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

例

外部エージェントにコメントを設定します。

ALTER EXTERNAL AGENT my_rag_app SET COMMENT = 'RAG application for customer support';

外部エージェントにバージョンを追加します。

ALTER EXTERNAL AGENT my_rag_app ADD VERSION "v2";