إضافة أدوات إلى عامل الذكاء الاصطناعي Azure
تلميح
راجع علامة التبويب النص والصور لمزيد من التفاصيل!
في Microsoft Agent Framework، تسمح الأدوات لوكيل الذكاء الاصطناعي باستخدام واجهات برمجة التطبيقات والخدمات الموجودة لأداء المهام التي لا يمكنه القيام بها بمفرده. تعمل الأدوات من خلال استدعاء الوظائف ، مما يسمح الذكاء الاصطناعي بطلب وظائف محددة واستخدامها تلقائيا. يقوم إطار العمل بتوجيه الطلب إلى الوظيفة المناسبة في قاعدة التعليمات البرمجية الخاصة بك ويعيد النتائج مرة أخرى إلى نموذج اللغة الكبيرة (LLM) حتى يتمكن من إنشاء استجابة نهائية.
لتمكين استدعاء الوظائف التلقائي، تحتاج الأدوات إلى توفير تفاصيل تصف كيفية عملها. يجب وصف مدخلات الوظيفة ومخرجاتها والغرض منها بطريقة يمكن الذكاء الاصطناعي فهمها ، وإلا فلن يتمكن الذكاء الاصطناعي من استدعاء الوظيفة بشكل صحيح.
كيفية استخدام الأدوات مع Microsoft Foundry Agent
يدعم Microsoft Agent Framework كلا من أدوات الوظائف المخصصة والأدوات المضمنة الجاهزة للاستخدام خارج الصندوق.
الأدوات المضمنة
تأتي Microsoft Foundry Agents مع عدة أدوات مدمجة يمكنك استخدامها فورا:
- Code Interpreter - ينفذ كود Python للحسابات وتحليل البيانات والمزيد
- البحث عن الملفات - البحث في المستندات وتحليلها
- البحث على الويب - يسترجع المعلومات من الإنترنت
تتوفر هذه الأدوات تلقائيا ولا تتطلب أي إعداد إضافي.
أدوات الوظائف المخصصة
عند إنشاء أدوات مخصصة لوكيل مايكروسوفت فاوندري الخاص بك، تحتاج إلى فهم عدة مفاهيم رئيسية:
استخدم أداة تزيين الأدوات
أنشئ أداة دالة مخصصة عن طريق تعريف دالة بايثون وتزيينها بأداة
@toolالديكور من إطار عمل وكلاء مايكروسوفت. يقوم هذا المصمم بتسجيل وظيفتك كأداة يمكن للذكاء الاصطناعي استدعاؤها. يتضمن المصمم@toolمعايير لتوفير اسم ووصف لأدتك، بالإضافةapproval_modeإلى تحديد ما إذا كانت استدعاءات الأدوات تتطلب الموافقة.تعريف الوظيفة والتعليقات التوضيحية
قم بإنشاء أداتك عن طريق تحديد وظيفة Python عادية مع التعليقات التوضيحية من النوع المناسب. استخدم
AnnotatedومنFieldPydantic لتقديم أوصاف مفصلة تساعد الذكاء الاصطناعي على فهم الغرض من الوظيفة وكيفية استخدام معلماتها. كلما كانت تعليقاتك التوضيحية أكثر وصفا ، كان بإمكان الذكاء الاصطناعي فهم متى وكيف تستدعي وظيفتك.إضافة أدوات إلى وكيلك
قم بتمرير وظائفك المخصصة إلى ChatAgent أثناء الإنشاء باستخدام المعلمة
tools. يمكنك إضافة دالة واحدة أو قائمة بوظائف متعددة. يقوم إطار العمل تلقائيا بتسجيل هذه الوظائف وإتاحتها للاتصال الذكاء الاصطناعي.استدعاء الأداة من خلال المحادثة
بمجرد تسجيل أدواتك لدى الوكيل، لن تحتاج إلى استدعاؤها يدويا. بدلا من ذلك ، اطرح أسئلة على الوكيل أو أعطه مهام تتطلب بشكل طبيعي وظائف أداتك. يحدد الذكاء الاصطناعي تلقائيا وقت استدعاء أدواتك بناء على سياق المحادثة وأوصاف الأداة التي قدمتها.
أدوات متعددة وتنسيق
يمكنك إضافة أدوات متعددة إلى وكيل واحد، ويختار الذكاء الاصطناعي تلقائيا الأداة التي تريد استخدامها بناء على طلب المستخدم. يتعامل إطار العمل مع التنسيق ، ويستدعي الوظائف المناسبة ويجمع بين نتائجها لتوفير استجابة شاملة.
أفضل الممارسات لتطوير الأدوات
- أوصاف واضحة: اكتب أوصافا واضحة ومفصلة لوظائفك ومعلماتك لمساعدة الذكاء الاصطناعي على فهم الغرض منها
- نوع التعليقات التوضيحية: استخدم تلميحات نوع Python المناسبة لتحديد أنواع الإدخال والمخرجات المتوقعة
- معالجة الأخطاء: قم بتنفيذ معالجة الأخطاء المناسبة في وظائف الأداة الخاصة بك للتعامل بأمان مع المدخلات غير المتوقعة
- إرجاع بيانات ذات مغزى: تأكد من أن وظائفك ترجع البيانات التي يمكن الذكاء الاصطناعي استخدامها بشكل فعال في استجاباته
- حافظ على تركيز الوظائف: صمم كل أداة للتعامل مع مهمة معينة بدلا من محاولة القيام بأشياء كثيرة جدا في وظيفة واحدة
باتباع هذه المفاهيم، يمكنك توسيع وكيل مايكروسوفت فاوندري الخاص بك بأدوات مدمجة ومخصصة، مما يسمح له بالتفاعل مع واجهات برمجة التطبيقات وأداء مهام متقدمة. يجعل هذا النهج الذكاء الاصطناعي الخاص بك أكثر قوة وقدرة على التعامل مع تطبيقات العالم الحقيقي بكفاءة.