إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
مهم
العناصر التي تم تمييزها (معاينة) في هذا المقال حاليا في المعاينة العامة. يتم توفير هذا العرض التمهيدي دون اتفاقية على مستوى الخدمة، ولا نوصي به لأعباء العمل الإنتاجية. قد لا تكون بعض الميزات مدعومة أو قد تكون ذات قدرات محدودة. لمزيد من المعلومات، راجع شروط الاستخدام الإضافية لمعاينات Microsoft Azure.
تتيح لك امتدادات Azure Developer CLIazd () ai بناء ونشر وتقييم وتشغيل وكلاء الذكاء الاصطناعي على Microsoft Foundry من جهازك الطرفي. في هذا المقال، تقوم بتثبيت الإضافات، والتحقق من التثبيت، والتحقق منها إلى Azure.
المتطلبات المسبقه
- اشتراك في Azure. أنشئ واحدا مجانا.
- إصدار Azure Developer CLI (
azd) 1.25.2 أو أحدث. قم بتثبيت AZD. - Python 3.10 أو أحدث، أو .NET 8 أو أحدث، حسب إطار عمل الوكيل الذي تخطط لاستخدامه.
صلاحيات Azure
تحتاج إلى الأدوار التالية في اشتراكك في Azure.
| دور | الغرض |
|---|---|
| مساهم | توفير وإدارة موارد Azure. |
| مالك المصنع | مطلوب فقط إذا أنشأت مشاريع جديدة في Foundry. |
مهم
تم تغيير اسم أدوار RBAC في Foundry مؤخرا. Foundry User، Foundry Owner، Foundry Account Owner، وFoundry Project Manager تم تسميتها سابقا Azure مستخدم الذكاء الاصطناعي، ومالك الذكاء الاصطناعي Azure، ومالك حساب Azure الذكاء الاصطناعي، ومدير Project الذكاء الاصطناعي Azure. قد ترى الأسماء السابقة في بعض الأماكن أثناء صدور إعادة التسمية. معرفات الأدوار والأذونات الأساسية لم تتغير عند إعادة الاسم.
افهم كيف يتم تغليف الإضافات
تتكون مساحة azd ai الأسماء من عدة امتدادات مستقلة azd . كل واحد يساهم بمجموعة قيادة على مستوى أعلى تحت azd ai.
| معرف الامتداد | مجموعة القيادة | ماذا تفعل |
|---|---|---|
microsoft.foundry |
الحزمة الميتا | يجمع جميع إضافات Foundry لتثبيت واحد. |
azure.ai.agents |
azd ai agent |
اشحن وكلاء مع Foundry من طرفك. |
azure.ai.connections |
azd ai connection |
إدارة علاقات مشروع Foundry. |
azure.ai.inspector |
azd ai inspector |
واجهة مستخدم مفتش تعتمد على المتصفح للوكلاء المحليين. |
azure.ai.projects |
azd ai project |
سياق مشروع إدارة Foundry (set, unset, show). |
azure.ai.routines |
azd ai routine |
إدارة روتينات Foundry (المؤقتات، الجداول، محفزات الأحداث). |
azure.ai.skills |
azd ai skill |
مهارات إدارة Foundry (إرشادات سلوكية للوكلاء القابلة لإعادة الاستخدام). |
azure.ai.toolboxes |
azd ai toolbox |
إدارة صناديق أدوات Foundry (مجموعات الأدوات المصنفة على الإصدارات). |
الحزمة microsoft.foundry عبارة عن حزمة ميتا رقيقة لا تساهم بأوامرها الخاصة. تركيبه يجذب كل امتداد على حدة، وهو نقطة البداية الموصى بها. التثبيت azure.ai.agents التلقائي يسحب azure.ai.inspector تلقائيا، لأن امتداد الوكيل يعتمد عليه.
ثبت الحزمة الكاملة
قم بتثبيت كل إضافة Foundry في خطوة واحدة عبر الحزمة الميتا:
azd ext install microsoft.foundry
للتحديث لاحقا:
azd ext upgrade microsoft.foundry
تركيب أو ترقية امتداد فردي
يمكنك أيضا إدارة كل امتداد بمفرده:
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
الإضافات الفردية يتم إصدارها بشكل مستقل، لذا يمكنك تثبيت أو ترقية واحدة تلو الأخرى.
تحقق من التركيب
قائمة الإضافات المثبتة:
azd ext list
يجب أن ترى microsoft.foundry كل امتداد على حدة. كل امتداد يعرض أيضا أمرا فرعيا version :
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
المصادقة
سجل الدخول إلى Azure حتى يتمكن قائد القيادة من توفير وإدارة الموارد نيابة عنك:
azd auth login
يفتح هذا الأمر نافذة متصفح للمصادقة التفاعلية. بعد تسجيل الدخول، يقوم مؤشر التحكم بتخزين بيانات اعتمادك محليا للأوامر التالية.