إنشاء وإدارة وكلاء Foundry في كود Visual Studio (الكلاسيكي)

ينطبق فقط على:بوابة Foundry (كلاسيكية). هذه المقالة غير متاحة لبوابة Foundry الجديدة. تعرف على المزيد حول البوابة الجديدة.

‏‫ملاحظة‬

بعض الروابط في هذا المقال قد تفتح محتوى في وثائق Microsoft Foundry الجديدة بدلا من وثائق Foundry (الكلاسيكية) التي تشاهدها الآن.

‏‫ملاحظة‬

تشير هذه الوثيقة إلى النسخة الكلاسيكية من واجهة برمجة تطبيقات الوكيل.

تتيح لك خدمة Foundry Agent بناء وتكوين ونشر الوكلاء دون مغادرة Visual Studio Code (VS Code). في هذا المقال، تقوم بإنشاء وكيل باستخدام المصمم، وإضافة الأدوات، واختبار الوكيل في ساحة اللعب، وتوليد نموذج كود، وتنظيف الموارد عند الانتهاء.

المتطلبات المسبقه

• اشتراك Azure. أنشئ حسابًا مجانًا.
• الوصول إلى خدمة وكلاء المساند.
• تم تثبيتVisual Studio Code.
• تم تثبيت وتسجيل دخول إضافة Microsoft Foundry for VS Code .
• نموذج منشور في مشروعك.

أنشئ وكيلا في المصمم

يوفر المصمم واجهة بصرية لتكوين اسم وكيلك ونموذجه وتعليماته وأدواته.

1. سجل الدخول إلى موارد Azure الخاصة بك.

2. قم بتعيين مشروعك الافتراضي.

3. في عرض Foundry Extension ، ابحث عن قسم الكلاسيكي في قسم الموارد .

4. اختر أيقونة زائد (+) بجانب قسم الوكلاء الكلاسيكيين لإنشاء وكيل جديد.

تكوين الوكيل في المصمم

بعد اختيار موقع الحفظ، يفتح ملف .yaml الوكيل وعرض المصمم. قم بتكوين الإعدادات التالية:

1. في المطالبة، أدخل اسما لوكيلك.

2. في القائمة المنسدلة، حدد اسم نشر النموذج الخاص بك. اسم التوزيع هو ما اخترته عند نشر نموذج موجود.

3. ينشئ الملحق قيمة المعرف . قم بتكوين الحقول التالية:

   • أضف وصفا لوكيلك.
   • قم بتعيين تعليمات النظام.
   • تكوين أدوات لاستخدام الوكيل.

4. لحفظ ملف .yaml، حدد حفظ الملفات> في شريط القائمة VS Code.

راجع تعريف YAML للوكيل

يفتح ملف .yaml بجانب المصمم ويحتوي على تفاصيل التكوين لوكيل التأمين الخاص بك. التنسيق مشابه للمثال التالي:

# yaml-language-server: $schema=https://aka.ms/ai-foundry-vsc/agent/1.0.0
version: 1.0.0
name: my-agent
description: Description of the agent
id: ''
metadata:
  authors:
    - author1
    - author2
  tags:
    - tag1
    - tag2
model:
  id: 'gpt-4o-1'
  options:
    temperature: 1
    top_p: 1
instructions: Instructions for the agent
tools: []

أضف أدوات إلى الوكيل

توفر خدمة الوكيل الأدوات التالية لتوسيع قدرات وكيلك والاتصال بمصادر بياناتك:

• الترضية باستخدام بحث Bing
• البحث في الملفات
• مترجم التعليمات البرمجية
• أدوات محددة من OpenAPI
• بروتوكول سياق النموذج (MCP)

لمزيد من المعلومات حول استخدام أدوات MCP، راجع أدوات خدمة العمل مع الوكيل وأدوات خادم MCP في كود Visual Studio (المعاينة).

أضف أداة إلى الوكيل

1. في المصمم، في الزاوية العلوية اليمنى من القسم TOOL ، حدد Add tool. في القائمة المنسدلة، حدد الأداة التي تريد إضافتها.

   

2. يعرض المصمم الجزء المناسب لتكوين الأداة، كما هو موضح في الصور التالية:

   • التأريض مع بحث Bing:

     

   • البحث عن الملفات:

     

   • مترجم الكود:

     

   • أدوات محددة ل OpenAPI 3.0:

     

3. بعد إدخال المعلومات المطلوبة، حدد إنشاء واتصال، أو تحميل وحفظ، أو إنشاء أداة. يختلف تسمية الزر حسب نوع الأداة.

   بعد إنشاء الأداة، تظهر في قسم الأدوات في المصمم.

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

نشر العميل إلى المصنع

بعد الانتهاء من تكوين وكيلك، قم بنشره في Foundry ليعمل في السحابة.

1. في المصمم، اختر زر إنشاء وكيل في مايكروسوفت فاوندري .

2. في VS Code، قم بتحديث عرض الموارد . يظهر الوكيل المنشور في قسم العملاء الكلاسيكيين .

عرض تفاصيل الوكيل المنشور

اختر وكيلا منتشرا لفتح لوحة تفضيلات الوكيل في وضع العرض فقط. من هذا اللوحة، يمكنك:

