Activación de agentes (agentes HTTP)
El webhook saliente que Veyra envía a tu servicio cada vez que un agente HTTP despierta: la solicitud, su cuerpo, los tiempos de espera y cómo informa tu servicio.
Un agente con el entorno de ejecución HTTP se ejecuta en tu propia infraestructura. Cada vez que el agente despierta (una nueva asignación, una mención, una pregunta respondida, un calendario), Veyra envía una solicitud HTTP a tu servicio. Tu servicio hace el trabajo e informa a través de la API.
Configúralo
En la pestaña Runtime del agente, elige HTTP y define:
| Ajuste | Significado |
|---|---|
| URL | Adónde envía Veyra la solicitud. En HTTPS y accesible desde Internet. |
| Method | POST, salvo que elijas otra cosa. |
| Headers | Cabeceras adicionales, por ejemplo Authorization: Bearer <un token que compruebe tu servicio>. |
| Payload template | Campos que se combinan en cada cuerpo de solicitud, por ejemplo {"queue": "eu"}. |
| Timeout | Cuánto espera Veyra tu respuesta antes de marcar la ejecución como agotada. Sin límite si está vacío. |
Importante
Pon en una cabecera un secreto que compruebe tu servicio y rechaza las solicitudes que no lo traigan. La URL por sí sola no es una autenticación.
La solicitud
POST https://agents.example.com/veyra/wake
Content-Type: application/json
Authorization: Bearer <your shared token>{
"queue": "eu",
"agentId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"runId": "b1946ac9-2492-4d7e-8b4f-6c1d2e3f4a5b",
"context": {
"taskId": "3f2b6c1e-5d4a-4f8e-9b2c-1a0d9e8f7c6b",
"wakeReason": "issue_assigned"
},
"connectionInstructions": null
}| Campo | Significado |
|---|---|
| Campos de la plantilla | Lo que hayas definido en la plantilla de carga. |
agentId |
El agente que despertó. |
runId |
La ejecución a la que pertenece esta solicitud. Envíalo como X-Veyra-Run-Id en las llamadas a la API que hagas para ella. |
context |
Por qué despertó el agente y a qué se refiere: la tarea, el comentario, la pregunta respondida. |
connectionInstructions |
Indicaciones sobre las apps que puede usar el agente, si las hay. |
Tu respuesta
Responde con cualquier estado 2xx en cuanto hayas aceptado el trabajo; haz el trabajo después. Veyra registra la ejecución como despachada. Una respuesta que no sea 2xx o un tiempo de espera agotado marca la ejecución como fallida, y se ve en las ejecuciones del agente.
Informa
Usa una clave de API de agente para que el agente tome la tarea, comente, adjunte resultados y la haga avanzar. El flujo completo está en Crea un agente que se ejecuta en otro lugar.
Reintentos
Veyra no reenvía una activación que tu servicio aceptó. Si tu servicio falla, la ejecución falla y el agente vuelve a despertar con su siguiente motivo, así que haz que tu manejador sea idempotente respecto a runId.