Elastic Compute Service:Gestión de instancias ECS mediante Workbench CLI en agentes de IA

Por qué los agentes de IA son ideales para Workbench CLI

En comparación con otros métodos de conexión a instancias ECS, Workbench CLI es inherentemente adecuado para ser invocado por agentes de IA:

• Salida JSON estructurada: Todos los comandos admiten --output json y devuelven una estructura de campos predecible (por ejemplo, exec devuelve output, stderr y exit_code), por lo que el agente no necesita analizar texto con expresiones regulares.

• Traspaso del código de salida: workbench exec transmite el código de salida del comando remoto (de forma consistente con SSH), lo que permite al agente determinar si el comando remoto se ejecutó correctamente. Cuando un comando falla, --output json genera información de error estructurada que el agente puede analizar para decidir si reintenta la operación o reporta un error.

• Ejecución sin estado: Cada llamada a workbench exec se ejecuta en un entorno independiente sin conservar el estado del shell. El agente no necesita mantener el contexto de la sesión y el comportamiento de los comandos no se vuelve impredecible por estados residuales.

• Semántica de comandos intuitiva: Los nombres list / exec / upload / download corresponden uno a uno con tareas operativas comunes, por lo que el agente puede aprender a usarlos por sí mismo mediante --help.

Requisitos previos

• Workbench CLI debe estar instalado en su computadora, con las credenciales y una directiva de RAM de mínimo privilegio configuradas. Para obtener más información, consulte Install Workbench CLI and configure credentials.

• La herramienta de codificación con IA de destino (Wukong, opencode u otra herramienta de IA capaz de ejecutar comandos de shell) debe estar instalada en su computadora.

• Se recomienda leer primero Manage ECS instances by using Workbench CLI para familiarizarse con el uso de cada subcomando de workbench, de modo que pueda evaluar mejor la salida del agente.

Carga de la habilidad Workbench CLI en una herramienta de IA

Alibaba Cloud ha publicado una habilidad oficial de Workbench CLI que incluye el uso de todos los subcomandos, descripciones de parámetros, significados de códigos de salida y flujos de trabajo típicos. Una vez cargada la habilidad en una herramienta de codificación con IA, el agente puede invocar de forma autónoma el comando workbench cuando usted exprese su intención operativa en lenguaje natural. Las siguientes secciones describen cómo cargar la habilidad en Qoder, Wukong y opencode, en ese orden.

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-workbench-cli --agent qoder -y --full-depth

You: Deploy the local app.jar to the /opt/app directory on instance i-bp1a2b3c4d5e6f.
Agent: (Calls workbench upload and then workbench exec to complete the deployment, and reports the result step by step.)

You: Use workbench to list the running instances in China (Hangzhou).
Agent: (Automatically runs workbench list ecs -r cn-hangzhou --status Running --output json and summarizes the result.)

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-workbench-cli --agent opencode -y --full-depth

You: Connect to instance i-bp1a2b3c4d5e6f and check its disk usage.
Agent: (Automatically runs workbench exec -i i-bp1a2b3c4d5e6f -c "df -h" --output json and explains the result.)

Para más herramientas de IA, visite la página de Workbench CLI Skill.

Read the output of workbench --help and learn to use the workbench tool to manage and operate my Alibaba Cloud ECS instances.

Escenarios típicos de conversación

List the running instances in China (Hangzhou).

workbench list ecs -r cn-hangzhou --status Running --output json

{
  "instances": [
    { "instance_id": "i-bp1a2b3c...", "instance_name": "web-prod-01", "status": "Running", "private_ip": "172.16.0.10" },
    { "instance_id": "i-bp2x4y5z...", "instance_name": "api-prod-02", "status": "Running", "private_ip": "172.16.0.11" }
  ]
}

Check whether i-bp1a2b3c4d5e6f has enough disk space.

workbench exec -i i-bp1a2b3c4d5e6f -c "df -h" --output json

{
  "output": "Filesystem      Size  Used Avail Use% Mounted on\n/dev/vda1        40G   36G  4.0G  90% /\n/dev/vdb1       100G   20G   80G  20% /data\n",
  "stderr": "",
  "exit_code": 0
}

Deploy ./app-2.0.tar.gz to the /opt/deploy directory on i-bp1a2b3c4d5e6f, then extract and verify it.

workbench upload ./app-2.0.tar.gz /opt/deploy/app-2.0.tar.gz -i i-bp1a2b3c4d5e6f
workbench exec -i i-bp1a2b3c4d5e6f -c "cd /opt/deploy && tar xzf app-2.0.tar.gz" --output json
workbench exec -i i-bp1a2b3c4d5e6f -c "ls -lh /opt/deploy/app-2.0/" --output json

Permisos y recomendaciones de seguridad

• Utilice un usuario o rol de RAM dedicado para el agente de IA: Separe las credenciales del agente de las utilizadas por personas. Esto facilita distinguir entre "operaciones humanas" y "operaciones del agente" en los registros de auditoría, además de permitir localizar rápidamente el origen de cualquier problema.

• Aplique una directiva de mínimo privilegio y limite el alcance por recurso: Otorgue al agente únicamente las acciones necesarias y utilice los ARN de instancia para restringir el Resource a instancias específicas, evitando así que una operación errónea afecte a otras instancias.

• Habilite la confirmación humana en el bucle (HITL): El modo de agente integrado en workbench connect requiere confirmación Y/n antes de ejecutar cualquier comando de forma predeterminada. Para herramientas de IA externas, también se recomienda habilitar la confirmación del usuario antes de la ejecución de comandos.

• Prefiera RamRoleArn en entornos de producción: Los escenarios con agentes suelen ejecutarse durante largos periodos y utilizan credenciales con frecuencia, por lo que un par de AccessKey estático comprometido representa un alto riesgo. Prefiera RamRoleArn o CredentialsURI para que las credenciales se actualicen automáticamente.

Preguntas frecuentes

Referencias

• Connect to an instance by using Workbench CLI: Tema principal que aborda el posicionamiento de la herramienta y una guía de inicio rápido.

• Install Workbench CLI and configure credentials: Instalación del CLI y configuración de credenciales y permisos.

• Manage ECS instances by using Workbench CLI: Descripciones detalladas de cada comando y solución de problemas (incluye cómo usar el asistente de IA dentro de una sesión de conexión).