مشاركة عبر

دورة حياة تطوير الوكيل

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

هذه المقالة موجهة للمطورين الذين يرغبون في بناء واختبار وشحن وكلاء جاهزين للإنتاج.

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

دورة الحياة من نظرة سريعة

استخدم هذه الدورة كقائمة تحقق عملية أثناء بناء وشحن وكيل.

  1. اختر نوع الوكيل: ابدأ بوكيل يعتمد على الطلبات، أو سير عمل، أو وكيل مستضاف.
  2. أنشئ وكيل عملك وابدأ الاختبار: كرر في الملعب أو بالشيفرة.
  3. أضف الأدوات والبيانات: أرفق أدوات للاسترجاع والإجراءات، وتحقق من التكوين قبل الحفظ.
  4. احفظ التغييرات كإصدارات: التقط معالم ذات معنى وقارن الإصدارات.
  5. التصحيح باستخدام التتبع: استخدم التتبع لتأكيد استدعاءات الأدوات، والتأخير، والسلوك من طرف إلى طرف. للتفاصيل، راجع نظرة عامة على تتبع العملاء.
  6. تقييم الجودة والسلامة: قم بإجراء تقييمات متكررة لرصد الانحدارات قبل النشر. للحصول على إرشادات مفاهيمية، انظر مقيمو الوكلاء.
  7. انشر ودمج: انشر نقطة نهاية مستقرة ودمجها في تطبيقك. للخطوات، راجع النشر والمشاركة في Microsoft Foundry.
  8. راقب وتكرار: راقب الأداء والجودة في الإنتاج، ثم قم بتحديث وإعادة النشر حسب الحاجة. للحصول على التوجيه، راجع مراقبة الوكلاء.

أنواع الوكلاء في مايكروسوفت فاوندري

هناك ثلاثة أنواع من الوكلاء:

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

  • سير العمل: استخدم سير العمل لبناء سير عمل أكثر تقدما ينظم سلسلة من الإجراءات أو ينسق عدة وكلاء. لسير العمل واجهته الخاصة في البوابة، لكن نفس دورة الحياة تنطبق. للتفاصيل، انظر بناء سير عمل في Microsoft Foundry.

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

أنشئ وكلاء وسير عمل قائم على التعليمات في بوابة Foundry أو في بيئة التطوير الخاصة بك باستخدام واجهة برمجة تطبيقات CLI أو SDK أو REST. لمزيد من المعلومات، راجع البداية السريعة.

إنشاء عامل يستند إلى المطالبة

إذا كنت تعرف بالفعل نوع الوكيل الذي تريد إنشاؤه، قم بتسميته ثم ابدأ بتكوين تعليمات وأدواته في النموذج.

‏‫ملاحظة‬

بعد أن تسمي وكيلك، لا يمكنك تغيير الاسم. في الرمز، تشير إلى وكيلك ب <agent_name>:<version>.

تطوير الوكلاء في الكود

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

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

القدرات الأساسية لدورة حياة تطوير الوكيل

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

احفظ التغييرات كإصدارات

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

يوفر إصدار الوكيل القدرات التالية لإدارة تكوينات وتكرارات الوكلاء. يضمن هذا النظام تتبع جميع التغييرات وقابلية الاختبار والمقارنة بين الإصدارات.

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

  • إدارة الحالة المسودة: يمكنك اختبار الوكلاء في حالة غير محفوظة للتجارب. ستفقد تغييرات غير محفوظة إذا غادرت بوابة Foundry، لذا احفظ باستمرار للحفاظ على التعديلات المهمة.

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

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

    نوع المقارنة وصف
    إعداد الوكيل قارن إعدادات التكوين بين الإصدارات باستخدام قائمة الإصدارات المنسدلة
    إخراج الدردشة تحليل اختلافات الاستجابة بين إصدارات الوكيل باستخدام مدخلات متطابقة
    تعريف YAML الاختلافات في تعريفات الوكلاء في المراجعة

إضافة أدوات

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

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

تصحيح الأخطاء والتحقق باستخدام التتبع (المعاينة)

أثناء إضافة الأدوات وتكرار المحفزات، استخدم التتبع للتحقق من السلوك من طرف إلى طرف:

  • تأكد مما إذا كان الوكيل قد اتصل بالأدوات التي توقعتها.
  • افحص مدخلات ومخرجات الأدوات.
  • حدد نقاط التأخير عبر استدعاءات النماذج والأدوات.

لمزيد من المعلومات، راجع نظرة عامة على تتبع العملاء.

تقييم الجودة والسلامة (معاينة)

قبل نشر وكيلك (وبعد أي تغيير ذي معنى)، قم بإجراء تقييمات لرصد الانحدارات وقياس الجودة باستمرار عبر الإصدارات.

المراقبة بعد النشر

بعد نشر تطبيق وكيل، تعامل معه كبرنامج إنتاج:

  • راقب جودة وإشارات السلامة.
  • راجع الآثار عندما يتغير السلوك.
  • قم بتحديث وإعادة النشر عندما تصلح المشاكل أو تجري تحسينات.

للحصول على إرشاد، راجع عملاء التتبع.

خطط للهوية والتصاريح

غالبا ما تتطلب الأدوات والموارد اللاحقة المصادقة. عندما تنشر وكيل معين، يمكن أن يتغير نموذج هويته ونموذج الأذون. تأكد من أن وكيلك المنشور لديه فقط الوصول الذي يحتاجه.

لمزيد من التفاصيل، راجع مفاهيم هوية الوكلاء في Microsoft Foundry.

الأمان والوصول

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

انشر وكيلك أو سير عملك

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

مهم

الأذونات المخصصة لهوية المشروع لا تنتقل تلقائيا إلى الوكيل المنشور. بعد النشر، أعد تعيين الامتيازات اللازمة لهوية تطبيق الوكيل.

مخاطر تطوير الوكيل الشائعة

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

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

تعرف أكثر على أنواع الوكلاء:

تكوين وتوسيع الوكلاء:

نشر ومراقبة الوكلاء:

تصحيح الأخطاء والتقييم:

  • Last updated on