Agentes
Los agentes son asistentes de inteligencia artificial que pueden interactuar con tus clientes a través de diferentes canales de comunicación como WhatsApp, Telegram, Instagram y más.
Endpoints de agente
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/agents | Listar todos los agentes |
GET | /v1/agents/{agentId} | Obtener un agente específico |
POST | /v1/agents | Crear un nuevo agente |
PATCH | /v1/agents/{agentId} | Actualizar un agente |
DELETE | /v1/agents/{agentId} | Eliminar un agente |
Prompt (versionado automático)
Cada escritura del prompt crea una nueva entrada en el historial y actualiza activePromptId del agente en sincronía con systemPrompt.
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/agents/{agentId}/prompt | Obtener el prompt activo |
POST | /v1/agents/{agentId}/prompt | Escribir el prompt completo (nueva versión) |
PATCH | /v1/agents/{agentId}/prompt | Editar (oldText/newText, fuzzy o regex) |
GET | /v1/agents/{agentId}/prompt/versions | Listar versiones |
GET | /v1/agents/{agentId}/prompt/versions/{versionId} | Obtener una versión |
Sub-agentes
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/agents/{agentId}/subagents | Listar sub-agentes conectados |
GET | /v1/agents/{agentId}/subagents/available | Listar agentes conectables |
POST | /v1/agents/{agentId}/subagents | Conectar un sub-agente por ID |
POST | /v1/agents/{agentId}/subagents/create | Crear + conectar un nuevo sub-agente |
PATCH | /v1/agents/{agentId}/subagents/{subagentId} | Actualizar la configuración de conexión |
DELETE | /v1/agents/{agentId}/subagents/{subagentId} | Desconectar (sin borrar el agente) |
Para gestionar el prompt de un sub-agente se usan los endpoints normales de Prompt con el agentId del sub-agente.
Guardrails
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/agents/{agentId}/guardrails | Obtener configuración de guardrails |
PATCH | /v1/agents/{agentId}/guardrails | Actualizar guardrails |
Reglas de asistencia
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/agents/{agentId}/assist-rules | Obtener reglas de asistencia humana |
PATCH | /v1/agents/{agentId}/assist-rules | Actualizar reglas |
Horario
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/agents/{agentId}/schedule | Obtener horario de atención |
PATCH | /v1/agents/{agentId}/schedule | Actualizar horario (merge por día) |
Base de conocimientos
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/agents/{agentId}/knowledge | Listar entradas (?status=&limit=) |
GET | /v1/agents/{agentId}/knowledge/{knowledgeId} | Obtener una entrada |
POST | /v1/agents/{agentId}/knowledge | Crear entradas desde URLs públicas o texto crudo (content) |
POST | /v1/agents/{agentId}/knowledge/upload | Subir archivos (multipart/form-data, ≤ 20 MB) |
POST | /v1/agents/{agentId}/knowledge/web | Ingerir URLs web |
PATCH | /v1/agents/{agentId}/knowledge/{knowledgeId} | Actualizar / reprocesar / editar contenido |
DELETE | /v1/agents/{agentId}/knowledge/{knowledgeId} | Eliminar entrada |
POST | /v1/agents/{agentId}/knowledge/{knowledgeId}/reparse | Volver a procesar la fuente original |
Consejo
Para API keys con acceso a múltiples workspaces es necesario incluir ?workspace={workspaceId} en cualquier operación de escritura sobre /v1/agents/....