وكيل 365 CLI

مهم

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

Agent 365 CLI عبارة عن أداة سطر أوامر متعددة الأنظمة لنشر وإدارة تطبيقات Agent 365 على Azure.

المتطلبات

قبل أن تبدأ، تأكد من أن لديك المتطلبات التالية:

• تسجيل تطبيق العميل المخصص - يتطلب سطر القيادة تطبيق عميل مخصص في مستأجر Microsoft Entra ID الخاص بك للمصادقة. راجع تسجيل تطبيق العميل المخصص للحصول على تعليمات إعداد مفصلة. تحتاج إلى معرف التطبيق (العميل) أثناء التكوين.
• اشتراك Azure - إمكانية الوصول إلى اشتراك Azure حيث يمكنك إنشاء الموارد.
• الأذونات المطلوبة - يجب أن يحتوي حسابك على أحد الأدوار التالية:
  • المسؤول العام
  • مسؤول معرف الوكيل
  • مطور معرف الوكيل

إشعار

خلال a365 config init الخطوة (بعد التثبيت)، يقوم مؤشر التحكم تلقائيا بالتحقق من تسجيل تطبيق العميل المخصص الخاص بك عن طريق التحقق من وجود التطبيق، والحصول على الأذونات المطلوبة، وموافقة المسؤول.

Tip

أوامر CLI المختلفة تتطلب أدوارا أو صلاحيات مختلفة. تحدد كل صفحة مرجعية للأمر الحد الأدنى للدور المطلوب. على سبيل المثال، راجع مرجعsetup الأمر لمعرفة متطلباته المحددة.

تثبيت Agent 365 CLI

استخدم الخطوات التالية لتثبيت Agent 365 CLI عالميًا على نظام التشغيل الخاص بك.

المتطلبات

يجب أن يكون لديك .NET مثبتًا. (يُوصى بـ .NET 8.0 is.)

Windows

تثبيت .NET على Windows

Linux

تثبيت .NET على Linux

macOS

تثبيت .NET على macOS

استخدم أداة التثبيت dotnet

تثبيت واجهة CLI الخاصة بالعامل 365 باستخدام الأمر التالي مع المعامل --prerelease :

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

مهم

جهاز CLI العميل 365 لا يزال في مرحلة المعاينة. حتى يصبح واجهة التصنيع الخاصة بالعامل 365 متاحة بشكل عام، استخدم دائما هذا --prerelease المعلمة للحصول على أحدث إصدار يحتوي على أحدث الإصلاحات والميزات. عندما يصبح CLI عامل 365 متاحا بشكل عام، لن يكون هذا --prerelease المعامل ضروريا.

للحصول على أحدث الإرشادات والإصدارات المتاحة، قم بزيارة صفحة NuGet الرسمية: Microsoft.Agents.A365.DevTools.Cli on NuGet.org

التحقق من التثبيت

بعد تثبيت CLI عامل 365، تحقق من تثبيته بشكل صحيح بتشغيل الأمر --help :

a365 -h

يعرض هذا الأمر معلومات المساعدة ويؤكد أن واجهة سطر الأوامر جاهزة للاِسْتِخْدَام.

‏‏تحديث

قم بتحديث CLI للعامل 365 باستخدام أمر تحديث أداة dotnet مع المعامل:--prerelease

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

إشعار

لتحديث 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.

تحديثات مهمة

تم إزالة الأمر: أزال CLI الأمر create-instance . تجاوز خطوات التسجيل المطلوبة، والتي كانت ستحد من وظائف الوكيل. قد يعاد تقديم هذا الأمر في إصدار لاحق بمجرد أن يتوافق مع سير العمل الموصى به.

للحصول على تعليمات كاملة حول كيفية إعداد وكيل Agent 365 باستخدام CLI، راجع دورة حياة تطوير الوكيل 365.

استكشاف الأخطاء وإصلاحها

يوفر هذا القسم معلومات حول كيفية استكشاف الأخطاء باستخدام Agent 365 CLI.

Tip

يحتوي دليل استكشاف أخطاء العميل 365 على توصيات عالية المستوى لحل المشاكل، وأفضل الممارسات، وروابط لمحتوى استكشاف الأخطاء لكل جزء من دورة تطوير الوكيل 365.

القضايا الخاصة ب CLI التي يغطيها هذا القسم:

• Not found in NuGet feeds خطأ عند التثبيت أو التحديث أو إلغاء التثبيت
• create-instance الأمر غير موجود
• العميل لا يظهر في Teams
• لا يمكن إنشاء نسخة وكيل في Teams

Not found in NuGet feeds خطأ عند التثبيت أو التحديث أو إلغاء التثبيت

عَرَض:microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json خطأ عند تثبيت أو تحديث أو إزالة ملف الوكيل 365.

الحل: استخدم المعاملة --prerelease .

جميع الإصدارات الحالية من CLI هي إصدارات ما قبل الإصدار.

# For installation
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

# For updates
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli --prerelease

للحصول على أحدث الإرشادات والإصدارات المتاحة، قم بزيارة صفحة NuGet الرسمية: Microsoft.Agents.A365.DevTools.Cli on NuGet.org

create-instance الأمر غير موجود

عَرَض: أنت ترى الخطأ Command 'create-instance' not found .

السبب: أزال CLI الأمر create-instance . تجاوز خطوات التسجيل المطلوبة، والتي كانت ستحد من وظائف الوكيل. قد يعيد فريق التطوير إدخال هذا الأمر في إصدار لاحق عندما يتوافق مع سير العمل الموصى به.

الحل: استخدم الخطوات التالية بدلا من ذلك:

1. انشر وكيلك: استخدم أمر النشر a365.

   a365 publish
   

2. تكوين مخطط الوكيل في بوابة المطورين:

   تعلم كيفية تكوين مخطط وكيل في بوابة مطوري Teams.

3. Deploy to Azure (اختياري): استخدم أمر a365 deploy.

   # Only if hosting on Azure Web App
   a365 deploy
   

4. إنشاء مثيل وكيل عبر Microsoft Teams:

   1. افتح Microsoft Teams.
   2. اذهب إلى التطبيقات.
   3. ابحث عن وكيلك.
   4. اختر إضافة لإنشاء نسخة وكيل.

للحصول على تعليمات تفصيلية، راجع وكلاء الخدمة.

العميل لا يظهر في Teams

إنشاء حالات الوكيل وحل وإصلاحها: الوكيل لا يظهر في Teams

لا يمكن إنشاء نسخة وكيل في Teams

إنشاء مثيلات الوكلاء أثناء استكشاف المشكلة: لا يمكن إنشاء نسخة وكيل في Teams