API degli Agenti

Endpoint CRUD per agenti WhatsApp, Email e Machine con esempi di request e response.

Endpoint degli Agenti

Metodo	Endpoint	Descrizione
`GET`	`/api/v1/agents`	Elenco agenti
`POST`	`/api/v1/agents`	Crea agente
`GET`	`/api/v1/agents/{agent_id}`	Ottieni agente
`PUT`	`/api/v1/agents/{agent_id}`	Aggiorna agente
`DELETE`	`/api/v1/agents/{agent_id}`	Elimina agente

Permessi richiesti: view_agents per lettura, manage_agents per scrittura.

Creare un Agente WhatsApp

POST /api/v1/agents

{
  "name": "Supporto Tecnico",
  "type": "whatsapp",
  "system_prompt": "Sei un assistente di supporto tecnico industriale...",
  "whatsapp_number_id": "wn_abc123",
  "model": "gemini-2.0-flash",
  "temperature": 0.3,
  "tools": ["tool_id_1", "tool_id_2"]
}

Risposta 201:

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

Creare un Agente Email

POST /api/v1/agents

{
  "name": "Processore di Report",
  "type": "email",
  "system_prompt": "Analizza i report ricevuti via email...",
  "email_account_id": "ea_def456",
  "model": "gemini-2.0-flash",
  "temperature": 0.2,
  "tools": ["tool_id_3"]
}

L'agente email richiede un account email attivo precedentemente configurato nel sistema.

Creare un Agente Machine

Gli agenti machine elaborano dati da sensori e apparecchiature industriali:

POST /api/v1/agents

{
  "name": "Monitor Vibrazioni",
  "type": "machine",
  "system_prompt": "Analizza le letture di vibrazione e rileva anomalie...",
  "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
  }
}

Elenco Agenti

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

Filtri disponibili:

Parametro	Valori
`type`	whatsapp, email, machine
`status`	active, inactive, error
`skip`	Offset di paginazione (default: 0)
`limit`	Elementi per pagina (default: 20)

Aggiornare un Agente

PUT /api/v1/agents/{agent_id}

{
  "name": "Supporto Tecnico v2",
  "system_prompt": "Prompt aggiornato...",
  "temperature": 0.4
}

Vengono aggiornati solo i campi inclusi nel body. I campi omessi mantengono il valore corrente.

Eliminare un Agente

DELETE /api/v1/agents/{agent_id}

Risposta 204 senza contenuto. L'eliminazione e permanente e rimuove tutte le configurazioni associate all'agente.

L'eliminazione di un agente non cancella la cronologia delle conversazioni. Viene conservata secondo la politica di retention del tenant.