Ir al contenido principal

Usa tu propio agente (BYOA) con Level CLI

Connect your coding agent to Level CLI to inspect your fleet and draft scripts, automations, and monitor policies.

Level CLI puede generar una Habilidad de Agente que enseña a un agente de codificación compatible cómo usar tu versión instalada de lvl. Tú eliges el agente de codificación, el modelo y el proveedor de tokens. Level proporciona los comandos de la CLI y la SKILL.md referencia.

ℹ️ NOTA: Level no hospeda el modelo de lenguaje ni suministra tokens del modelo. Tu agente de codificación se ejecuta en tu entorno y llama a lvl con los permisos de tu sesión activa de Level.

Antes de comenzar

Necesitas:

  • Level CLI instalada y con sesión iniciada.

  • Un agente de codificación que pueda cargar las Habilidades de Agente en formato SKILL.md formato.

  • Permiso para instalar una habilidad a nivel de usuario o a nivel de proyecto para ese agente.

Ejecuta lvl --help, luego ejecuta lvl auth status para confirmar que la CLI está disponible y con sesión iniciada en la organización Level prevista.

Revisa la habilidad generada

Usa estos comandos para inspeccionar lo que recibirá el agente de codificación:

  • lvl skill show imprime la habilidad generada sin instalarla.

  • lvl skill describe device list muestra un comando, sus indicadores y la forma de su salida JSON.

  • lvl skill describe automation muestra todos los comandos del grupo de automatización.

  • lvl skill describe imprime la referencia de comandos generada completa.

La habilidad se genera a partir del árbol de comandos de tu CLI instalada, por lo que sus comandos y definiciones de salida coinciden con esa versión de lvl.

Instala la habilidad para tu cuenta de usuario

Ejecuta lvl skill install.

La habilidad canónica se escribe en ~/.agents/skills/level/SKILL.md. Esta ubicación es utilizada por Codex, Cursor, Gemini CLI y otros agentes que leen el ~/.agents/skills directorio.

Si Claude Code ya está configurado en el equipo, lvl también instala o vincula la habilidad en ~/.claude/skills/level. Cuando los enlaces simbólicos no están disponibles, el instalador copia la habilidad en su lugar.

Instala la habilidad en un proyecto

Usa una instalación a nivel de proyecto cuando quieras que la habilidad viaje con un repositorio o directorio de trabajo.

  1. Cambia al directorio del proyecto con cd YOUR_PROJECT_DIRECTORY.

  2. Ejecuta lvl skill install --project.

El comando escribe la habilidad canónica en ./.agents/skills/level/SKILL.md. También instala o vincula la ubicación de Claude Code en ./.claude/skills/level.

Revisa la documentación de tu agente de codificación para confirmar qué directorio de Habilidades de Agente utiliza.

⚠️ ADVERTENCIA: Una habilidad a nivel de proyecto puede confirmarse en el control de versiones. Revisa el archivo generado y la política de tu repositorio antes de confirmarlo. La habilidad generada no contiene tus credenciales de Level, pero describe comandos que pueden acceder a tu cuenta de Level cuando se ejecutan en un entorno autenticado.

Pide a tu agente de codificación que use lvl

Inicia una nueva sesión del agente de codificación en el mismo contexto de usuario o proyecto después de instalar la habilidad. Dale al agente un objetivo claro, el resultado esperado y el límite de permisos.

Las siguientes instrucciones usan citas en bloque para que se ajusten en pantallas más pequeñas. Reemplaza los nombres de ejemplo con recursos de tu cuenta de Level.

Investiga sin hacer cambios

Usa lvl para listar todos los dispositivos del grupo Servidores. Devuelve los IDs de dispositivos, nombres, sistemas operativos, estado en línea, alertas activas y actualizaciones disponibles. No realices cambios.

Esto muestra cómo un agente puede combinar datos de dispositivos, alertas y actualizaciones en un resumen de flota.

Elabora un script de diagnóstico

Usa lvl para inspeccionar web-01 y determinar su sistema operativo. Elabora un script de uso de disco de solo lectura para ese sistema operativo. Muéstrame el script completo, el ID del dispositivo de destino, el shell, la configuración de ejecutar como, el tiempo de espera y el comando lvl exacto. No crees ni ejecutes el script.

Después de revisar el script, puedes pedirle al agente que lo guarde con lvl script create o ejecútalo con lvl script run.

Crea una nueva automatización

Usa lvl skill describe automation para revisar los comandos de automatización actuales y el formato de especificación. Elabora una nueva automatización llamada Diagnóstico de Espacio en Disco que apunte al grupo Servidores, ejecute un diagnóstico de disco de solo lectura y registre la salida. Escribe la especificación YAML propuesta en disco y explica cada disparador, acción, variable y destino. No crees la automatización.

Después de revisar la especificación, pide al agente que la cree con lvl automation create -f AUTOMATION_SPEC.

⚠️ ADVERTENCIA: Crear una automatización a partir de una especificación aplica una cadena de mutaciones. No es transaccional. Si un paso falla, la automatización puede quedar parcialmente creada. Revisa la especificación completa antes de crearla y anota el ID de automatización devuelto por cualquier error.

Modifica una automatización existente de forma segura

Exporta la automatización Parchear Servidores con lvl automation spec. Propón el cambio YAML mínimo necesario para agregar un paso de espera de aprobación antes de la instalación de parches. Muéstrame el diff, luego ejecuta lvl automation apply con --dry-run. No apliques el cambio.

