agenteye-cli) es una Habilidad de Agente instalable que enseña a un agente de codificación — Claude Code, Codex y herramientas compatibles — a operar tu despliegue de AgentEye a través de la agenteye CLI mediante solicitudes en lenguaje natural: “¿hay algo roto hoy?”, “dale a CI una clave que solo pueda enviar eventos”, “reconoce el incidente activo y asígnamelo”.
No es un servicio ni un binario independiente. Es un pequeño paquete de instrucciones que se apoya en la CLI que ya tienes instalada: el agente ejecuta agenteye --json …, analiza el JSON limpio y te responde en prosa. Todo lo que puede hacer, podrías hacerlo tú mismo escribiendo los mismos comandos.
Cómo se relaciona con las demás interfaces de AgentEye
AgentEye te ofrece cuatro formas de acceder a los mismos datos y controles. Se complementan entre sí:| Interfaz | Qué es | Dónde se ejecuta | Úsala cuando |
|---|---|---|---|
| CLI | La referencia de comandos y opciones de agenteye | Tu terminal | Quieres ejecutar o automatizar un comando específico |
| Recetas de CLI | Patrones de jq/pipeline listos para copiar | Tu terminal / scripts | Estás integrando la CLI en automatización |
| Habilidad CLI (este documento) | Una puerta de entrada en lenguaje natural a la CLI | Tu agente de codificación, en tu estación de trabajo | Quieres simplemente preguntar y dejar que el agente elija el comando |
| Asistente de IA en el panel | Un chat integrado en el panel | Un contenedor agent interno en tu clúster | Quieres hacer preguntas sobre tus datos directamente en el panel |
vs. el Asistente de IA en el panel — una distinción importante
Son dos herramientas distintas con radios de acción muy diferentes:- El Asistente de IA en el panel (assistant.md) es un chat integrado en el panel, respaldado por un contenedor
agentinterno. Es de solo lectura más autoría con aprobación: puede redactar consultas guardadas y paneles, pero cada escritura se detiene para que hagas clic de aprobación explícita, y nunca elimina nada. Requiere el permisoagent:usey solo accede a los datos de la organización que estás viendo. - La habilidad CLI se ejecuta en tu estación de trabajo dentro de tu agente de codificación y maneja la
agenteyeCLI como tú. Puede realizar toda la superficie de la CLI, incluidas las mutaciones — crear/rotar/deshabilitar claves de API, cambiar configuración de la organización, resolver incidentes, eliminar consultas guardadas — limitada únicamente por los permisos de tu sesión en la CLI. Trátala exactamente con el mismo cuidado con el que tratarías ejecutar esos comandos manualmente.
Requisitos previos
- La CLI
agenteyeinstalada y disponible en elPATH(ver cli.md —pipx install agenteye). - La URL del panel configurada (
AGENTEYE_DASHBOARD_URL, o el agente pasa--base-url). - Una sesión iniciada: ejecuta
agenteye logintú mismo primero. La habilidad no puede completar el inicio de sesión con código de un solo uso enviado por correo — te indicará que ejecutesagenteye loginsi la sesión está ausente o caducada (código de salida4de la CLI).
Instalación de la habilidad
Las Habilidades de Agente son carpetas que contienen unSKILL.md (más referencias opcionales). Instala la habilidad agenteye-cli colocando su carpeta donde tu agente busca habilidades:
- Claude Code — copia la carpeta
agenteye-cli/en~/.claude/skills/(disponible en todos los proyectos) o en<tu-repositorio>/.claude/skills/(limitado a ese repositorio). Claude Code la detecta automáticamente; verifica con la lista/skills, o simplemente haz una pregunta que coincida con su descripción. - Codex (OpenAI) — Codex lee el mismo
SKILL.md. El archivoagents/openai.yamlincluido estableceallow_implicit_invocation: true, por lo que Codex selecciona la habilidad automáticamente cuando una tarea coincide; de lo contrario, invócala explícitamente como$agenteye-cli.
agenteye y se distribuye como parte de tu paquete AgentEye — si no tienes la carpeta agenteye-cli, contacta a tu responsable de AgentEye. No hay restricciones de acceso: no necesita ninguna imagen Docker ni credencial, ya que solo maneja la agenteye CLI pública contra tu propio panel.
Seguridad — las mutaciones NO solicitan confirmación cuando un agente ejecuta la CLI
Lee esto antes de permitir que un agente realice cambios. La CLIagenteye normalmente pregunta “¿estás seguro?” antes de una acción destructiva. Omite automáticamente esa confirmación siempre que no esté conectada a un terminal — que es exactamente como la ejecuta un agente de codificación — y --json también la omite. Por lo tanto, el aviso de seguridad no se activará para el agente.
La habilidad está diseñada para compensar esto: se le instruye que indique el comando exacto que ejecutará y obtenga tu confirmación explícita antes de cualquier cambio de estado. Mantén esa disciplina — cuando manejas AgentEye a través de un agente, tú eres el paso de confirmación. Los comandos que modifican estado que debes vigilar:
keys create/update/disable/regenerateusers create/update/disable/enablesettings setalerts create/update/delete/test- los subcomandos de escritura de
incidents:ack/assign/resolve/open/comment-add/comment-delete/subscribe/unsubscribe query create/update/deleteagent rename/deleteorgs switch
events, sessions, evals, errors, list, whoami, orgs list/current/perms) es de solo lectura y no modifica nada.
Dado que el agente actúa como tú, solo puede hacer lo que tu sesión tiene permitido — los permisos se resuelven por organización (ver api-keys.md). Un comando para el que no tienes permiso devuelve el código de salida 5 con el nombre exacto del permiso requerido, por lo que el agente puede indicarte con precisión qué solicitar a un administrador en lugar de fallar de forma opaca.
Qué puedes pedirle
La habilidad traduce la intención en lenguaje natural al comandoagenteye correcto, descubriendo primero los valores válidos (list <kind>, whoami) para no adivinar:
- “¿Hay algo roto o fallando en las últimas 24 horas?” →
errors --since 24h --aggregate, seguido de un desglose. - “¿Por qué falló la sesión
run-001?” →events --session-id run-001 --all+evals --session-id run-001. - “¿Cómo evoluciona la calidad esta semana?” →
evals --aggregate --since 7d, luego profundiza en las ejecuciones con puntuación baja. - “Dale a CI una clave que solo pueda enviar eventos.” →
keys create ci --add events:add(indica el comando, luego lo crea y captura el secreto de un solo uso). - “¿Quién tiene acceso? Haz que Dana sea solo lectura.” →
users list→users update dana@… --permission-set read-only(tras confirmar contigo). - “Reconoce el incidente activo y asígnamelo.” →
incidents list --state firing→incidents ack <id>/incidents assign <id> tu@….
Ver también
- CLI — referencia completa de comandos y opciones para
agenteye. - Recetas de CLI para agentes — patrones de
jqlistos para copiar y manejo de códigos de salida. - Asistente de IA — el asistente integrado en el panel (no confundir con esta habilidad de terminal).
- Claves de API — el modelo de permisos por organización que delimita lo que la habilidad puede hacer.