إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
Agent 365 CLI هو أداة سطر أوامر عبر النظام الأساسي لنشر تطبيقات Agent 365 وإدارتها على Azure.
لا تحتاج إلى تثبيت CLI يدويا. يتحقق الإعداد الموجه من الذكاء الاصطناعي من CLI، ويثبته أو يحدثه تلقائيا، ويشغل جميع الأوامر المطلوبة نيابة عنك. هذه الصفحة هي مرجع للمطورين الذين يحتاجون إلى تثبيت أو استخدام CLI مباشرة - على سبيل المثال، عند إنشاء أتمتة CI/CD، أو استكشاف أخطاء خطوة معينة وإصلاحها، أو العمل دون عامل ترميز الذكاء الاصطناعي.
ملاحظة
سير عمل المطور الكامل - بما في ذلك الإعداد الموجه بالذكاء الاصطناعي وتوجيه الدور وخطوات ما بعد النشر - موجود في بدء استخدام تطوير العامل 365. هذه الصفحة هي مرجع CLI: التثبيت والتحديث وإلغاء التثبيت والأوامر المتوفرة واستكشاف الأخطاء وإصلاحها.
المتطلبات الأساسية
يتطلب CLI .NET 8.0 أو أحدث. لجميع المتطلبات الأساسية الأخرى - اشتراك Azure وأدوار Entra المطلوبة وتسجيل تطبيق العميل المخصص - راجع الإعداد الموجه AI.
تثبيت Agent 365 CLI
استخدم الخطوات التالية لتثبيت Agent 365 CLI عالميًا على نظام التشغيل الخاص بك.
المتطلبات الأساسية
يجب أن يكون لديك .NET مثبت. (يوصى باستخدام .NET 8.0.)
قم بتثبيت أداة dotnet
تثبيت Agent 365 CLI باستخدام الأمر التالي:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
للحصول على أحدث الإرشادات والإصدارات المتاحة، قم بزيارة صفحة NuGet الرسمية: Microsoft.Agents.A365.DevTools.Cli on NuGet.org
التحقق من التثبيت
بعد تثبيت CLI عامل 365، تحقق من تثبيته بشكل صحيح بتشغيل الأمر --help :
a365 -h
يعرض هذا الأمر معلومات المساعدة ويؤكد أن واجهة سطر الأوامر جاهزة للاِسْتِخْدَام.
Update
تحديث Agent 365 CLI باستخدام أمر تحديث أداة dotnet :
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
ملاحظة
لتحديث Agent 365 CLI، تحتاج إلى اتصال إنترنت للوصول إلى أحدث حزمة NuGet: Microsoft.Agents.A365.DevTools.Cli.
إلغاء التثبيت
إلغاء تثبيت Agent 365 CLI باستخدام الأمر إلغاء تثبيت أداة dotnet :
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
مواقع الملفات
يعتمد الموقع الافتراضي لملف تنفيذ الأداة على نظام التشغيل:
| نظام التشغيل | المسار |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
تضيف SDK هذا الموقع إلى مسارك عندما تقوم بتشغيله لأول مرة. لذا يمكنك استدعاء الأدوات العالمية من أي دليل دون تحديد موقع الأداة.
يعد الوصول إلى الأداة خاصًا بالمستخدم، وليس عالميًا على مستوى الجهاز. الأداة العالمية متاحة فقط للمستخدم الذي يقوم بتثبيت الأداة.
الأوامر المتاحة
للحصول على القائمة الكاملة للأوامر المتاحة، استخدم الأمر --help أو راجع مرجع CLI للعامل 365.
Tip
لا تحتاج إلى تشغيل أوامر CLI يدويا. يقوم الإعداد الموجه بالذكاء الاصطناعي بأتمتة سير العمل الكامل - تثبيت واجهة سطر الأوامر (CLI) وتكوينها وإعداد المخطط ونشره ونشره - باستخدام وكلاء ترميز الذكاء الاصطناعي. استخدم مرجع CLI هنا إذا كنت تقوم بإنشاء أتمتة CI/CD، أو استكشاف أخطاء خطوة معينة وإصلاحها، أو العمل دون عامل ترميز الذكاء الاصطناعي.
للحصول على إرشادات كاملة حول كيفية إعداد عامل Agent 365 باستخدام CLI، راجع بدء استخدام تطوير Agent 365.
استكشاف الأخطاء وإصلاحها
يوفر هذا القسم معلومات حول كيفية استكشاف الأخطاء باستخدام Agent 365 CLI.
Tip
يحتوي دليل استكشاف أخطاء العميل 365 على توصيات عالية المستوى لحل المشاكل، وأفضل الممارسات، وروابط لمحتوى استكشاف الأخطاء لكل جزء من دورة تطوير الوكيل 365.
القضايا الخاصة ب CLI التي يغطيها هذا القسم:
العميل لا يظهر في Teams
إنشاء حالات الوكيل وحل وإصلاحها: الوكيل لا يظهر في Teams
لا يمكن إنشاء نسخة وكيل في Teams
استكشاف أخطاء إنشاء مثيلات الوكلاء: لا يمكن إنشاء مثيل وكيل في Teams