Agent uyandırmaları (HTTP agent'ları)
Bir HTTP agent'ı her uyandığında Veyra'nın servisinize gönderdiği giden webhook: istek, gövdesi, zaman aşımları ve servisinizin nasıl geri bildirim yaptığı.
HTTP çalışma ortamına sahip bir agent kendi altyapınızda çalışır. Agent her uyandığında (yeni bir atama, bir bahsetme, yanıtlanmış bir soru, bir takvim) Veyra servisinize bir HTTP isteği gönderir. Servisiniz işi yapar ve API üzerinden geri bildirir.
Yapılandırın
Agent'ın Runtime sekmesinde HTTP'yi seçin ve şunları ayarlayın:
| Ayar | Anlamı |
|---|---|
| URL | Veyra'nın isteği gönderdiği yer. HTTPS olmalı ve internetten erişilebilmeli. |
| Method | Başka bir şey seçmedikçe POST. |
| Headers | Ek başlıklar, örneğin Authorization: Bearer <servisinizin denetlediği bir token>. |
| Payload template | Her istek gövdesine eklenen alanlar, örneğin {"queue": "eu"}. |
| Timeout | Veyra'nın çalıştırmayı zaman aşımına uğramış saymadan önce yanıtınızı ne kadar beklediği. Boşsa zaman aşımı yoktur. |
Önemli
Servisinizin denetlediği bir sırrı bir başlığa koyun ve onu taşımayan istekleri reddedin. URL tek başına kimlik doğrulama değildir.
İstek
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
}| Alan | Anlamı |
|---|---|
| Şablon alanları | Yük şablonunda ne ayarladıysanız. |
agentId |
Uyanan agent. |
runId |
Bu isteğin ait olduğu çalıştırma. Bunun için yaptığınız API çağrılarında X-Veyra-Run-Id olarak gönderin. |
context |
Agent'ın neden uyandığı ve neyle ilgili olduğu: görev, yorum, yanıtlanmış soru. |
connectionInstructions |
Varsa, agent'ın kullanabileceği uygulamalar için yönlendirme. |
Yanıtınız
İşi kabul eder etmez herhangi bir 2xx durumuyla yanıt verin; işi sonra yapın. Veyra çalıştırmayı gönderildi olarak kaydeder. 2xx olmayan bir yanıt ya da zaman aşımı çalıştırmayı başarısız sayar ve bu, agent'ın çalıştırmalarında görünür.
Geri bildirin
Agent'ın görevi üstlenmesi, yorum yapması, sonuçları eklemesi ve görevi ilerletmesi için bir agent API anahtarı kullanın. Akışın tamamı Başka yerde çalışan bir agent geliştirin sayfasında.
Yeniden denemeler
Veyra, servisinizin kabul ettiği bir uyandırmayı yeniden göndermez. Servisiniz başarısız olursa çalıştırma başarısız olur ve agent bir sonraki nedeninde yeniden uyanır; bu yüzden işleyicinizi runId üzerinde idempotent yapın.