Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.nudgen.net/llms.txt

Use this file to discover all available pages before exploring further.

​
Resumen

La CLI de Nudgen está diseñada con un enfoque AI-First. Aunque proporciona una hermosa TUI para humanos, cada comando también está optimizado para la comunicación entre máquinas.

​
El Patrón Agéntico

Cuando un agente de IA (como Claude, GPT o un agente de automatización especializado) utiliza la CLI, debe seguir estos patrones:
  1. Salida JSON: Añada --json a cada comando para obtener datos procesables por máquinas.
  2. Conciencia del Contexto: Verifique siempre el contexto del equipo antes de realizar operaciones.
  3. No interactivo: Use flags para omitir las solicitudes interactivas de la TUI.

​
Automatización JSON

Todos los comandos de lista y estado admiten un flag --json. Esto devuelve una estructura JSON limpia en lugar de una tabla con formato. 
# Obtener todas las campañas como JSON
nudgen campaigns list --json

# Obtener contactos en el equipo actual
nudgen contacts list --json

​
Flujo de Trabajo Multitenant para Agentes

Dado que Nudgen admite varios equipos, un agente debe asegurarse de que está operando en el equipo correcto antes de crear o actualizar recursos. Flujo de Trabajo Recomendado:
  1. Verificar el Equipo Actual: 
    nudgen teams current --json
  2. Cambiar de Equipo (si es necesario): Si el id del paso anterior no coincide con el equipo de destino, cambie: 
    nudgen teams switch <target-team-id>
  3. Ejecutar Comando de Datos: Proceda con los comandos campaigns, contacts o brand.

​
Mejores Prácticas para Desarrolladores de Agentes

  • Manejo de Errores: Supervise el código de salida de los comandos de la CLI. Un código de salida distinto de cero indica un error (validación, red o autenticación).
  • Limitación de Velocidad: La CLI se comunica con la API de Nudgen. Asegúrese de que sus scripts de agente manejen con elegancia los posibles límites de velocidad.
  • Modo Silencioso: Si un comando no admite un flag específico para cada solicitud, asegúrese de que su agente pueda manejar los flujos stdout/stderr sin quedarse atascado en un bucle de la TUI.