> ## 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.

# Uso con Agentes de IA

> Cómo usar la CLI de Nudgen como interfaz para Agentes de IA.

## 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.

```bash theme={null}
# 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**:
   ```bash theme={null}
   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:
   ```bash theme={null}
   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.