• اختر وكيل تحرير لفتح مصمم الوكيل وتعريف .yaml للتحرير.
• اختر عرض الكود لإنشاء ملف كود نموذجي يستخدم الوكيل.
• اختر Open Playground لفتح ملعب الوكلاء عن بعد.

تحديث وكيل تم نشره

يمكنك تعديل إعدادات الوكيل المنشور ومزامنة التغييرات مع Foundry.

1. في لوحة تفضيلات الوكيل ، اختر تعديل الوكيل. يفتح مصمم الوكيل بملف .yaml الخاص بالوكيل.

2. قم بتحرير تكوين العامل، مثل النموذج والأدوات والإرشادات.

3. اختر زر وكيل التحديث في مايكروسوفت فاوندري لحفظ التغييرات. يدخل التكوين المحدث حيز التنفيذ فورا.

إنشاء ملف كود نموذجي

يقوم الامتداد بتوليد كود نمائي للتفاعل مع وكيل النشر بشكل برمجي.

1. انقر بزر الفأرة الأيمن على وكيل النشر الخاص بك، ثم اختر عرض الكود. أو، في لوحة تفضيلات الوكيل ، اختر زر عرض الكود .

2. في قائمة اختيار حزمة تطوير البرمجيات المفضلة لديك ، اختر مجموعة تطوير البرمجيات الخاصة بك.

3. في قائمة اختيار لغة ، اختر لغتك.

4. في قائمة اختيار طريقة التحقق المنسدلة، اختر طريقة المصادقة الخاصة بك.

تقوم الإضافة بإنشاء ملف كود بلغتك المختارة وفتحه في المحرر.

راجع ملف الكود النموذجي

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

اختبر العميل في ساحة اللعب

استخدم الملعب لإرسال رسائل إلى وكيل النشر والتحقق من سلوكه.

1. انقر بزر الفأرة الأيمن على وكيل النشر الخاص بك، ثم اختر فتح ملعب اللعب.

   بدلا من ذلك، اختر رابط ملعب الوكلاء البعيد في قسم الأدوات ، ثم اختر نوع الوكيل الخاص بك، ثم اختر وكيلك من القوائم المنسدلة.

   يفتح جزء ملعب الوكلاء البعيد ويبدأ موضوعا مع وكيلك.

2. أدخل مطالبتك واعرض المخرجات.

   يستخدم هذا المثال تأريض Bing لتوضيح بحث ويب عن المعلومات. يستخدم العامل النموذج والأدوات التي قمت بتكوينها في مصمم العامل. يظهر مصدر المعلومات في قسم التعليقات التوضيحية للوكيل.

   

عرض خيوط الوكلاء

يعرض قسم Threads الفرعي خيوط المحادثات التي تم إنشاؤها أثناء التشغيل مع وكيلك. في قسم الكلاسيكي تحت عرض الموارد ، وسع قسم الخيوط لعرض القائمة.

‏‫ملاحظة‬

سلسلة المحادثات هي جلسة محادثة بين مندوب ومستخدم. تخزن سلاسل المحادثات الرسائل وتتعامل مع الاقتطاع تلقائيا لاحتواء المحتوى في سياق النموذج. الرسالة هي تفاعل واحد يمكن أن يشمل نصوصا وصورا وملفات أخرى. التشغيل هو تنفيذ واحد لوكيل يمكنه الامتداد عبر عدة خيوط ورسائل.

عرض تفاصيل مؤشر الترابط

لعرض لوحة تفاصيل الخيط ، اختر خيطا من القائمة.

عرض تفاصيل التشغيل

لعرض معلومات التشغيل، اختر زر عرض معلومات التشغيل في لوحة تفاصيل الخيط . يفتتح ملف .json بتفاصيل التشغيل، بما في ذلك تكوين الوكيل، والرسائل، واستدعاءات الأدوات.

تنظيف الموارد

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

حذف وكلائك

نصيحة

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

1. في VS Code، قم بتحديث طريقة عرض Azure Resources .
2. قم بتوسيع قسم الوكلاء لعرض قائمة الوكلاء المنتشرين.
3. انقر بزر الفأرة الأيمن على الوكيل الذي تريد حذفه، ثم اختر حذف.

حذف النماذج الخاصة بك

1. في VS Code، قم بتحديث عرض الموارد . قم بتوسيع القسم الفرعي Models لعرض قائمة النماذج المنشورة.

2. انقر بزر الفأرة الأيمن على النموذج الذي تريد حذفه، ثم اختر حذف.

حذف أدواتك المتصلة

1. افتح مدخل Azure.

2. اذهب إلى مجموعة الموارد التي تحتوي على مورد الأدوات.

3. اختر المصدر، ثم اختر حذف.

المحتوى ذو الصلة

• اعمل مع أدوات خدمة الوكلاء وخوادم MCP في كود Visual Studio (معاينة) لإضافة أدوات MCP إلى وكلائك.
• نظرة عامة على أدوات الوكيل لتفاصيل البحث عن الملفات، مفسر الكود، والأدوات المتاحة الأخرى.
• نظرة عامة على خدمة وكلاء المسبك للحصول على نظرة أعمق على مفاهيم وقدرات الوكلاء.