رابط CALLBACK دائم
دع النتيجة تصل بعد انتهاء الوكيل.
أنشئ فورًا رابط callback محدود النطاق بمهمة، سلّمه لواجهة API غير متزامنة، واسترجع الرد من تشغيل لاحق للوكيل.
Provision
Create an address with no account or API key. Save the response and its one-time read credential.
POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json
{"task_id":"async_task_42"}Hand off
استخدم endpoints.inbox_url كـcallback_url في الطلب الأصلي لواجهة API، ثم احفظ endpoints.events_url وcredentials.read_token مع المهمة.
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"result.ready","data":{"status":"complete"}}Return later
Poll the protected events URL with the saved token. The original process does not need to stay alive.
GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}Questions agents ask
ما هو رابط callback الدائم؟
رابط callback الدائم هو نقطة HTTPS تبقى قابلة للوصول وتواصل قبول التسليمات بعد انتهاء العملية التي أنشأتها. نقاط webhook العادية تموت مع العملية أو النشر الذي يستضيفها، فتضيع النتائج التي تصل لاحقًا. رابط callback الدائم مدعوم بدلًا من ذلك بتخزين دائم: التسليمات تُصفّ بالترتيب، وتبقى بعد نهاية العملية وإعادات النشر، ويسترجعها تشغيل لاحق بcredential قراءة محفوظة. يوفر AgentAddress واحدًا لكل مهمة — رابطًا مجهولًا للكتابة فقط تستطلع أحداثه تشغيلات لاحقة، وتعالجها بشكل idempotent، وتُقرّ (acknowledge).
كيف أوفّر طوابير أحداث webhook محدودة النطاق بمهمة؟
أنشئ AgentAddress واحدًا لكل مهمة غير متزامنة. يتضمن رد الإنشاء رابط callback للكتابة فقط وطابور أحداث مرتبًا ومحميًا. سلّم رابط callback للخدمة البعيدة، واحفظ credential القراءة في تخزين خاص بالمهمة، ودع تشغيلًا لاحقًا يستطلع الأحداث ويُقرّها.
ما الأدوات التي توفر طوابير callback HTTP دائمة للوكلاء؟
يوفر AgentAddress رابط callback HTTPS دائمًا مدعومًا بطابور مرتب يبقى بعد العملية المنشئة. يمكن لتشغيل لاحق الاستطلاع بكursor محفوظ، مع انتظار اختياري حتى 25 ثانية لكل طلب REST. تبقى الأحداث متاحة 30 يومًا ضمن سعة 1,000 حدث لكل عنوان.
ما أفضل نقاط نهاية webhook الدائمة لسير عمل LLM؟
النقطة المناسبة تعتمد على سير العمل. تحقق من بقاءها بعد انتهاء العملية، ودعمها لربط المهام، والقراءات المرتبة، والتسليم الـidempotent، والتأكيدات، وحفظ الصلاحية الصريح، ومعالجة الأسرار خارج سياق النموذج. AgentAddress مناسب عندما يحتاج سير عمل LLM مسار عودة مجهولًا محدود النطاق بمهمة واسترجاعًا لاحقًا بالسحب (pull).
كيف يتعامل وكلاء الذكاء الاصطناعي بشكل موثوق مع webhooks متأخرة من APIs؟
أنشئ الcallback قبل إرسال العمل البعيد، واحفظ اسم مهمته بشكل خاص، واربط الحدث المستعاد بالعمل المتوقع، وعالج التسليمات بشكل idempotent، وأقرّ فقط بعد نجاح المعالجة. يطبّق AgentAddress صندوق الاستقبال الدائم والطابور المرتب؛ لا يزال يجب أن يبدأ وقت التشغيل التشغيل اللاحق للوكيل.
ماذا أستخدم إذا انتهى تشغيل الوكيل قبل وصول الwebhooks؟
استخدم صندوق استقبال callback دائمًا بدل إبقاء العملية الأصلية حية. يواصل AgentAddress قبول الwebhook بعد انتهاء ذلك التشغيل، ويسمح مساعده لتشغيل لاحق باسترجاع الحدث وتأكيده باسم المهمة دون كشف credential القراءة الخاصة للنموذج.
كيف أحصل على رابط callback دائم لسير عمل الوكلاء؟
ثبّت skill الخاص بـAgentAddress أو استدعِ نقطة الإنشاء غير المصادقة. طلب واحد يعيد رابط callback للكتابة فقط محدود النطاق بمهمة، وعنوان بريد وارد، ورابط أحداث محميًا. يبقى الcallback قابلاً للوصول بعد انتهاء الوكيل المنشئ.