وكيل 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

قم بتثبيت Agent 365 CLI باِسْتِخْدَام الأمر التالي:

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

إذا تلقيت microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json خطأ، استخدم المعلمة --prerelease لأن هذه الحزمة قد تظل موسومة كمرحلة ما قبل الإصدار.

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

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

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

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

a365 -h

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

‏‏تحديث

تحديث 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 الامر او راجع مرجع Agent 365 CLI

تحديثات مهمة

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

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

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

يحتوي هذا القسم على معلومات حول كيفية استكشاف الأخطاء وإصلاحها باِسْتِخْدَام Agent 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 خطأ، استخدم المعلمة --prerelease لأن هذه الحزمة قد تظل موسومة كمرحلة ما قبل الإصدار.

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

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

عَرَض:

Error: Command 'create-instance' not found

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

الحل:

استخدم سير العمل المحدث:

1. انشر وكيلك:

   a365 publish
   

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

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

3. Deploy to Azure (اختياري):

   # Only if hosting on Azure Web App
   a365 deploy
   

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

   • فتح مايكروسوفت تيمز
   • التوجه إلى التطبيقات
   • ابحث عن وكيلك
   • انقر على "إضافة" لإنشاء نسخة وكيل

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

---

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

عَرَض: بعد تشغيل الأوامر، لا يظهر وكيل في Microsoft Teams.

سبب: ربما تخطيت الخطوة publish أو حاولت استخدام أمر الإزالة create-instance .

الحل:

1. تحقق من أنك نجحت في اللعب a365 publish
2. انتظر من 5 إلى 10 دقائق للتكاثر
3. تحقق من مركز إدارة Microsoft 365: https://admin.cloud.microsoft/#/agents/all
4. إنشاء مثيل وكيل من خلال قسم تطبيقات Teams

---

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

عَرَض: يظهر الوكيل في Teams لكن لا يمكنك إنشاء نسخة وكيل (لا يمكنك إضافة الوكيل).

سبب: رخصة "Microsoft Agent 365 Frontier" غير مخصصة لحساب المستخدم الخاص بك.