toolExecution.toolConcurrency كي يشغّل TypeScript Agent SDK عدة استدعاءات أدوات مستقلة من دور واحد للنموذج في الوقت نفسه بدلًا من تشغيلها واحدًا تلو الآخر. في النهاية يكون لديك وكيل يجمع سياق الوثائق والحالة والحوادث بالتوازي، ويسجّل النتائج مع ذلك بالترتيب الذي طلبها به النموذج.
تُرجع الأدوات بيانات عيّنة ثابتة، لذا فالسكربت توضيحي؛ استبدلها بعمليات بحث خاصة بك للقراءة فقط. توجد نسخة جاهزة في packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts.
أنشئه
1
التثبيت
2
اكتب الوكيل
parallel-agent.ts
3
شغّله
تحقّق من نجاحه
- عندما يطلب النموذج الأدوات الثلاث في دور واحد، تُطبع أسطر
tool.startedالثلاثة قبل أسطرtool.completedالمقابلة، مع طوابع زمنية متقاربة. - تسرد
result.messagesنتائج الأدوات بترتيب استدعاءات النموذج للأدوات، أيًا كان ترتيب انتهائها. - ينتهي التشغيل بملخص واحد في
result.output.
ما الذي يعمل معًا
لا تزال
tool.started وtool.completed تُطلقان لكل استدعاء، ويحفظ التشغيل نقطة تحقق بعد انتهاء مرحلة الأدوات.
حافظ على أمانه
استخدم التزامن فقط للأدوات التي لا تعتمد على مخرجات بعضها ولا تغيّر حالة مشتركة. ابدأ بـ2 أو 3، واجعل الأدوات متساوية القوى (idempotent) وقليلة الآثار الجانبية، وتحقّق من كل وسيط باستخدام inputSchema كما في الأعلى. أضف موصّل state، كما في حلقة الوكيل المستدامة، فقط عندما تحتاج إلى استئناف التشغيلات. قبل الاعتماد عليه، شغّل اختباراتك التي تغطي الأدوار متعددة الأدوات وتحقّق من ترتيب النتائج.