Skip to main content
استخدم الأدوات عندما يحتاج الوكيل إلى قراءة بيانات التطبيق أو استدعاء خدمة داخلية أو تنفيذ إجراء. يتحقق Agent SDK من حدود الأدوات ويشغّل شيفرتها داخل تطبيقك.

تعريف أداة محلية

تقبل defineTool() وصفًا ومعلمات JSON اختيارية ومدققات وقت التشغيل ومهلة زمنية ودالة execute().
عند انتهاء المهلة، يوقف وقت التشغيل context.signal ويضع علامة فشل على التشغيل ثم يعيد طرح خطأ المهلة. يمكن أن تكون المخططات دوالًا أو كائنات تعرض parse() أو safeParse(). تفشل معلمات النموذج غير الصالحة ونتائج الأداة غير الصالحة قبل تجاوز حدود الأداة.

تنفيذ العمل في تطبيقك

اضبط execute: false عندما ينفّذ تطبيقك العمل بدلًا من عملية SDK. تابِع التشغيل المتوقف بإضافة النتيجة إلى toolOutputs. بالنسبة إلى أداة تفاعلية، أعد null من onToolCalled. بعد متابعة التشغيل، يمكن لـ onResponseReceived التحقق من الاستجابة المقدمة أو تحويلها.

عرض التقدم

يمكن لمولّد غير متزامن إرجاع نتائج أولية قبل إرجاع نتيجة نهائية واحدة:
يتوفر التقدم عبر أحداث tool.preliminary_result وpreliminaryResults الخاصة بالخطوة.

تشغيل الأدوات المستقلة بالتوازي

إذا أمكن لدور واحد من النموذج استدعاء عدة أدوات مستقلة بأمان، فاضبط حدًا للتزامن:
يحافظ وقت التشغيل على ترتيب رسائل نتائج الأدوات حتى عند تداخل عمليات التنفيذ المحلية.

أدلة ذات صلة

آخر تعديل في ٢ أكتوبر ٢٠٢٦