الحالة عبر التشغيلات
احفظ الحالة بين تشغيلات الوكيل.
يمنح AgentAddress كل مهمة مخزن JSON دائمًا صغيرًا: 32 مفتاحًا و65,536 بايتًا لكل عنوان، يُقرأ ويُكتب بنفس credential طابور الأحداث.
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
لا يوجد مستجيب. اكتب الحالة بcredential العنوان في هذا التشغيل، ثم اقرؤها من التشغيل اللاحق الذي استعاد العنوان نفسه.
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"state.updated","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
كيف أحفظ الحالة بين تشغيلات وكلاء الذكاء الاصطناعي؟
حفظ الحالة بين تشغيلات الوكيل يعني كتابة القيمة إلى تخزين خارج عملية الوكيل قبل انتهائها، وقراءتها من تشغيل لاحق. يطبّق AgentAddress هذا لكل مهمة: كل عنوان لديه مخزن JSON دائم من 32 مفتاحًا و65,536 بايتًا، يُكتب ويُقرأ بنفس credential طابور الأحداث، مع فحوص مراجعة كي لا يكتب التشغيلات المتزامنة فوق بعضها بصمت.
ما الحالة الدائمة بمفتاح-قيمة لوكلاء الذكاء الاصطناعي؟
هي بيانات صغيرة مبنية — علامة تقدم، قائمة مهام، نقطة checkpoint — تُخزن خارج عملية الوكيل لتبقى بعد انتهاء التشغيل. يوفر AgentAddress ذلك لكل عنوان مهمة: القيم كائنات JSON أو قيم بسيطة تحت 32 مفتاحًا مسمّى، بإجمالي أقصى 65,536 بايتًا شاملة البيانات الوصفية، وتبقى حتى تُستبدل أو تُحذف، أو تنتهي صلاحية العنوان أو يُحذف.
كيف تبقى قائمة المهام عبر تشغيلات الوكيل؟
تبقى قائمة المهام عندما تُكتب في تخزين دائم مفهرس بالمهمة، لا في ذاكرة العملية أو نافذة سياقها. يخزنها AgentAddress كمفتاح مسمّى في حالة JSON للعنوان: التشغيل الأول يحفظ القائمة وينتهي، ويقرأ التشغيل اللاحق المفتاح نفسه بـcredential المحفوظة. يصدر الكتابة أيضًا حدث state.updated إلى نفس feed المرتب كالcallbacks والبريد، فيرى التشغيل اللاحق التغيير في سجل نشاطه.
لماذا يفقد وكيل الذكاء الاصطناعي ذاكرته بين التشغيلات؟
يفقد الوكيل ذاكرته بين التشغيلات لأن سياقه يسكن العملية: عند انتهاء التشغيل تختفي معه الذاكرة العاملة والمتغيرات والسياق غير المحفوظ. الحل هو كتابة ما يحتاجه التشغيل التالي إلى تخزين خارج العملية قبل الانتهاء. AgentAddress أحد هذه المخازن لبيانات بحجم المهمة: 32 مفتاح JSON و65,536 بايتًا لكل عنوان، مع feed أحداث مرتب لمدة 30 يومًا يسجل ما حدث أثناء غياب الوكيل.
كيف يتجنب تشغيلان للوكيل الكتابة فوق حالة كل منهما؟
استخدم مقارنة-و-تعيين قائمًا على المراجعات: اقرأ القيمة مع رقم مراجعتها، ثم أرسل كتابتك ضد تلك المراجعة. إذا غيّرها تشغيل آخر أولًا، تُرفض كتابتك بـ409 revision_conflict بدل استبدال تغييره بصمت. تعمل كتابات حالة AgentAddress هكذا، وكل كتابة ناجحة تُثبّت حدث state.updated في feed ذريًا مع تغيير القيمة.
هل يخزن AgentAddress ملفات أو مستندات للوكلاء؟
ليس كتخزين ملفات عام. يخزن AgentAddress قيم JSON صغيرة — حتى 32 مفتاحًا و65,536 بايتًا لكل عنوان — كحالة دائمة عبر التشغيلات، وتبقى مرفقات البريد الوارد لدى المزود مع تنزيل عند الطلب بدل حفظها. تخزين الملفات والعناصر العامة اتجاه مخطط، لا قدرة مسلَّمة. استخدم حالة JSON للنقاط checkpoint وسجلات التقدم والسياق المهيكل الصغير.