يشرح هذا الدليل كيفية إنشاء أدوات الذكاء الاصطناعي المخصصة وتكوينها ودمجها ضمن إضافة Discourse AI، مما يمكّن المسؤولين من توسيع قدرات الروبوت باستخدام دوال JavaScript التي يحددها المستخدم.
مستوى المستخدم المطلوب: مسؤول
الأدوات هي وظائف قابلة للبرمجة يمكن لروبوت الذكاء الاصطناعي استخدامها لأداء مهام محددة أو استرداد معلومات تتجاوز مجرد الاستجابات النصية. هذه الأدوات هي نصوص برمجية أو تكاملات تسمح للروبوت بالتفاعل مع واجهات برمجة التطبيقات الخارجية، أو معالجة البيانات، أو تنفيذ وظائف إضافية لتوسيع قدراته.
ملخص
تغطي هذه الوثائق:
- إنشاء أداة ذكاء اصطناعي مخصصة جديدة
- تكوين معلمات وأكواد الأدوات
- واجهات برمجة التطبيقات المتاحة لأكواد الأدوات
- دمج الأدوات المخصصة مع شخصيات الذكاء الاصطناعي
- اختبار الأدوات المخصصة واستكشاف الأخطاء وإصلاحها
إنشاء أداة ذكاء اصطناعي مخصصة جديدة
لإنشاء أداة ذكاء اصطناعي جديدة:
- انتقل إلى لوحة تحكم المسؤول > الإضافات > Discourse AI > الأدوات
- انقر فوق “أداة جديدة” (يمكنك استخدام الإعدادات المسبقة الموجودة لمعرفة الخيارات)
- املأ الحقول التالية:
- الاسم: اسم الأداة كما يتم تقديمه إلى LLM
- الوصف: وصف الأداة كما يتم تقديمه إلى LLM
- الملخص: ملخص لما تفعله الأداة لمساعدة المستخدمين (يتم عرضه في التفاصيل)
- المعلمات: حدد المدخلات التي تحتاجها أداتك كما يتم تقديمها إلى LLM
- النص البرمجي: كود JavaScript الذي يشغل أداتك
- انقر فوق “حفظ”
تكوين أكواد الأدوات
واجهات برمجة التطبيقات المتاحة
تتمتع أكواد أدواتك بالوصول إلى واجهات برمجة التطبيقات التالية:
-
طلبات HTTP:
http.get(url, options) http.post(url, options)استخدم هذه للتفاعل مع الخدمات الخارجية. يمكنك استخدام
optionsلتحديد رؤوس HTTP:http.get(url, { headers: { Auth: "some value" } }) http.post(url, { headers: { Auth: "some value", body: "some body" } }) http.patch(url, { headers: { Auth: "some value", body: "some body" } }) http.delete(url, { headers: ...}) http.put(url, { headers: ... , body: ...}) -
تكامل LLM (نموذج اللغة):
llm.truncate(text, length)يسمح لك هذا بمعالجة النص ضمن حدود رموز نموذج الذكاء الاصطناعي.
-
تكامل التحميل المخصص (RAG)
index.search(query, { filenames: options, limit: max_fragments_optional }) -
دعم إنشاء التحميل
upload.create(filename, base_64_content) -
التحكم في سلسلة التنفيذ
chain.setCustomRaw(raw) - يحدد جسم الطلب في السلسلة.
الدوال المطلوبة
يجب أن ينفذ النص البرمجي الخاص بك:
invoke(params): الدالة الرئيسية التي يتم تنفيذها عند استدعاء الأداة
قد ينفذ اختياريًا:
details(): (اختياري) يوفر معلومات إضافية حول تنفيذ الأداة
مثال على النص البرمجي:
function invoke(params) {
let result = http.get("https://api.example.com/data?query=" + params.query);
return JSON.parse(result.body);
}
function details() {
return "Fetched data from Example API";
}
القيود والأمان
- مهلة التنفيذ: الأدوات لديها مهلة افتراضية تبلغ ثانيتين
- طلبات HTTP: بحد أقصى 20 طلبًا لكل تنفيذ أداة
- بيئة معزولة: لا يوجد وصول إلى نظام ملفات الخادم أو مكتبات Ruby
اختبار أداتك
يجب عليك اختبار أي أداة تبنيها للتأكد من أن النتائج التي سيتم تقديمها إلى LLM تتوافق مع توقعاتك.
دمج الأدوات مع شخصيات الذكاء الاصطناعي
لإضافة أداتك المخصصة إلى شخصية ذكاء اصطناعي:
- انتقل إلى لوحة تحكم المسؤول > الإضافات > Discourse AI > الشخصيات
- قم بتحرير شخصية موجودة أو أنشئ شخصية جديدة
- في قسم “الأدوات”، سترى أدواتك المخصصة مدرجة جنبًا إلى جنب مع الأدوات المضمنة
- حدد أداتك المخصصة لإضافتها إلى الشخصية
أدوات مخصصة قيد العمل
بمجرد تزويد LLM بالأداة المخصصة، يمكنه استخدامها لتعزيز المحادثة.
استكشاف الأخطاء وإصلاحها
إذا لم تعمل أداتك كما هو متوقع:
- استخدم واجهة الاختبار للتأكد من أنها تتصرف كما هو متوقع لمدخلاتك.
- تأكد من أن مجموعتك موجودة في
ai_bot_debugging_allowed_groups. يتمتع أعضاء هذه المجموعة بوصول كامل إلى نصوص الروبوت؛ يمكنك عرض سجلات الذكاء الاصطناعي هناك. - إذا كان هناك أي شيء غير متوقع يحدث، قم بزيارة
https://SITENAME/logsللتحقق من وجود أخطاء.
