Alibaba Cloud CLI:CLI API リクエストへの AI 識別子の追加

概要

AI モードが有効な場合、CLI は各 API リクエストの User-Agent に次の形式の AI 識別子セグメントを付加します。

AlibabaCloud-AIMode/enabled AlibabaCloud-Agent-Skills

各要素の説明：

• AlibabaCloud-AIMode/enabled は、AI モードがアクティブであることを示す固定プレフィックスです。

• AlibabaCloud-Agent-Skills はデフォルトのスキル識別子セグメントであり、カスタマイズできます。

AI 識別子セグメントの主な目的は次のとおりです：

• AI エージェントからの API リクエストと手動操作によるリクエストを区別します。

• サーバーがエージェントのアイデンティティに基づいて監査、レート制限、統計分析を実行できるようにします。

AI モードの管理

aliyun configure ai-mode コマンドグループを使用して AI モードを管理します。

aliyun configure ai-mode show

{
  "enabled": true,
  "user_agent": "",
  "effective_user_agent": "AlibabaCloud-Agent-Skills",
  "request_user_agent_suffix": "AlibabaCloud-AIMode/enabled AlibabaCloud-Agent-Skills",
  "config_file": "/home/user/.aliyun/ai-mode.json"
}

# AI モードを有効化
aliyun configure ai-mode enable

# AI モードを無効化
aliyun configure ai-mode disable

# カスタムスキル識別子セグメントを設定
aliyun configure ai-mode set-user-agent --user-agent "MyAgent/1.0"

# デフォルト値にリセット
aliyun configure ai-mode reset-user-agent

AlibabaCloud-AIMode/enabled MyAgent/1.0

コマンドごとのオーバーライド

コマンドラインフラグを使用して、特定のコマンドに対してグローバル AI モード設定をオーバーライドできます。

同じコマンドで両方のフラグを使用した場合、 --no-cli-ai-mode が優先されます。

例：

# AI モードはグローバルで無効ですが、このコマンドは AI 識別子を付加します
aliyun ecs DescribeInstances --cli-ai-mode

# AI モードはグローバルで有効ですが、このコマンドは識別子を付加しません
aliyun ecs DescribeInstances --no-cli-ai-mode

環境変数

CLI は、次の環境変数を使用して AI モードのステータスをプラグインの子プロセスに公開します。

設定ファイル

AI モードの設定ファイルは、次のパスにあります。

ファイル形式の例：

{
  "enabled": true,
  "user_agent": "MyAgent/1.0"
}

フィールドの説明：

優先順位

CLI は、次の優先順位 (高い順) で AI モード設定を適用します。

1. コマンドラインフラグ (--cli-ai-mode / --no-cli-ai-mode)

2. 設定ファイル (ai-mode.json)

コマンドラインフラグと設定ファイルの設定の両方が存在する場合、コマンドラインフラグが優先されます。同じコマンドで --cli-ai-mode と --no-cli-ai-mode の両方が指定された場合、--no-cli-ai-mode が優先されます。

適用範囲

User-Agent の AI 識別子は、次のシナリオで有効になります。

• API コール: コマンドによって開始される RPC リクエストおよび RESTful リクエストの両方で、AI 識別子セグメントが User-Agent に追加されます。

• プラグインコマンド: CLI は、環境変数 (ALIBABA_CLOUD_CLI_AI_MODE および ALIBABA_CLOUD_CLI_AI_USER_AGENT) を通じて、AI モードのステータスをプラグインの子プロセスに渡します。これにより、プラグインは対応する識別子を自身のリクエストに付加できます。

付録: サブコマンドリファレンス

aliyun configure ai-mode では、以下のサブコマンドを利用できます。