إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تمتد دورة تطوير الوكيل في Microsoft Foundry من الإنشاء الأولي حتى مراقبة الإنتاج. في جوهر كل وكيل يوجد نموذج من كتالوج نماذج Foundry يدفع توليد التفكير والاستجابة. اتباع هذه الدورة يساعدك على بناء وكلاء موثوقين، واكتشاف المشكلات مبكرا، والشحن بثقة. استخدم بوابة أو كود Foundry لبناء وتخصيص واختبار سلوك وكيلك. ثم قم بالتكرار من خلال التتبع، والتقييم، والمراقبة لتحسين الجودة والموثوقية. عندما تكون مستعدا، انشر وكيلك كتطبيق وكيل لمشاركته ودمجه في تطبيقاتك.
هذه المقالة موجهة للمطورين الذين يرغبون في بناء واختبار وشحن وكلاء جاهزين للإنتاج.
المتطلبات الأساسية
- مشروع Microsoft Foundry
- الألفة مع ملعب العملاء
- لتطوير الكود: الإلمام بإعداد بيئة التطوير
دورة الحياة من نظرة سريعة
استخدم هذه الدورة كقائمة تحقق عملية أثناء بناء وشحن وكيل.
- اختر نوع الوكيل: ابدأ بوكيل يعتمد على الأوامر أو بوكيل مستضاف.
- أنشئ وكيل عملك وابدأ الاختبار: كرر في الملعب أو بالشيفرة.
- أضف الأدوات والبيانات: أرفق أدوات للاسترجاع والإجراءات، وتحقق من التكوين قبل الحفظ.
- احفظ التغييرات كإصدارات: التقط معالم ذات معنى وقارن الإصدارات.
- التصحيح باستخدام التتبع: استخدم التتبع لتأكيد استدعاءات الأدوات، والتأخير، والسلوك من طرف إلى طرف. للتفاصيل، راجع نظرة عامة على تتبع العملاء.
- تقييم الجودة والسلامة: قم بإجراء تقييمات متكررة لرصد الانحدارات قبل النشر. للحصول على إرشادات مفاهيمية، انظر مقيمو الوكلاء.
- تحسين الوكلاء المستضافين (معاينة): قم تلقائيا بتحسين تعليمات الوكيل المستضاف واكتشاف المهارات باستخدام محسن الوكلاء.
- انشر ودمج: انشر نقطة نهاية مستقرة ودمجها في تطبيقك. للخطوات، راجع تطبيقات الوكيل في Microsoft Foundry.
- راقب وتكرار: راقب الأداء والجودة في الإنتاج، ثم قم بتحديث وإعادة النشر حسب الحاجة. للحصول على التوجيه، راجع مراقبة الوكلاء.
أنواع الوكلاء في Microsoft Foundry
هناك نوعان من الوكلاء:
القائم على الطلبات: الوكيل القائم على الأوامر هو وكيل واحد معرف بشكل إعلاني يجمع بين نموذج فاوندري، والتعليمات، والأدوات، ومحفزات اللغة الطبيعية لتحريك السلوك. وسعها بإرفاق أدوات للمعرفة والذاكرة. تحرير وإصدار واختبار وتقييم ومراقبة ونشر الوكلاء المعتمدين على الأوامر من ساحة الوكلاء في بوابة Foundry.
المستضافة: الوكلاء المستضافون هم وكلاء محوسبون في حاويات تقوم ببناءهم في الكود باستخدام أطر عمل مدعومة أو كود مخصص. تقوم خدمة وكلاء الصابك بنشر وإدارة هذه الوكلاء. لا تقوم بتحرير الوكلاء المستضافين في واجهة بناء الوكلاء، لكن لا يزال بإمكانك استدعاءهم، تقييمهم، مراقبتهم ونشرهم. لمزيد من التفاصيل، راجع ما هم الوكلاء المستضافون؟
أنشئ وكلاء معتمدين على الأوامر في بوابة Foundry أو في بيئة تطويرك الخاصة باستخدام واجهة برمجة تطبيقات CLI أو SDK أو REST. لمزيد من المعلومات، راجع البدء السريع.
إنشاء وكيل قائم على التعليمات
إذا كنت تعرف بالفعل نوع الوكيل الذي تريد إنشاؤه، قم بتسميته ثم ابدأ بتكوين تعليمات وأدواته في النموذج.
ملاحظة
بعد أن تسمي وكيلك، لا يمكنك تغيير الاسم. في الرمز، تشير إلى وكيلك ب <agent_name>:<version>.
تطوير الوكلاء في الكود
إذا كنت تفضل العمل في الكود، استخدم طرقا مدعومة لجلب كود الوكيل إلى بيئة تطوير يمكنك من خلالها اختبارها محليا ثم نشرها على Azure.
من تبويب Code في نافذة الدردشة الخاصة بملعب الوكلاء، يمكنك أخذ مقتطف كود يشير إلى تعليمة Visual Studio برمجية مخصص لبيئة سحابة الويب. يأتي المقتطف معدا مسبقا مع الحزم والإضافات التي تحتاجها، مع تعليمات لتطوير ونشر وكيل Foundry الخاص بك بكفاءة على Azure. يمكنك أيضا نسخ مقتطف الكود مباشرة إلى بيئة التطوير المفضلة لديك. للمزيد من التفاصيل، راجع وثائق الملعب.
القدرات الأساسية لدورة حياة تطوير الوكيل
تقدم تجربة بناء الوكيل تجارب متكاملة لكل خطوة أساسية من دورة حياة تطوير الوكيل. استخدم هذه القدرات الأساسية أثناء تطوير تطبيق وكيل جاهز للإنتاج. كل قدرة تحتوي على توثيق مفصل يمكنك من خلاله معرفة المزيد.
احفظ التغييرات كإصدارات
بعد إنشاء النسخة الأولى من وكيل يعتمد على الطلبات، احفظ التغييرات التالية كإصدارات جديدة. يمكنك اختبار التغييرات غير المحفوظة في ملعب الوكلاء. ولكن إذا كنت ترغب في عرض سجل المحادثات، أو مراقبة أداء وكيلك، أو إجراء تقييمات كاملة، عليك حفظ التغييرات.
يوفر إصدار الوكيل القدرات التالية لإدارة تكوينات وتكرارات الوكلاء. يضمن هذا النظام تتبع جميع التغييرات وقابلية الاختبار والمقارنة بين الإصدارات.
ثبات الإصدار: كل نسخة من الوكيل تصبح غير قابلة للتغيير بعد حفظها. أي تعديلات على نسخة موجودة تتطلب حفظا وإنشاء نسخة جديدة. يساعد هذا الشرط في ضمان سلامة الإصدار ويمنع الكتابة غير المقصودة.
إدارة الحالة المسودة: يمكنك اختبار الوكلاء في حالة غير محفوظة للتجارب. ستفقد تغييرات غير محفوظة إذا غادرت بوابة Foundry، لذا احفظ باستمرار للحفاظ على التعديلات المهمة.
عمليات التحكم في الإصدارات: يمكنك توجيه الطلبات إلى إصدارات وكيل محددة لتمكين النشر المتحكم به وقدرات التراجع عن الإصدار.
التنقل في تاريخ الإصدارات: الوصول إلى سجل الإصدارات لأي وكيل، اذهب إلى أي إصدار محدد، وقم بإجراء المقارنات التالية:
نوع المقارنة الوصف إعداد الوكيل قارن إعدادات التكوين بين الإصدارات باستخدام قائمة الإصدارات المنسدلة إخراج الدردشة تحليل اختلافات الاستجابة بين إصدارات الوكيل باستخدام مدخلات متطابقة تعريف YAML الاختلافات في تعريفات الوكلاء في المراجعة
عوامل مرجعية ذات نمط ثابت أو نمط الحصول على أو إنشاء
في التعليمات البرمجية، يمكنك الرجوع إلى عامل بواسطة <agent_name>:<version>. إنشاء كل عامل مرة واحدة، ثم الاستمرار وإعادة استخدام هذا المعرف عبر جلسات العمل والعمليات.
- أنشئ مرة واحدة، أعد استخدام المعرف. ذاكرة التخزين المؤقت لاسم العامل أو معرف التطبيق الخاص بك يعتمد على. لا تقم بإعادة إنشائه على كل تشغيل.
- تعامل مع 404 كمحطة طرفية.
GETإذا تم إرجاع404 Not Foundاستدعاء أو تشغيله أو استخدامه لمعرف قمت بإنشائه مسبقا، فقد تم حذف العامل. أعد إنشائه. لا تقم بإعادة محاولة نفس المعرف في حلقة. - يفضل الحصول على أو إنشاء. عند بدء التشغيل، ابحث عن العامل بالاسم وقم بإنشائه فقط إذا كان البحث يرجع 404. يحتفظ هذا الأسلوب بمعرف ثابت واحد ويتجنب التكرارات المعزولة.
إضافة الأدوات
اجعل وكيلك أكثر قوة من خلال منحه معرفة (ملفات أو فهارس محددة) أو بالسماح له باتخاذ إجراءات (استدعاء واجهات برمجة التطبيقات الخارجية). تتوفر أدوات لمعظم حالات الاستخدام، من رفع الملفات البسيطة إلى اتصالات الخوادم المخصصة لبروتوكول سياق النموذج (MCP). بالنسبة للأدوات الأكثر تعقيدا، قد تحتاج إلى تكوين المصادقة أو إضافة الاتصالات كجزء من ربطها بوكيل.
لإنقاذ وكيل مع أداة مرفقة، يجب عليك تكوين الأداة بنجاح. أعد استخدام الأدوات المكونة عبر الوكلاء. للحصول على معلومات حول الأدوات المتاحة، راجع كتالوج الأدوات.
تصحيح الأخطاء والتحقق باستخدام التتبع (المعاينة)
أثناء إضافة الأدوات وتكرار المحفزات، استخدم التتبع للتحقق من السلوك من طرف إلى طرف:
- تأكد مما إذا كان الوكيل قد اتصل بالأدوات التي توقعتها.
- افحص مدخلات ومخرجات الأدوات.
- حدد نقاط التأخير عبر استدعاءات النماذج والأدوات.
لمزيد من المعلومات، راجع نظرة عامة على تتبع العملاء.
تقييم الجودة والسلامة (معاينة)
قبل نشر وكيلك (وبعد أي تغيير ذي معنى)، قم بإجراء تقييمات لرصد الانحدارات وقياس الجودة باستمرار عبر الإصدارات.
- للاطلاع على أبعاد التقييم الرئيسية للوكلاء، انظر مقيمو الوكلاء.
- لسير عمل يعتمد على البرمجة أولا يمكنك أتمتته، راجع تقييم وكلاء الذكاء الاصطناعي الخاص بك.
المراقبة بعد النشر
بعد نشر تطبيق وكيل، تعامل معه كبرنامج إنتاج:
- راقب جودة وإشارات السلامة.
- راجع الآثار عندما يتغير السلوك.
- قم بتحديث وإعادة النشر عندما تصلح المشاكل أو تجري تحسينات.
للحصول على إرشاد، راجع عملاء التتبع.
خطط للهوية والتصاريح
غالبا ما تتطلب الأدوات والموارد اللاحقة المصادقة. عندما تنشر وكيل معين، يمكن أن يتغير نموذج هويته ونموذج الأذون. تأكد من أن وكيلك المنشور لديه فقط الوصول الذي يحتاجه.
للتفاصيل، راجع Agent Identity المفاهيم في Microsoft Foundry.
الأمان والوصول
تعامل مع تكوين الوكيل كرمز تطبيق. حماية الأسرار والأذونات طوال دورة الحياة:
- استخدم أقل امتيازات وتعيينات أدوار بدلا من تضمين المفاتيح. لمزيد من المعلومات، راجع التحكم في الوصول القائم على الأدوار في بوابة Foundry.
- تخزين الأسرار في مخزن سري مدار ويشير إليها عبر الاتصالات بدلا من ترميزها بشكل ثابت في الكود أو ملفات التكوين أو التعليمات. للحصول على إرشاد، راجع إعداد اتصال Key Vault.
- قبل النشر، تأكد من أن هوية الوكيل واتصالات الأدوات في تطبيق الوكيل المنشور توفر فقط الوصول الذي يحتاجونه. للتفاصيل، راجع Agent Identity المفاهيم في Microsoft Foundry.
نشر الوكيل الخاص بك
بعد أن تنشئ نسخة وكيل ترضيها، انشرها كتطبيق وكيل. تحصل على نقطة نهاية مستقرة يمكنك فتحها واختبارها في المتصفح، أو مشاركتها مع الآخرين، أو تضمينها في تطبيقاتك الحالية. يمكنك أنت وزملاؤك التحقق من الأداء وتحديد ما يحتاج إلى تحسين. قم بأي تحديثات ضرورية وأعد نشر نسخة جديدة في أي وقت.
مهم
الأذونات المخصصة لهوية المشروع لا تنتقل تلقائيا إلى الوكيل المنشور. بعد النشر، أعد تعيين الامتيازات اللازمة لهوية تطبيق الوكيل.
مخاطر تطوير الوكيل الشائعة
- التغييرات غير المحفوظة مؤقتة: إذا أردت مقارنة الإصدارات، أو عرض التاريخ، أو إجراء تقييمات كاملة، احفظ تغييراتك كإصدار.
- يجب تكوين الأدوات قبل الحفظ: إذا كانت الأداة تتطلب مصادقة أو اتصال، أكمل الإعداد قبل الحفظ.
- قد يتطلب النشر تحديثات للأذونات: بعد النشر، أعد التحقق من الوصول إلى الموارد لهوية الوكيل المنشور وقم بإزالة أي وصول لم يعد الوكيل بحاجة إليه.
-
إعادة استخدام معرف عامل محذوف: يتم إبطال معرف العامل عند حذف العامل. المكالمات التي تشير إلى إرجاع
404 Not Foundمعرف محذوف أو لم يتم إنشاؤه أبدا . تعامل مع 404 لمعرف صالح مسبقا كوحدة طرفية. أعد إنشاء العامل (أو استخدم نمط get-or-create) بدلا من إعادة محاولة نفس المعرف. التحقق بشكل متكرر من المعرف المحذوف لا ينجح أبدا وينشئ حركة مرور الخطأ فقط.
محتوى ذو صلة
تعرف أكثر على أنواع الوكلاء:
تكوين وتوسيع الوكلاء:
نشر ومراقبة الوكلاء:
تصحيح الأخطاء والتقييم: