trustgraph/docs/tech-specs/tool-services.ar.md
Jenkins, Kenneth Alexander 6ff883acee
init translations
Signed-off-by: Jenkins, Kenneth Alexander <kjenkins60@gatech.edu>
2026-04-04 18:04:39 -04:00

6.3 KiB

تعليمات مهمة:

  • احتفظ بجميع التنسيقات (العناوين، الروابط، علامات HTML) بشكل صحيح.
  • لا تترجم أي شي داخل علامات backticks أو كتل التعليمات البرمجية.
  • قم بإخراج النص المترجم فقط، بدون أي مقدمة أو تفسيرات.

النص المراد ترجمته:

خدمات الأداة: أدوات الوكلاء القابلة للتوصيل ديناميكيًا

الحالة

مُنفَّذ

نظرة عامة

يحدد هذا المواصفق آلية لأدوات الوكلاء القابلة للتوصيل ديناميكيًا تسمى "خدمات الأدوات". على عكس أنواع الأدوات المدمجة الموجودة (KnowledgeService, McPTool), لا تتطلب هذه الطريقة إعداد مسبق.

مفاهيم أساسية

  • خدمات الأدوات: مكونات قابلة للتوصيل ديناميكيًا يمكن للوكيل استدعائها.
  • الوكيل: التطبيق الذي يستخدم خدمات الأدوات.
  • موضوع الرسائل: قناة اتصال بين الوكيل وخدمة الأدوات.

التصميم

يعمل نظام خدمات الأدوات على مبدأ "الطلب والاستجابة". يقوم الوكيل بإنشاء طلب (رسالة) إلى خدمة الأدوات، وتقوم خدمة الأدوات بمعالجة الطلب وإرجاع استجابة (رسالة) إلى الوكيل.

بنية الطلب والاستجابة

تستخدم خدمات الأدوات تنسيق رسائل بسيط وموحد لتبادل البيانات بين الوكيل وخدمة الأدوات. تتكون كل رسالة من جزئين:

  • الطلب: يحتوي على بيانات الإدخال المطلوبة لخدمة الأدوات.
  • الاستجابة: تحتوي على نتيجة معالجة الطلب من قبل خدمة الأدوات.

مثال

لنفترض أن الوكيل يريد معرفة الطقس في مدينة معينة. يمكن للوكيل إنشاء طلب يحتوي على اسم المدينة وإرساله إلى خدمة الطقس. تتلقى خدمة الطقس الطلب، وتحقق من بيانات الطقس، وترسل استجابة تحتوي على معلومات الطقس إلى الوكيل.

تنفيذ

يتم تنفيذ خدمات الأدوات كعمليات متزامنة. تسمح هذه الطريقة لخدمات الأدوات بالاستجابة بسرعة لطلبات الوكيل.

أمثلة

  • خدمة الطقس: تتلقى طلبًا يحتوي على اسم المدينة وترجع معلومات الطقس.
  • محرك البحث: يتلقى طلبًا يحتوي على عبارة بحث ويرجع قائمة بالنتائج.

مزايا

  • مرونة: يمكن إضافة خدمات أدوات جديدة دون تعديل الوكيل.
  • قابلية التوسع: يمكن للوكيل استخدام العديد من خدمات الأدوات في وقت واحد.
  • سهولة الصيانة: يمكن تحديث خدمات الأدوات بشكل مستقل عن الوكيل.

الاعتبارات

  • يجب أن تكون خدمات الأدوات مصممة لتكون خفيفة الوزن وفعالة.
  • يجب أن تكون خدمات الأدوات قادرة على التعامل مع طلبات متعددة من وكلاء مختلفين.
  • يجب أن تكون خدمات الأدوات آمنة وموثوقة.

مثال

لنفترض أن الوكيل يريد البحث عن معلومات حول موضوع معين. يمكن للوكيل إنشاء طلب يحتوي على عبارة البحث وإرساله إلى محرك البحث. يتلقى محرك البحث الطلب، ويقوم بإجراء البحث، ويرجع قائمة بالنتائج إلى الوكيل.

الوحدة (Module)

يتم تنظيم نظام خدمات الأدوات في وحدات (modules). كل وحدة مسؤولة عن تنفيذ وظيفة معينة. على سبيل المثال، قد يكون هناك وحدة للطقس ومحرك بحث ووحدة للتحقق من صحة البيانات.

واجهات برمجة التطبيقات (APIs)

توفر وحدات خدمات الأدوات واجهات برمجة تطبيقات (APIs) للوكلاء للتفاعل معها. تتضمن هذه الواجهات ما يلي:

  • واجهة طلب: تحدد تنسيق الرسائل المستخدمة لإنشاء طلبات.
  • واجهة استجابة: تحدد تنسيق الرسائل المستخدمة لتلقي الاستجابات.

الأمان

يتم تأمين نظام خدمات الأدوات باستخدام آليات الأمان القياسية. تتضمن هذه الآليات ما يلي:

  • التحقق من الهوية: التحقق من هوية الوكيل قبل السماح له بالوصول إلى خدمات الأدوات.
  • الترخيص: تحديد صلاحيات الوصول التي يتمتع بها كل وكيل.
  • التشفير: تشفير جميع البيانات المرسلة بين الوكيل وخدمات الأدوات.

التوثيق

يتم توثيق نظام خدمات الأدوات بشكل كامل. يتضمن التوثيق ما يلي:

  • وصف للواجهات: وصف لواجهات برمجة التطبيقات (APIs) المتاحة.
  • أمثلة التعليمات البرمجية: أمثلة للتعليمات البرمجية توضح كيفية استخدام خدمات الأدوات.
  • دليل المستخدم: دليل المستخدم الذي يشرح كيفية استخدام نظام خدمات الأدوات.

الإصدارات المستقبلية

  • التعلم الآلي: يمكن استخدام التعلم الآلي لتحسين أداء خدمات الأدوات.
  • الذكاء الاصطناعي: يمكن استخدام الذكاء الاصطناعي لتمكين خدمات الأدوات من أداء مهام أكثر تعقيدًا.
  • الأمن: يمكن تحسين أمان نظام خدمات الأدوات باستخدام تقنيات أمان جديدة.