API de Agentes

Endpoints CRUD para agentes WhatsApp, Email y Machine con ejemplos de request y response.

Endpoints de Agentes

Metodo	Endpoint	Descripcion
`GET`	`/api/v1/agents`	Listar agentes
`POST`	`/api/v1/agents`	Crear agente
`GET`	`/api/v1/agents/{agent_id}`	Obtener agente
`PUT`	`/api/v1/agents/{agent_id}`	Actualizar agente
`DELETE`	`/api/v1/agents/{agent_id}`	Eliminar agente

Permisos requeridos: view_agents para lectura, manage_agents para escritura.

Crear Agente WhatsApp

POST /api/v1/agents

{
  "name": "Soporte Tecnico",
  "type": "whatsapp",
  "system_prompt": "Eres un asistente de soporte tecnico industrial...",
  "whatsapp_number_id": "wn_abc123",
  "model": "gemini-2.0-flash",
  "temperature": 0.3,
  "tools": ["tool_id_1", "tool_id_2"]
}

Respuesta 201:

{
  "id": "agent_xyz789",
  "name": "Soporte Tecnico",
  "type": "whatsapp",
  "status": "active",
  "created_at": "2026-03-25T10:00:00Z"
}

Crear Agente Email

POST /api/v1/agents

{
  "name": "Procesador de Reportes",
  "type": "email",
  "system_prompt": "Analiza los reportes recibidos por email...",
  "email_account_id": "ea_def456",
  "model": "gemini-2.0-flash",
  "temperature": 0.2,
  "tools": ["tool_id_3"]
}

El agente email requiere una cuenta de email activa configurada previamente en el sistema.

Crear Agente Machine

Los agentes machine procesan datos de sensores y equipos industriales:

POST /api/v1/agents

{
  "name": "Monitor de Vibraciones",
  "type": "machine",
  "system_prompt": "Analiza lecturas de vibracion y detecta anomalias...",
  "model": "gemini-2.0-flash",
  "temperature": 0.1,
  "tools": ["tool_id_4", "tool_id_5"],
  "trigger_config": {
    "event_types": ["vibration.threshold_exceeded"],
    "cooldown_minutes": 15
  }
}

Listar Agentes

GET /api/v1/agents?type=whatsapp&status=active&skip=0&limit=20

Filtros disponibles:

Parametro	Valores
`type`	whatsapp, email, machine
`status`	active, inactive, error
`skip`	Offset de paginacion (default: 0)
`limit`	Elementos por pagina (default: 20)

Actualizar Agente

PUT /api/v1/agents/{agent_id}

{
  "name": "Soporte Tecnico v2",
  "system_prompt": "Prompt actualizado...",
  "temperature": 0.4
}

Solo se actualizan los campos incluidos en el body. Los campos omitidos mantienen su valor actual.

Eliminar Agente

DELETE /api/v1/agents/{agent_id}

Respuesta 204 sin contenido. La eliminacion es permanente y remueve todas las configuraciones asociadas al agente.

Eliminar un agente no borra su historial de conversaciones. Este se conserva segun la politica de retencion del tenant.