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