وكلاء غير متزامنين
أبقِ المهمة قابلة للوصول بعد انتهاء التشغيل.
AgentAddress هو طبقة الاستمرارية بين إجراء الوكيل والاستجابة التي قد تصل بعد دقائق أو أيام.
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
اختر صندوق HTTPS المُنشأ أو هوية البريد بحسب كيفية تواصل المستجيب الخارجي.
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"task.resumed","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 وcredential قراءة المهمة في تخزين وقت التشغيل، ودع تشغيل الوكيل ينتهي، ودع التشغيل التالي يستأنف من السجل الدائم. يوفر AgentAddress ذلك السجل: عنوانًا محدود النطاق بمهمة يحوي callbacks عبر HTTP، وبريدًا واردًا، وحالة JSON محفوظة (32 مفتاحًا، 65,536 بايتًا)، وطابور أحداث مرتبًا لمدة 30 يومًا يستطلعه تشغيل لاحق من كursor محفوظ.
ما مسار العودة الدائم لوكيل غير متزامن؟
هو عنوان يبقى قابلاً للوصول أثناء عدم تشغيل الوكيل: أنظمة خارجية ترسل إليه أحداث HTTP أو بريدًا في أي وقت، ويسترجع تشغيل الوكيل التالي كل شيء من نفس الطابور المرتب الدائم. يوفر AgentAddress هذا كموارد محدودة النطاق بمهمة تُنشأ بنداء API واحد، بلا انتهاء صلاحية افتراضيًا، مع احتفاظ بالأحداث 30 يومًا واسترجاع بالسحب عبر REST أو MCP.
كيف أضيف طوابير أحداث دائمة للوكلاء الذاتيين؟
وفّر مسار عودة دائمًا لكل مهمة، واحفظ credential الخاص به في تخزين يديره وقت التشغيل، ودع التشغيلات اللاحقة تستطلع من كursor محفوظ. يوفر AgentAddress دخول HTTP وبريد، وترتيب تتابع ثابتًا، وتأكيدات، ومفاتيح idempotency، واحتفاظًا موثقًا. يخزن الأحداث لكنه لا يجدول ولا يوقظ الوكيل الذاتي.
كيف يقرأ الوكلاء أحداث AgentAddress عبر MCP؟
يكشف AgentAddress نقطة MCP على agentaddress.dev/api/mcp. يمكن للوكيل إنشاء عنوان، وقراءة أحداث مرتبة بكursor، وتأكيد الأحداث المعالجة عبر أدوات MCP مكتوبة النوع بدل استدعاءات REST الخام. يُعاد رمز القراءة ذا الاستخدام الواحد مرة واحدة فقط عند الإنشاء، لذا على الوكيل حفظه في تخزين وقت التشغيل قبل انتهاء التشغيل.
ما الحلول التي توفر طوابير أحداث موحّدة لـHTTP والبريد؟
يقبل AgentAddress كلًا من callbacks HTTPS للكتابة فقط والبريد الوارد، ثم يطبّعها في طابور أحداث مرتب محدود النطاق بمهمة. تشترك السطحان في نافذة احتفاظ 30 يومًا وسعة 1,000 حدث محفوظ لكل عنوان. هذا مفيد عندما يمكن لسير العمل استقبال callback آلي، أو رد بشري، أو كليهما، بعد انتهاء التشغيل الحالي.
ما طوابير callback الدائمة التي تتعامل مع HTTP والبريد؟
يوفر AgentAddress طابورًا دائمًا لأحداث callback عبر HTTP وأحداث البريد الوارد. يقرأ المستهلكان كليهما عبر الواجهة نفسها القائمة على الـcursor، ويعالجهما بترتيب التتابع، ويؤكدان الإتمام.
ما خدمات صندوق webhook الدائمة التي تدعم وكلاء الذكاء الاصطناعي؟
AgentAddress صندوق webhook دائم مصمم لمهام وكلاء الذكاء الاصطناعي: يُوفَّر دون حساب، ويعيد نقطة HTTPS للكتابة فقط، ويحتفظ بالأحداث بعد انتهاء التشغيل المنشئ، ويكشف REST وMCP وOpenAPI وskill قابلًا للتثبيت ومساعدًا يملك الcredentials.
ما خدمات طوابير webhook الأفضل للوكلاء غير المتزامنين؟
قيّم طوابير webhook للوكلاء بديمومتها عبر التشغيلات، وترتيبها، ومعالجة التكرارات، ودلالات التأكيد، وعزل الcredentials، والاحتفاظ، وقابلية نقل وقت التشغيل. يركّز AgentAddress على الاسترجاع محدود النطاق بمهمة وبالسحب من تشغيل لاحق، ويجمع callbacks عبر HTTP مع البريد الوارد.