الأدوات المحلية
استخدم Tool::new(...) عندما تستطيع عملية Rust تنفيذ العملية:
تُرسل قيمة parameters إلى النموذج بصيغة JSON Schema. تكون مدخلات الأدوات ومخرجاتها من النوع serde_json::Value. تحقّق من الوسائط غير الموثوقة داخل المنفّذ إذا كنت بحاجة إلى ضمانات أقوى أثناء التشغيل.
الأدوات التي تتطلب موافقة
أضف require_approval() لإيقاف التنفيذ مؤقتًا قبل إجراء العملية:
عندما يستدعي النموذج هذه الأداة، تعود الجولة بالقيمتين run.status == "waiting_for_human" وrun.pause.kind == "tool_approval".
استأنف الجولة باستخدام معرّف الاستدعاء نفسه تمامًا:
لا توفّر واجهة Rust 0.1 نوعًا منفصلًا للرفض. اترك الاستدعاء غير الموافق عليه في حالة إيقاف مؤقت أو طبّق سياسة الرفض الخاصة بتطبيقك قبل الاستئناف.
الأدوات الخارجية
استخدم Tool::external(...) عندما تنفّذ عملية أخرى العملية المطلوبة:
يكون نوع الإيقاف المؤقت external_output عندما يحتاج كل استدعاء معلّق إلى نتيجة خارجية. قدّم كل نتيجة باستخدام معرّف الاستدعاء:
إذا جمعت جولة واحدة للنموذج بين أدوات تلقائية واستدعاءات معلّقة، تنفّذ بيئة التشغيل الأدوات التلقائية قبل إعادة حالة الإيقاف المؤقت.
أخطاء الأدوات
يتحوّل خطأ AgentError الذي يعيده منفّذ محلي إلى رسالة خطأ منظّمة للأداة ثم يُرسل إلى النموذج. ويؤدي اسم أداة غير معروف أو غياب الموافقة أو المخرجات المطلوبة إلى فشل الاستئناف مع AgentError.
محتوى ذو صلة
آخر تعديل في ٢ أكتوبر ٢٠٢٦