在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 下的所有子命令：