إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
مهم
العناصر التي تم تمييزها (معاينة) في هذا المقال حاليا في المعاينة العامة. يتم توفير هذا العرض التمهيدي دون اتفاقية على مستوى الخدمة، ولا نوصي به لأعباء العمل الإنتاجية. قد لا تكون بعض الميزات مدعومة أو قد تكون ذات قدرات محدودة. لمزيد من المعلومات، راجع شروط الاستخدام الإضافية لمعاينات Microsoft Azure.
واجهة برمجة Azure Developer (azd) وامتدادها azd ai agent تمنحك سير عمل واحد في سطر الأوامر للانتقال من فكرة إلى وكيل مستضاف جاهز للإنتاج على Microsoft Foundry. تشرح هذه المقالة رحلة المطور، والملفات التي تحدد الوكيل، والمفاهيم الأساسية التي تواجهها على طول الطريق.
هذه المقالة موجهة للمطورين الذين يفضلون سير عمل يعتمد على الطرفية أولا وقابل للبرمجة النصية على بوابة Foundry أو مجموعات SDK اللغة.
رحلة المطور
يتبع سير azd ai العمل نفس دورة الحياة سواء بنيت نموذجا أوليا صغيرا أو وكيل إنتاج. تقوم بإنشاء مشروع مرة واحدة، ثم تقوم بمزج ومطابقة الأوامر مع نمو مشروعك.
| مرحلة | ما تفعله | أين يمكنك معرفة المزيد |
|---|---|---|
| Install | التثبيت azd وإضافات Foundry. |
قم بإعداد بيئة المطور الخاصة بك |
| السقالة | قم بتهيئة مشروع من قالب أو من كودك الحالي. | البدء السريع: نشر وكيل مستضاف |
| تعريف | تكوين الوكيل، تبعيات نشر النماذج، البروتوكولات، الأدوات، والبيئة في azure.yaml. |
Author azure.yaml for host agents |
| Develop | اكتب منطق الوكلاء، أضف أدوات، واختبر محليا. | نظرة عامة على الأدوات |
| نشر | توفير البنية التحتية ونشرها في Foundry. | نشر وكيل مستضاف |
| التشغيل | راقب السجلات، وإدارة الإصدارات، وأتمتة التشغيل. | إدارة الوكلاء المستضافين |
| تقييم | قس جودة الوكيل وحسن الطلب. | تشغيل تقييمات الوكيل باستخدام واجهة سطر AZD |
أنواع الوكلاء
يركز الامتداد azd ai agent على الوكلاء المستضافين.
| النوع | الوصف | وقت الاستخدام |
|---|---|---|
| الوكيل المستضاف | تطبيق محوى تقوم ببناءه في الكود، وتغليفه كصورة Docker، ثم نشره في Foundry. | تحتاج إلى منطق مخصص، أو تكامل مع إطار عمل، أو تحكم كامل في السلوك. |
| وكيل التوجيه | وكيل يعرف بالكامل من خلال التعليمات وتكوينات الأدوات، بدون كود مخصص. | تريد وكيلا سريعا يعتمد على الإعدادات دون كتابة كود تطبيق. |
الوكلاء المستضافون يمنحونك تحكما كاملا في وقت التشغيل والإطار التكامل مع الأدوات، بينما تتولى Foundry إدارة البنية التحتية والتوسع وإدارة الجلسات.
ملفات التكوين
يستخدم مشروع الوكيل المستضاف ملفا واحدا azure.yaml في جذر المشروع للإعلان عن كل من الوكيل ونموذج التوفير والنشر الخاص به. يستخدم الملف نموذج الخدمة المنقسمة، حيث لكل host خدمة مسماة قيمة مثل azure.ai.project، azure.ai.agent، azure.ai.connection، azure.ai.toolbox، azure.ai.skillأو azure.ai.routine.
| File | الغرض | من يحافظ عليه |
|---|---|---|
azure.yaml |
يعلن مشروع Foundry، ونشر النماذج، وخدمة الوكلاء المستضافة، والتبعيات، والبروتوكولات، والأدوات، ومتغيرات البيئة، وموارد الحاويات، وإعدادات النشر. هوية الوكيل، والنموذج، والبروتوكولات، والأدوات، وقيم البيئة موجودة في azure.ai.agent الخدمة. |
التهيئة تولد ذلك. تقوم بتخصيصها حسب الحاجة. |
azure.ai.agent الخدمة تعرف وكيل الاستضافة الخاص بك داخل الخط وتستخدمها uses: للإشارة إلى خدمات أخرى، مثل المشروع، الاتصالات، صناديق الأدوات، المهارات، والروتينات. لا يوجد ملف مستقل agent.yaml أو agent.manifest.yaml ملف في نموذج مشروع الوكيل azd المستضاف الحالي.
الاستبدال بالمتغيرات
استخدم ${VAR_NAME} في azure.yaml القيم التي تختلف حسب azd البيئة. يتم حل البديل المؤقت من .azure/<env>/.env وقت النشر أو التشغيل، لذا يعمل نفس azure.yaml الشيء عبر البيئات مثل التطوير، المرحلة، والإنتاج.
حيث يمر مؤشر القيادة
تعمل الأوامر azd ai داخل وخارج دليل azd المشروع:
- داخل المشروع
azd، تقوم الأوامر بحل نقطة نهاية مشروع Foundry من البيئة النشطةazd. - خارج
azdالمشروع، قم بتعيين السياق النشط مرة واحدة باستخدامazd ai project set <endpoint>، أو مرر--project-endpointأمر مورد فردي (connection،toolbox،skill، أوroutine). كخيار احتياطي،azd aiيقرأFOUNDRY_PROJECT_ENDPOINTمتغير البيئة. - البيئة داخل المشروع دائما لها الأولوية على السياق العالمي، لذا فإن تغيير الأدلة إلى مشروع يعيد توجيه مؤشر القيادة عند نقطة نهاية ذلك المشروع.
البروتوكولات
بروتوكول يحدد عقد HTTP بين Foundry وحاوية الوكيل الخاصة بك. وكيلك يستمع إلى المنفذ 8088 ويقدم فحص صحي، بغض النظر عن البروتوكول.
| البروتوكول | نمط API | وقت الاستخدام |
|---|---|---|
responses |
واجهة برمجة تطبيقات OpenAI Responses (POST /responses) |
الخيار القياسي، متوافق مع نظام OpenAI API. |
invocations |
عقد JSON مخصص (POST /invocations) |
عندما تحتاج إلى تحكم كامل في حمولة الطلبات والاستجابة. |
للاطلاع على المواصفات الكاملة، انظر عقد تشغيل الوكيل المستضاف.
الجلسات والمحادثات
| المفهوم | الوصف |
|---|---|
| جلسة | بيئة تنفيذ معزولة لتفاعل وكيل واحد. كل جلسة تعمل في صندوق رمل خاص بها مع موارد مخصصة. |
| حوار | تسلسل من الرسائل داخل الجلسة. تدير Foundry سجل المحادثات ويمكنها ترطيبه عبر الطلبات. |
يتم تحديد الجلسات بواسطة .session_id عند تشغيل azd ai agent invoke، يعيد Foundry استخدام الجلسة من آخر استدعاء بشكل افتراضي. استخدمها --new-session للبدء من جديد، أو --session-id <id> لاستهداف جلسة محددة.
موارد حول مشروع مسبك
مشروع Foundry يستضيف أكثر من مجرد وكلاء. كما يحتوي على موارد مشتركة يستشيرها الوكلاء أثناء وقت التشغيل. تدير CLI كل واحدة منها من خلال مجموعة قيادة مخصصة.
| مورد | ما هو عليه | أدار مع |
|---|---|---|
| الاتصال | يربط مشروع Foundry بمورد خارجي، مثل خادم MCP، أو البحث باستخدام الذكاء الاصطناعي في Azure، أو التأريض باستخدام Bing. |
azd ai connection الاوامر |
| صندوق الأدوات | مجموعة مسماة من الأدوات التي يستخدمها الوكلاء أثناء وقت التشغيل. |
azd ai toolbox الاوامر |
| المهاره | إرشادات سلوكية قابلة لإعادة الاستخدام يتم مشاركتها بين الوكلاء في المشروع. |
azd ai skill الاوامر |
| الروتين | محفز زائد فعل يستدعي وكيل. |
azd ai routine الاوامر |
يتم مشاركة هذه الموارد بين المطورين والوكلاء في نفس المشروع. كل مجموعة أوامر تعرض الأفعال القياسية create، ، ، updatedelete، والأفعال showlist.
تقييم وتحسين وكيل
بعد تشغيل الوكيل، يساعدك سير عمل مرتبطان بقياس وتحسين جودته:
- يقوم التقييم بتشغيل وكيلك مقابل مجموعة بيانات، ويقيم الردود مع مقيم أو أكثر، ويبلغ عن إشارة جودة إجمالية. تدير ذلك باستخدام
azd ai agent eval. - التحسين يعيد كتابة طلب وكيلك لرفع إشارة التقييم بشكل تكراري. يستخدم التقييم كوظيفة هدف وينتج موضوع مرشح تراجعه وتقبله. تدير ذلك باستخدام
azd ai agent optimize.
للتفاصيل، راجع تشغيل تقييمات الوكيل باستخدام تعليمات AZD CLIوOptimize.
دورة حياة النشر
تتكثف حلقة المطور الكاملة في تسلسل قصير من الأوامر. قم بعمل سقالة مرة واحدة، ثم استخدم الأوامر المباشرة مع نمو مشروعك.
# Scaffold a project from a template or your existing code
azd ai agent init
# Run locally and invoke
azd ai agent run
azd ai agent invoke --local "Hello, world!"
# Provision infrastructure and deploy the agent
azd up
# Extend the project with shared resources at any time
azd ai connection create my-search --kind cognitive-search --target https://... --auth-type api-key --key "..."
azd ai routine create daily-digest --trigger recurring --cron "0 7 * * *" --agent-name my-agent
# Evaluate quality
azd ai agent eval generate
azd ai agent eval run
# Tear down all Azure resources
azd down