الانتقال إلى المحتوى الرئيسي
لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ النسخة الإنجليزية.
هذه الصفحة للكود الذي يستخدم AgentBuilder وAgentExecutor وToolRegistry وresumeAfterApproval(): الـ API الأدنى مستوى الذي بدأ به الـ SDK. هذه الـ exports انتقلت إلى lousho/executor ولن تُحذف. إذا بقيت عليها، راجع واجهة الـ executor. سبب الانتقال أن استدعاء createAgent() واحد يربط الـ tools والـ stores والـ approvals (موافقات) والـ sessions (جلسات) والـ retries (إعادة المحاولة) والـ compaction (ضغط سياق المحادثة)، بينما الـ executor يجعلك تجمع كل واحد منها بنفسك وتمرره في كل استدعاء. ما يزال createAgent() لا يقبل كل الخيارات التي يقبلها الـ executor. راجع ما لا يقبله createAgent() حتى الآن قبل أن تبدأ.

قبل وبعد

agent واحد مع tool يتطلب approval: أولًا بـ executor API، ثم بـ createAgent(). كلاهما يستخدم model بردود جاهزة مسبقًا، فيعملان دون اتصال وينتهيان بنفس النص Sent the report to Sam. بعد نفس التوقف.
الـ tool هو ناتج defineTool() نفسه في الحالتين. الـ agent يحتفظ بالـ registry والـ approval store والـ provider الخاصة به، فيكفي معرّف الـ approval لاستكمال التوقف.

جدول المقابلات

ما لا يقبله createAgent() حتى الآن

هذه خيارات ExecuteOptions ليس لها خيار مقابل في createAgent(). إذا وُجد بديل مدعوم فهو مذكور؛ وإلا فأبقِ ذلك الاستدعاء على AgentExecutor.execute(). الـ run الواحد يستخدم إحدى الواجهتين فقط: agent يحتاج خيارًا من صفوف «لا يوجد» يترك ذلك الاستدعاء على الـ executor، ويستخدم createAgent() في باقي الكود.

اختلافات السلوك

  • send() هو turn واحد. المحادثة كائن مستقل هو agent.session()، يحتفظ بالـ transcript ويرسله مع كل turn؛ راجع الجلسات. الكود الذي كان يبني سجل الرسائل يدويًا ينتقل إلى session.
  • الـ run الموقوف يرجع نتيجة، لا يعلق. الـ send() الذي يصل إلى tool عليه needsApproval يرجع بـfinishReason: 'awaiting-approval' ومعه approvalId، ولا يرمي خطأ. التوقف يبقى عند الـ agent، فيعرضه agent.approvals.list() ويكمله resolve() دون registry أو provider.
  • الـ approval store الافتراضي خاص بكل agent ويعيش في الذاكرة. التوقف لا ينجو من restart إلا مع store أو approvalStore من نوع durable؛ راجع اختيار الـ store.
  • الـ retries مفعّلة افتراضيًا مع سلسلة model: محاولتان إضافيتان لاستدعاء model فاشل. الـ provider الذي تمرره لا يُغلَّف إلا إذا عيّنت retry. راجع إعادة المحاولة والبديل الاحتياطي عند الـ provider.

الانتقال خطوة بخطوة

  1. الـ tools أولًا. أبقِ الـ tools المعرفة بـdefineTool()، واحذف ToolRegistry وأي استدعاء addTool(key, config)، وعدّد الـ tools في tools.
  2. استبدل AgentBuilder بـcreateAgent({ name, instructions, tools })، ومرّر model أو الـ provider نفسه الذي كنت تمرره إلى execute().
  3. استبدل كل AgentExecutor.execute() بـagent.send() وكل stream() بـagent.stream(). انقل maxSteps وlimits وبقية الخيارات المشتركة إلى createAgent(). إذا احتاج استدعاء إلى خيار من قائمة «حتى الآن» فاتركه على الـ executor.
  4. استبدل resumeAfterApproval() بـagent.approvals.resolve(). إذا كان يجب أن تبقى الـ approvals بعد انتهاء العملية، مرّر الـ store الذي استخدمته كـapprovalStore.
  5. انقل checkpointStore وsessionId الخاص به إلى store، ومرّر sessionId إلى send(). واستخدم agent.session() بدل سجل الرسائل الذي كنت تحتفظ به بنفسك.
  6. استبدل onEvent مع ExecutionEvent بـAgentEvent listener، ثم انقل الـ hooks الموجودة في HookRegistry إلى hooks.