Alibaba Cloud CLI:AI モード

概要

AI モードには、以下の変更点があります。

• Alibaba Cloud サービスは、この識別子を使用して、トラブルシューティングや呼び出し統計のために、エージェントによる呼び出しと手動操作を区別します。

• エージェントは CLI の出力を直接解析できるため、再試行回数が削減されます。

AI モード有効時の動作変更

AI モードの機能には、Alibaba Cloud CLI 3.5.0 以降が必要です。AI モードを有効にすると、CLI のローカル出力は以下のように変更されますが、これらに限定されません。

• CLI は、よりコンパクトな形式でヘルプ情報を返します。

• CLI は、失敗の原因と次のステップに関する情報を含む、構造化された形式でエラー情報を返します。

• CLI は、パラメーター値をローカルで検証します。

• 出力にカラー制御文字が含まれなくなります。

コンテンツが要約された形式で表示される場合、完全なコンテンツを取得する方法が出力に示されます。

AI モードの管理

AI モードは aliyun configure ai-mode コマンドグループで管理します。

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

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

OpenAPI 呼び出しを行う際、コマンドラインフラグを使用し、そのコマンドに限り AI モードのグローバル設定を上書きできます。

両方のフラグが同じコマンドに含まれる場合、--no-cli-ai-mode が優先されます。

例：

# AI モードがグローバル設定で無効でも、このコマンドでは AI 識別子が追加されます
aliyun ecs DescribeInstances --cli-ai-mode

# AI モードがグローバル設定で有効でも、このコマンドでは識別子は追加されません
aliyun ecs DescribeInstances --no-cli-ai-mode

設定ファイル

AI モードの設定ファイルを手動で表示またはバックアップするには、お使いのオペレーティングシステムに応じた以下のパスにあるファイルを参照してください。

ファイル形式の例：

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

フィールドの説明：

優先順位

AI モードの設定は、以下の優先順位 (高いものから低いものへ) で適用されます。

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

2. 環境変数 (ALIBABA_CLOUD_CLI_AI_MODE)

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

優先順位の高い設定が有効になると、優先順位の低い設定は無視されます。--cli-ai-mode と --no-cli-ai-mode が同じコマンドで指定された場合、--no-cli-ai-mode が優先されます。

スコープ

AI モードは、以下のシナリオで有効になります。

• OpenAPI 呼び出し：RPC および RESTful リクエストの両方で、AI 識別子セグメントが User-Agent に追加されます。

• プラグインコマンド：CLI は、ALIBABA_CLOUD_CLI_AI_MODE および ALIBABA_CLOUD_CLI_AI_USER_AGENT 環境変数を介してプラグインの子プロセスに AI モードのステータスを渡し、プラグインが独自のリクエストに識別子を追加できるようにします。

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

aliyun configure ai-mode で利用可能なサブコマンドは次のとおりです。