createAgent() هي نقطة الدخول الموصى بها (راجع البدء السريع). هذه الصفحة للكود الذي يحتاج الخيارات الأدنى مستوى التي لا تأخذها createAgent(). ولنقل كود executor موجود إلى createAgent()، راجع الانتقال إلى createAgent().
AgentBuilder وAgentExecutor
createAgent() مجرد wrapper بسيط فوق AgentBuilder والـ static AgentExecutor.execute(). استخدمهما مباشرة فقط لما لا تقبله createAgent(): temperature وmaxTokens (exporter وcaptureContent وredactContent خيارات في createAgent() أيضًا). وcreateAgent() تأخذ أصلًا maxSteps وlimits وonEvent وapprovals وstore (checkpoints) وhooks وcompaction. AgentExecutor واجهة static، أي لا يوجد new AgentExecutor().
مشاركة الـ tools عبر ToolRegistry
متقدم: ToolRegistry. لمشاركة tools بين عدة agents أو لتسجيل ToolDescriptor خام، استخدم registry.register(tool) إذا كان الـ tool معرَّفًا، أو registry.register(name, descriptor) إذا كان لديك descriptor. ثم مرّر الـ registry كـ toolRegistry إلى AgentExecutor.execute(). راجع Tools لمثال كامل.
خيارات AgentExecutor.execute()
AgentExecutor static: استدعِ AgentExecutor.execute(options). المطلوب فقط agent وinput وprovider. وأكثر الخيارات استخدامًا:
الاستدعاء يُرجع نتيجة من نوع
ExecutionResult: { text, reasoning?, messages, toolCalls, usage, stepUsage?, finishReason, steps, approvalId?, object?, outputError?, backgroundTasks?, budget?, guardrail?, agentName? }.