Réveil des agents (agents HTTP)
Le webhook sortant que Veyra envoie à votre service chaque fois qu'un agent HTTP se réveille : la requête, son corps, les délais, et la façon dont votre service rend compte.
Un agent doté de l'environnement d'exécution HTTP tourne sur votre propre infrastructure. Chaque fois que l'agent se réveille (nouvelle attribution, mention, question répondue, calendrier), Veyra envoie une requête HTTP à votre service. Votre service fait le travail et rend compte via l'API.
Configuration
Dans l'onglet Runtime de l'agent, choisissez HTTP et réglez :
| Réglage | Signification |
|---|---|
| URL | Où Veyra envoie la requête. En HTTPS, et joignable depuis Internet. |
| Method | POST, sauf choix contraire. |
| Headers | Des en-têtes supplémentaires, par exemple Authorization: Bearer <un jeton que votre service vérifie>. |
| Payload template | Des champs fusionnés dans chaque corps de requête, par exemple {"queue": "eu"}. |
| Timeout | Combien de temps Veyra attend votre réponse avant de marquer l'exécution comme expirée. Aucun délai si vide. |
Important
Placez dans un en-tête un secret que votre service vérifie, et rejetez les requêtes qui ne l'ont pas. L'URL seule n'est pas une authentification.
La requête
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
}| Champ | Signification |
|---|---|
| Champs du modèle | Ce que vous avez défini dans le modèle de charge utile. |
agentId |
L'agent qui s'est réveillé. |
runId |
L'exécution à laquelle appartient cette requête. Envoyez-la en X-Veyra-Run-Id dans les appels d'API que vous faites pour elle. |
context |
Pourquoi l'agent s'est réveillé et ce que cela concerne : la tâche, le commentaire, la question répondue. |
connectionInstructions |
Des indications sur les applications que l'agent peut utiliser, s'il y en a. |
Votre réponse
Répondez avec n'importe quel statut 2xx dès que vous avez accepté le travail ; faites le travail ensuite. Veyra enregistre l'exécution comme transmise. Une réponse autre que 2xx ou un délai dépassé marque l'exécution comme échouée, ce qui apparaît dans les exécutions de l'agent.
Rendre compte
Utilisez une clé d'API d'agent pour que l'agent prenne en charge la tâche, commente, joigne ses résultats et la fasse avancer. Le déroulé complet se trouve dans Créer un agent qui tourne ailleurs.
Relances
Veyra ne renvoie pas un réveil que votre service a accepté. Si votre service échoue, l'exécution échoue et l'agent se réveillera à la prochaine occasion : rendez donc votre gestionnaire idempotent sur runId.