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 標識段的主要作用：

• 服務端可基於 User-Agent 區分 AI Agent 請求和人工操作。

• 支援按 Agent 身份進行審計、限流和統計分析。

管理 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

環境變數

CLI 通過以下環境變數向外掛程式子進程傳遞 AI 模式狀態：

設定檔

如需手動查看或備份AI 模式的設定檔，可在以下路徑找到：

檔案格式樣本：

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

欄位說明：

優先順序

AI 模式的生效優先順序從高到低如下：

1. 命令列標誌（--cli-ai-mode / --no-cli-ai-mode）

2. 設定檔（ai-mode.json）

當同時存在命令列標誌和設定檔設定時，命令列標誌優先。如果同時指定了 --cli-ai-mode 和 --no-cli-ai-mode，以 --no-cli-ai-mode 為準。

生效範圍

AI 模式的 User-Agent 標識在以下情境生效：

• OpenAPI 呼叫：通過命令發起的 RPC 和 RESTful 請求，User-Agent 中會追加 AI 標識段。

• 外掛程式命令：CLI 通過環境變數（ALIBABA_CLOUD_CLI_AI_MODE 和 ALIBABA_CLOUD_CLI_AI_USER_AGENT）向外掛程式子進程傳遞 AI 模式狀態。外掛程式可據此在自身請求中追加對應標識。

附錄：子命令參考

以下是 aliyun configure ai-mode 下的所有子命令：