إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
Agent 365 CLI هو أداة سطر أوامر عبر النظام الأساسي لنشر تطبيقات Agent 365 وإدارتها على Azure.
لا تحتاج إلى تثبيت CLI يدويا.مهارات العميل 365 تتحقق من مستوى السطوع، وتثبيتها أو تحديثها تلقائيا، وتشغل جميع الأوامر المطلوبة نيابة عنك. هذه المقالة هي مرجع للمطورين الذين يحتاجون إلى تثبيت أو استخدام واجهة السطر مباشرة - على سبيل المثال، عند بناء أتمتة CI/CD، أو استكشاف أخطاء في خطوة معينة، أو العمل بدون وكيل ترميز ذكاء اصطناعي.
ملحوظة
سير عمل المطور الكامل - بما في ذلك الإعداد الموجه بالذكاء الاصطناعي وتوجيه الدور وخطوات ما بعد النشر - موجود في بدء استخدام تطوير العامل 365. هذه الصفحة هي مرجع CLI: التثبيت والتحديث وإلغاء التثبيت والأوامر المتوفرة واستكشاف الأخطاء وإصلاحها.
المتطلبات المسبقه
يتطلب CLI .NET 8.0 أو أحدث. بالنسبة لجميع المتطلبات الأخرى - اشتراك Azure، أدوار Entra المطلوبة، وتسجيل تطبيق العميل المخصص - انظر البدء السريع: ربط وكيل موجود بالوكيل 365.
تثبيت 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.
Uninstall
إلغاء تثبيت Agent 365 CLI باستخدام الأمر إلغاء تثبيت أداة dotnet :
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
مواقع الملفات
يعتمد الموقع الافتراضي لملف تنفيذ الأداة على نظام التشغيل:
| Os | المسار |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
تضيف SDK هذا الموقع إلى مسارك عندما تقوم بتشغيله لأول مرة. لذا يمكنك استدعاء الأدوات العالمية من أي دليل دون تحديد موقع الأداة.
يعد الوصول إلى الأداة خاصًا بالمستخدم، وليس عالميًا على مستوى الجهاز. الأداة العالمية متاحة فقط للمستخدم الذي يقوم بتثبيت الأداة.
الأوامر المتاحة
للحصول على القائمة الكاملة للأوامر المتاحة، استخدم الأمر --help أو راجع مرجع CLI للعامل 365.
نصيحة
لا تحتاج إلى تشغيل أوامر CLI يدويا. تقوم مهارات العميل 365 بأتمتة سير العمل الكامل - تثبيت واجهة السطوع، التكوين، إعداد المخططات، النشر، والنشر - باستخدام وكيل ترميز ذكي اصطناعي. استخدم مرجع CLI هنا إذا كنت تقوم بإنشاء أتمتة CI/CD، أو استكشاف أخطاء خطوة معينة وإصلاحها، أو العمل دون عامل ترميز الذكاء الاصطناعي.
للحصول على إرشادات كاملة حول كيفية إعداد عامل Agent 365 باستخدام CLI، راجع بدء استخدام تطوير Agent 365.
استكشاف الأخطاء
يوفر هذا القسم معلومات حول كيفية استكشاف الأخطاء باستخدام Agent 365 CLI.
نصيحة
يحتوي دليل استكشاف أخطاء العميل 365 على توصيات عالية المستوى لحل المشاكل، وأفضل الممارسات، وروابط لمحتوى استكشاف الأخطاء لكل جزء من دورة تطوير الوكيل 365.
القضايا الخاصة ب CLI التي يغطيها هذا القسم:
العميل لا يظهر في Teams
إنشاء حالات الوكيل وحل وإصلاحها: الوكيل لا يظهر في Teams
لا يمكن إنشاء نسخة وكيل في Teams
استكشاف أخطاء إنشاء مثيلات الوكلاء: لا يمكن إنشاء مثيل وكيل في Teams