Este flujo de trabajo permite que el agente inspeccione la especificación completa del estado actual, la edite y previsualice cómo se reconciliaría con la automatización activa.

⚠️ ADVERTENCIA: Aplicar una especificación de automatización puede eliminar disparadores o acciones existentes que falten en el archivo. La aplicación no es transaccional. Siempre revisa el archivo completo y el resultado de la ejecución en seco antes de aplicarlo.

Crea una política de monitor

Usa lvl skill describe monitor policy y lvl skill describe monitor add para inspeccionar los formatos actuales de política de monitor y carga útil de monitor. Elabora una política de Salud del Servidor para la etiqueta Servidores con monitores de CPU, memoria y disco libre. Incluye los umbrales propuestos, duraciones, severidades, destinatarios de alertas y etiquetas de destino. Escribe la especificación YAML en disco y explica cada configuración. No crees la política.

Después de revisarla, pide al agente que cree la política con lvl monitor policy create -f POLICY_SPEC.

La creación de una política de monitor a partir de una especificación también es una cadena no transaccional. Un fallo puede dejar una política parcialmente creada, así que revisa el ID de política devuelto y corrígelo con lvl monitor policy apply -f POLICY_SPEC si es necesario.

Modifica una política de monitor existente

Exporta la política de monitor de Salud del Servidor. Agrega un monitor de script de solo lectura que verifique el punto de conexión de salud de la aplicación. Muéstrame el script propuesto y el diff de la política, luego ejecuta lvl monitor policy apply con --dry-run. No apliques el cambio.

La aplicación de la política de monitor reconcilia la política activa con el archivo. Los monitores que falten en la especificación pueden eliminarse, por lo que el agente debe revisar la política exportada completa en lugar de construir una actualización parcial.

Conecta la monitorización y la remediación

Inspecciona la política de monitor de Salud del Servidor y la automatización Reiniciar Servicio Web. Determina si el tipo de monitor actual admite el flujo de trabajo de remediación previsto. Elabora los cambios mínimos de política y automatización necesarios para alertar primero y ejecutar la remediación existente solo después de la aprobación. Muestra ambos diffs y planes de ejecución en seco. No apliques ningún cambio.

Esta instrucción hace que el agente inspeccione los esquemas actuales de monitor y automatización de la CLI instalada antes de proponer un flujo de trabajo conectado.

Organiza recursos reutilizables

Usa lvl para inventariar scripts, automatizaciones, políticas de monitor, etiquetas, grupos de dispositivos y archivos de repositorio relacionados con la aplicación de parches. Identifica nombres duplicados y referencias ambiguas. Propón un plan coherente de agrupación y nomenclatura. No cambies nombres, muevas ni elimines nada.

Un inventario de solo lectura es un primer paso útil antes de pedirle a un agente que reorganice recursos compartidos.

Revisa los comandos antes de la ejecución

Verifica estos detalles antes de permitir que se ejecute un comando propuesto:

  1. Confirma el perfil y la organización activos de Level con lvl auth status.

  2. Confirma cada dispositivo, grupo, script, automatización, política de monitor, etiqueta o referencia de archivo.

  3. Prefiere los IDs cuando los nombres sean ambiguos.

  4. Revisa el script completo o la especificación de estado completo.

  5. Exige --dry-run para los comandos de aplicación de automatización y política de monitor.

  6. Confirma si un comando espera a que se complete o solo solicita trabajo asíncrono.

  7. Pide al agente que se detenga antes de crear, aplicar, eliminar, reiniciar, apagar, instalar actualizaciones u otra acción privilegiada, a menos que tengas intención de aprobarlo.

⚠️ ADVERTENCIA: La creación de scripts y las ejecuciones de scripts ad hoc utilizan por defecto la configuración SYSTEM de configuración de ejecutar como, a menos que elijas otro valor. Los scripts y las acciones de automatización pueden realizar cambios privilegiados en los dispositivos administrados. Especifica --run-as current_user cuando ese es el alcance previsto, y revisa cada script antes de ejecutarlo.

Los comandos de eliminación permanente requieren confirmación. En una sesión no interactiva, los comandos que requieren confirmación fallan a menos que --yes está suministrado. Algunas acciones, incluido el reinicio y el apagado de dispositivos, solicitan la acción de inmediato y no tienen un mensaje de confirmación.

Actualiza la habilidad después de actualizar lvl

La habilidad y la referencia de comandos se generan a partir de tu versión de CLI instalada. Después de actualizar lvl, ejecuta lvl skill install de nuevo.

Para una instalación a nivel de proyecto, ejecuta lvl skill install --project.

Esto mantiene el índice de comandos, los indicadores y las definiciones de salida JSON de tu agente de codificación alineados con el binario instalado.

Solución de problemas

El agente de codificación no encuentra la habilidad

  1. Ejecuta lvl skill install de nuevo y anota el destino indicado.

  2. Confirma que tu agente de codificación lee ese directorio de Habilidades de Agente.

  3. Reinicia la sesión del agente de codificación después de instalar o actualizar la habilidad.

  4. Usa lvl skill show para confirmar que la CLI puede generar la habilidad.

Un comando de la habilidad no coincide con lvl

Reinstala la habilidad con el mismo lvl binario que llamará el agente de codificación. Si hay múltiples lvl los binarios están en tu PATH, ejecuta lvl --help, luego usa lvl skill describe COMMAND para inspeccionar el comando actual.

La CLI instalada y lvl skill describe son la fuente de verdad para los comandos y los indicadores disponibles.

¿Ha quedado contestada tu pregunta?