Alibaba Cloud CLI:AI Mode

Présentation

Le mode AI Mode apporte les modifications suivantes :

• Les services Alibaba Cloud utilisent cet identifiant pour distinguer les appels automatisés des opérations manuelles, afin de faciliter le dépannage et les statistiques d'appels.

• Un agent peut analyser directement la sortie de la CLI, ce qui réduit le nombre de nouvelles tentatives.

Modifications du comportement lorsque le mode AI Mode est activé

Les fonctionnalités du mode AI Mode nécessitent la version 3.5.0 ou ultérieure de la CLI Alibaba Cloud. Lorsque vous activez le mode AI Mode, la sortie locale de la CLI change de plusieurs façons, notamment mais sans s'y limiter :

• La CLI renvoie les informations d'aide sous une forme plus compacte.

• La CLI renvoie les informations d'erreur sous une forme structurée, indiquant la cause de l'échec et l'étape suivante.

• La CLI valide localement les valeurs des paramètres.

• La sortie ne contient aucun caractère de contrôle de couleur.

Lorsque le contenu est présenté sous forme résumée, la sortie indique comment récupérer le contenu complet.

Gérer le mode AI Mode

Gérez le mode AI Mode avec le groupe de commandes 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"
}

# Enable AI Mode
aliyun configure ai-mode enable

# Disable AI Mode
aliyun configure ai-mode disable

# Set a custom skills identifier segment
aliyun configure ai-mode set-user-agent --user-agent "MyAgent/1.0"

# Reset to the default value
aliyun configure ai-mode reset-user-agent

AlibabaCloud-AIMode/enabled MyAgent/1.0

Remplacement par commande

Lorsque vous effectuez un appel OpenAPI, vous pouvez utiliser une option sur la ligne de commande pour remplacer le paramètre global du mode AI Mode pour la commande actuelle uniquement :

Si les deux options apparaissent dans la même commande, --no-cli-ai-mode est prioritaire.

Exemples :

# AI Mode is disabled globally, but this command appends the AI identifier
aliyun ecs DescribeInstances --cli-ai-mode

# AI Mode is enabled globally, but this command does not append the identifier
aliyun ecs DescribeInstances --no-cli-ai-mode

Fichier de configuration

Pour afficher ou sauvegarder manuellement le fichier de configuration du mode AI Mode, recherchez-le à l'emplacement suivant selon votre système d'exploitation :

Exemple de format de fichier :

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

Descriptions des champs :

Priorité

Les paramètres du mode AI Mode sont appliqués dans l'ordre suivant (du plus élevé au plus faible) :

1. Options de ligne de commande (--cli-ai-mode / --no-cli-ai-mode)

2. Variable d'environnement (ALIBABA_CLOUD_CLI_AI_MODE)

3. Fichier de configuration (ai-mode.json)

Lorsqu'un paramètre de priorité supérieure prend effet, les paramètres de priorité inférieure sont ignorés. Si --cli-ai-mode et --no-cli-ai-mode sont spécifiés dans la même commande, --no-cli-ai-mode est prioritaire.

Portée

Le mode AI Mode prend effet dans les scénarios suivants :

• Appels OpenAPI : Le segment d'identifiant IA est ajouté au User-Agent pour les requêtes RPC et RESTful initiées via des commandes.

• Commandes de plugin : La CLI transmet l'état du mode AI Mode aux processus enfants des plugins via les variables d'environnement ALIBABA_CLOUD_CLI_AI_MODE et ALIBABA_CLOUD_CLI_AI_USER_AGENT, permettant aux plugins d'ajouter l'identifiant à leurs propres requêtes.

Annexe : Référence des sous-commandes

Sous-commandes disponibles sous aliyun configure ai-mode :