مشاركة عبر

وكلاء اختبار باستخدام مجموعة تطوير البرمجيات Microsoft Agent 365

مهم

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

اختبر وكيلك محليا باستخدام Agents Playground قبل النشر. يغطي هذا الدليل إعداد بيئة التطوير الخاصة بك، وتكوين المصادقة، والتحقق من وظائف وكيلك باستخدام أداة اختبار ملعب الوكلاء.

بمجرد أن يعمل وكيلك محليا، يمكنك اتباع دورة حياة تطوير Agent 365 لاختبار تطبيقات Microsoft 365 مثل Teams وWord وOutlook.

المتطلبات

قبل البدء في اختبار الوكيل الخاص بك، تأكد من تثبيت المتطلبات الأساسية التالية:

المتطلبات الأساسية الشائعة

المتطلبات الأساسية الخاصة باللغة

  • بايثون 3.11 أو أحدث: تحميل من python.org أو متجر مايكروسوفت
  • مدير حزم UV: تثبيت UV باستخدام pip install uv
  • التحقق من التثبيت: python --version

تكوين بيئة اختبار العامل

يشرح هذا القسم كيفية تعيين متغيرات البيئة، وتوثيق بيئة التطوير الخاصة بك، وتحضير وكيل الوكيل 365 الخاص بك للاختبار.

يتبع إعداد بيئة اختبار العامل سير عمل تسلسلي:

  1. تكوين بيئتك - أنشئ أو حدث ملف تكوين البيئة الخاص بك.

  2. تكوين نموذج اللغة الكبيرة - احصل على مفاتيح API وقم بتكوين إعدادات OpenAI أو Azure OpenAI.

  3. تكوين المصادقة - قم بإعداد المصادقة الوكيلية.

  4. مرجع متغيرات البيئة - تكوين متغيرات البيئة المطلوبة:

    1. متغيرات المصادقة
    2. تكوين نقطة نهاية MCP
    3. متغيرات المراقبة
    4. تكوين خَادِم تطبيق العامل

بعد إكمال هذه الخطوات، تكون مستعدا لبدء اختبار وكيلك في Agents Playground.

الخطوة 1: تكوين البيئة الخاصة بك

إعداد ملف التكوين الخاص بك:

cp .env.template .env

إشعار

لقوالب التكوين التي تعرض الحقول المطلوبة، راجع عينات SDK لمايكروسوفت أجنيت 365.

الخطوة 2: تكوين LLM

تكوين إعدادات OpenAI أو Azure OpenAI للاختبار المحلي. أضف مفاتيح API ونقاط نهاية الخدمة من المتطلبات المسبقة إلى ملف التكوين الخاص بك مع أي معلمات نموذج.

اضافة الى ملفك .env:

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

متغيرات بيئة Python LLM

المتغير الوصف مطلوبة مثال
OPENAI_API_KEY مفتاح واجهة برمجة التطبيقات لخدمة OpenAI لـ OpenAI sk-proj-...
AZURE_OPENAI_API_KEY مفتاح API لخدمة Azure OpenAI بالنسبة إلى Azure OpenAI a1b2c3d4e5f6...
AZURE_OPENAI_ENDPOINT عنوان URL لنقطة نهاية خدمة Azure OpenAI بالنسبة إلى Azure OpenAI https://your-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT اسم النشر في Azure OpenAI بالنسبة إلى Azure OpenAI gpt-4
AZURE_OPENAI_API_VERSION إصدار واجهة برمجة التطبيقات ل Azure OpenAI بالنسبة إلى Azure OpenAI 2024-02-15-preview

الخطوة 3: قم بتكوين المصادقة لوكيلك

اختر واحدة من طرق المصادقة التالية لوكيلك:

  • المصادقة الوكائلية - استخدامها في سيناريوهات الإنتاج عندما تتوفر هوية مستخدم وكيلية.
  • مصادقة OBO - استخدمها في سيناريوهات الإنتاج عندما تحتاج إلى صلاحيات مستخدم مفوضة بدون هوية مستخدم وكيلية.
  • مصادقة رموز الحامل - تستخدم فقط في سيناريوهات التطوير والاختبار المبكرة قبل تكوين مصادقة الإنتاج.

المصادقة الوكائلية

استخدم أمر CLI a365 config display الخاص بالوكيل 365 لاسترجاع بيانات اعتماد مخطط الوكيل الخاص بك.

a365 config display -g

يعرض هذا الأمر تكوين مخطط العامل الخاص بك. انسخ القيم التالية:

القيمة‬ الوصف
agentBlueprintId معرف عميل وكيلك
agentBlueprintClientSecret سر عميل وكيلك
tenantId معرف مستأجر Microsoft Entra

استخدم هذه القيم لتكوين المصادقة الوكيلة في وكيلك:

أضف الإعدادات التالية إلى ملفك .env ، واستبدل قيم العنصر النائب ببيانات الاعتماد الفعلية الخاصة بك:

USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>
المتغير الوصف مطلوبة مثال
USE_AGENTIC_AUTH تمكين وضع المصادقة الوكيلة نعم true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID معرف العميل من مخطط الوكيل a365 config display -g نعم 12345678-1234-1234-1234-123456789abc
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET مخطط العميل السري من a365 config display -g نعم abc~123...
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID معرف مستأجر Microsoft Entra منa365 config display -g نعم adfa4542-3e1e-46f5-9c70-3df0b15b3f6c

مصادقة OBO

تمكن المصادقة علىBehalf-Of (OBO) وكيلتك من الوصول إلى أدوات خادم MCP باستخدام صلاحيات المستخدم المفوضة دون الحاجة إلى هوية مستخدم وكيلية. في هذا التدفق، يستلم الوكيل الرمز المفوض للمستخدم ويبدله لأداء الإجراءات نيابة عنه.

مصادقة OBO مناسبة لسيناريوهات الإنتاج حيث:

  • وكيلك لا يمتلك هوية مستخدم وكيلية.
  • تحتاج إلى الوصول إلى الموارد التي تحمل صلاحيات خاصة بالمستخدم.
  • تريد من الوكيل أن يتصرف نيابة عن المستخدم المصادق.

لمزيد من التفاصيل حول كيفية عمل تدفق OBO، راجع تدفقات المصادقة. للحصول على مثال كامل على التنفيذ، راجع عينة تفويض OBO في مجموعة تطوير Microsoft 365 Agents.

مصادقة رمز الحامل

في سيناريوهات التطوير والاختبار المبكرة عندما لا يكون مصادقة الإنتاج مضبوطة، استخدم مصادقة الرمز الحامل لاختبار وكيلك. تستخدم هذه الطريقة المصادقة التفاعلية في المتصفح للحصول على رمز وصول مفوض. باستخدام هذا الرمز، يمكن لوكيلك استدعاء أدوات خادم MCP باستخدام صلاحيات المستخدم الخاصة بك. تحاكي هذه الطريقة كيف يصل مستخدم الوكيل إلى الموارد في الإنتاج دون الحاجة إلى نسخة وكيل فعلية.

أولا، استخدم a365 develop add-permissions إضافة صلاحيات خادم MCP المطلوبة إلى تطبيقك:

a365 develop add-permissions

ثم، استخدم a365 develop get-token لاسترجاع وتكوين رموز الحامل:

a365 develop get-token

الأمر get-token تلقائيا:

  • يسترجع رموز الحامل لجميع خوادم MCP المهيأة في ملفك ToolingManifest.json
  • تحديث ملفات تكوين مشروعك باستخدام BEARER_TOKEN متغير البيئة

إشعار

تنتهي صلاحية رموز الحامل بعد حوالي ساعة واحدة. تستخدمها a365 develop get-token لتحديث الرموز المنتهية الصلاحية.

الخطوة 4: مرجع متغيرات البيئة

أكمل إعداد البيئة الخاصة بك عن طريق تكوين متغيرات البيئة المطلوبة التالية:

  • متغيرات المصادقة - الإعدادات المطلوبة للمصادقة الوكيلة
  • تكوين نقطة نهاية MCP - حدد نقطة نهاية النظام الأساسي ل Agent 365
  • متغيرات إمكانية المراقبة - تمكين التسجيل والتتبع الموزع
  • تكوين خَادِم تطبيق العامل - تكوين المنفذ الذي يعمل فيه خَادِم الوكيل

متغيرات المصادقة

تكوين إعدادات معالج المصادقة المطلوبة للمصادقة الوكيلة للعمل بشكل صحيح.

اضافة الى ملفك .env:

# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection

# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION
المتغير الوصف مطلوبة
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE نوع معالج المصادقة نعم
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES نطاقات المصادقة ل Microsoft Graph نعم
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME اسم اتصال المخطط البديل نعم
CONNECTIONSMAP_0_SERVICEURL نمط عنوان URL للخدمة لتعيين الاتصال نعم
CONNECTIONSMAP_0_CONNECTION اسم الاتصال للت تعيين نعم

تكوين نقطة نهاية MCP

حدد نقطة نهاية منصة Agent 365 التي يتصل بها وكيلك. عند إنشاء بيان الأدوات الذي يحدد خوادم الأدوات لوكيلك، حدد نقطة نهاية منصة MCP. تحدد نقطة النهاية هذه البيئة (التي تم توفيرها مسبقا أو اختبارها أو إنتاجها) التي تتصل بها خوادم أدوات MCP لإمكانيات تكامل Microsoft 365.

اضافة الى ملفك .env:

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>
المتغير الوصف مطلوبة افتراضي مثال
MCP_PLATFORM_ENDPOINT عنوان URL لنقطة نهاية النظام الأساسي MCP (preprod أو test أو prod) لا. نقطة نهاية الإنتاج

مهم: إذا لم تحدد MCP_PLATFORM_ENDPOINT، فإن التطبيق يستخدم نقطة الإنتاج.

إشعار

إذا كنت تستخدم خادم الأدوات التجريبية من CLI، اضبط نقطة النهاية باستخدام http://localhost:<port> رقم المنفذ الذي استخدمته. المنفذ الافتراضي هو 5309.

متغيرات المراقبة

قم بتكوين هذه المتغيرات المطلوبة لتمكين التسجيل والتتبع الموزع لعاملك. تعرف أكثر على ميزات الملاحظة وأفضل الممارسات.

إشعار

تكوين إمكانية المراقبة هو نفسه عبر جميع اللغات.

المتغير الوصف افتراضي مثال
ENABLE_A365_OBSERVABILITY تمكين أو تعطيل قابلية الرصد false true
ENABLE_A365_OBSERVABILITY_EXPORTER تصدير التتبعات إلى خدمة إمكانية المراقبة false true
OBSERVABILITY_SERVICE_NAME اسم الخدمة للتتبع اسم العامل my-agent-service
OBSERVABILITY_SERVICE_NAMESPACE مساحة اسم الخدمة agent365-samples my-company-agents

تكوين خَادِم تطبيق العامل

تكوين المنفذ حيث يتم تشغيل خَادِم تطبيق العامل الخاص بك. هذا الإعداد اختياري وينطبق على وكلاء بايثون وجافاسكريبت.

اضافة الى ملفك .env:

# Server Configuration
PORT=3978
المتغير الوصف مطلوبة افتراضي مثال
PORT رقم المنفذ حيث يتم تشغيل خَادِم العامل لا. 3978 3978

تثبيت التبعيات وبدء تشغيل خَادِم تطبيق العامل

بعد إعداد بيئتك، قم بتثبيت التبعيات المطلوبة وتشغيل خادم تطبيق الوكيل محليا للاختبار.

تثبيت التبعيات

uv pip install -e .

يقرأ هذا الأمر تبعيات الحزمة المعرفة في pyproject.toml ويثبتها من PyPI. عند إنشاء تطبيق وكيل من الصفر، أنشئ pyproject.toml ملفا لتعريف تبعياتك. نماذج العَوامِل من مستودع العينات لديها بالفعل هذه الحزم المعرفة. يمكنك إضافتها أو تحديثها حسب الحاجة.

بدء تشغيل خَادِم تطبيق العامل

python <main.py>

استبدل <main.py> باسم ملف Python الرئيسي الذي يحتوي على نقطة الإدخال لتطبيق العامل الخاص بك (على سبيل المثال، start_with_generic_host.pyأو app.pyأو main.py).

أو استخدم الأشعة فوق البنفسجية:

uv run python <main.py>

خادم الوكيل الخاص بك يعمل الآن وجاهز لاستقبال الطلبات من Agents Playground أو تطبيقات Microsoft 365.

عامل اختبار في Agents Playground

Agents Playground هي أداة اختبار محلية تحاكي بيئة Microsoft 365 دون الحاجة إلى إعداد مستأجر كامل. إنها أسرع طريقة للتحقق من صحة منطق وكيلك واستدعاءات الأداة. لمزيد من المعلومات، راجع اختبار مع Agents Playground.

تكوين ملعب الوكلاء للمصادقة الوكائلية

إشعار

هذا التكوين مطلوب فقط عند استخدام المصادقة الوكالية. إذا كنت تستخدم مصادقة الرمز الحامل، يمكنك تخطي هذا القسم والانتقال مباشرة إلى الاختبار الأساسي.

عند استخدام المصادقة الوكائلية، قم بتكوين ملف YAML الخاص بملعب العملاء مع تفاصيل وكيلك:

  1. قم بإعداد ملف التكوين: أنشئ أو حدث الملف .m365agentsplayground.yml في المجلد الذي تشغل فيه Agents Playground. للحصول على تعليمات إعداد مفصلة، راجع تخصيص سياق الفرق.

  2. تحديث تكوين البوت: أضف التفاصيل التالية للبوت إلى ملفك .m365agentsplayground.yml ، واستبدل قيم البوت المؤقتة ببيانات اعتماد الوكيل الفعلي:

    bot:
  id: <your-agent-email>@<your-tenant>.onmicrosoft.com
  name: <Your Agent Name>
  role: agenticUser
  agenticUserId: <your-agentic-user-id>
  agenticAppId: <your-agentic-app-id>
    الخاصية الوصف مطلوبة
    id عنوان بريد مستخدم وكيلك الإلكتروني في الصيغة agentusername@tenant.onmicrosoft.com نعم
    name اسم العرض لمستخدم وكيلك نعم
    role يجب ضبطه على agenticUser للمصادقة الوكائلية نعم
    agenticUserId معرف الكائن المستخدم للوكيل. ابحث عن هذه القيمة في مركز إدارة Microsoft Entra في صفحة ملف مستخدم الوكيل. نعم
    agenticAppId معرف الوكيل المستخدم للوكيل. ابحث عن هذه القيمة في مركز إدارة Microsoft Entra في صفحة ملف مستخدم الوكيل. نعم

افتح محطة طرفية جديدة (PowerShell على Windows) وابدأ تشغيل Agents Playground:

agentsplayground

يفتح هذا الأمر متصفح ويب بواجهة ملعب الوكلاء. تعرض الأداة واجهة دردشة حيث يمكنك إرسال رسائل إلى وكيلك.

اختبار أساسي

ابدأ بالتحقق من تكوين عاملك بشكل صحيح. إرسال رسالة إلى العامل:

What can you do?

يرد الوكيل بالتعليمات التي تم تكوينه بها، بناء على موجه النظام الخاص بوكيلك وقدراته. هذا الرد يؤكد أن:

  • وكيلك يعمل بشكل صحيح.
  • يمكن للوكيل معالجة الرسائل والرد.
  • التواصل بين Agents Playground ووكيلكم يعمل.

استدعاءات أداة الاختبار

بعد تكوين خوادم أدوات MCP الخاصة بك ( toolingManifest.json انظر الأدوات لتعليمات الإعداد)، اختبر استدعاءات الأدوات باستخدام أمثلة مثل هذه الأمثلة:

أولا، تحقق من الأَدَوَات المتوفرة:

List all tools I have access to

ثم اختبر استدعاءات الأدوات المحددة:

أدوات البريد

Send email to your-email@example.com with subject "Test" and message "Hello from my agent"

الرد المتوقع: يرسل الوكيل بريدا إلكترونيا باستخدام خادم Mail MCP ويؤكد إرسال الرسالة.

أدوات التقويم

List my calendar events for today

الاستجابة المتوقعة: يقوم الوكيل باسترجاع وعرض أحداث تقويمك لليوم الحالي.

أدوات SharePoint

List all SharePoint sites I have access to

الاستجابة المتوقعة: يقوم الوكيل باستعلام SharePoint ويعيد قائمة بالمواقع التي يمكنك الوصول إليها.

يمكنك عرض استدعاءات الأداة في:

  • نافذة الدردشة - راجع استجابة العامل وأي مكالمات أداة
  • لوحة السجل - راجع معلومات النشاط التفصيلية بما في ذلك معلمات الأداة والاستجابات

اختبار مع أنشطة الإعلام

خلال التطوير المحلي، تختبر سيناريوهات الإشعارات باستخدام مشغلات الإشعارات المدمجة في ملعب الوكلاء.

لقطة شاشة تظهر واجهة ملعب العملاء مع توسيع قائمة المحاكاة والنشاط، تعرض خيارات نشاط إشعار الزناد بما في ذلك إرسال البريد الإلكتروني والذكر في وورد.

قبل اختبار أنشطة الإشعارات، تأكد من:

إشعارات البريد الإلكتروني التجريبي

لاختبار التعامل مع إشعارات البريد الإلكتروني:

  1. ابدأ ملعب وكيل ووكلاء اللعب.
  2. في ملعب الوكلاء، اذهب لإجراء محاكاة> النشاط.
  3. حدد إرسال بريد إلكتروني.
  4. في حوار الحمولة، قم بتحديث تفاصيل البريد الإلكتروني التجريبي مثل اسم المرسل ومحتوى نص البريد حسب الحاجة.
  5. اختر إرسال النشاط.
  6. شاهد النتيجة في كل من محادثة الدردشة ولوحة السجل.

الوكيل يتلقى إشعارا محاكاة عبر البريد الإلكتروني ويعالجها وفقا لمنطق التعامل مع الإشعارات الخاص بك. للحصول على تفاصيل حول هيكل حمولة إشعار البريد الإلكتروني، راجع حمولة إشعارات البريد الإلكتروني.

إشعارات ذكر كلمة اختبار

لاختبار إشعارات ذكر مستندات وورد:

  1. ابدأ ملعب وكيل ووكلاء اللعب.
  2. في ملعب الوكلاء، اذهب لإجراء محاكاة> النشاط.
  3. اختر الذكر في وورد.
  4. في حوار الحمولة، قم بتحديث تفاصيل التعليق التجريبي مثل معرف المستند ونص التعليق حسب الحاجة.
  5. اختر إرسال النشاط.
  6. شاهد النتيجة في كل من محادثة الدردشة ولوحة السجل.

يتلقى الوكيل إشعارا محاكاة بذكر Word ويرد وفقا لمنطق التعامل مع الإشعارات الخاص بك. للحصول على تفاصيل حول هيكل حمولة إشعار التعليق في وورد، انظر حمولة إشعار التعليق المستندية.

عرض سجلات إمكانية المراقبة

لعرض سجلات إمكانية المراقبة أثناء التطوير المحلي، ضع علامة على العامل الخاص بك برمز إمكانية المراقبة (راجع إمكانية المراقبة للحصول على أمثلة التعليمات البرمجية) وتكوين متغيرات البيئة كما هو موضح في متغيرات إمكانية المراقبة. بمجرد التكوين، تظهر آثار في الوقت الحقيقي في الجهاز تظهر:

  • تتبعات استدعاء العامل
  • تفاصيل تنفيذ الأداة
  • استدعاءات الاستدلال LLM
  • رسائل الإدخال والإخراج
  • اِسْتِخْدَام الرمز المميز
  • أوقات الاستجابة
  • معلومات الخطأ

تساعدك هذه السجلات على تصحيح المشكلات، وفهم سلوك الوكيل، وتحسين الأداء.

الخطوات التالية

بعد أن تختبر وكيل جهازك محليا بنجاح، تكون جاهزا لنشره على Azure ونشره على Microsoft 365.

اتبع دورة حياة تطوير Agent 365 لاختبار تطبيقات Microsoft 365 مثل Teams وWord وOutlook.

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

يقدم هذا القسم حلولا للمشاكل الشائعة التي قد تواجهها عند اختبار وكيلك محليا.

Tip

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

مشاكل الاتصال والبيئة

تتعلق هذه المشاكل بالاتصال بالشبكة، وتعارضات المنافذ، ومشاكل إعداد البيئة التي قد تمنع وكيلك من التواصل بشكل صحيح.

مشاكل الاتصال بملعب العملاء

العرض: العميل بلارغراوين لا يمكنه الاتصال بوكيلك.

الحلول‏‎:

  • تحقق من أن خادم الوكيل يعمل.
  • تحقق من تطابق أرقام المنافذ بين وكيلك ووكلاء بلايدرود.
  • تأكد من عدم وجود قواعد جدار حماية تمنع الاتصالات المحلية.
  • حاول إعادة تشغيل كل من العميل وملعب الوكلاء.

إصدار Agents Playground القديم

العرض: أخطاء غير متوقعة أو ميزات مفقودة في ملعب العميلات.

الحل: قم بإلغاء تثبيت وإعادة تثبيت Agents Playground.

winget uninstall agentsplayground
winget install agentsplayground

‏‫تعارضات الاستيراد‬

العرض: خطأ يشير إلى أن المنفذ قيد الاستخدام بالفعل.

الحل:

  • توقف عن أي حالات أخرى لوكيلك.
  • غير المنفذ في إعدادك.
  • قم بإيقاف أي عمليات باستخدام المنفذ.
# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process

لا يمكن إضافة DeveloperMCPServer

العرض: خطأ عند محاولة إضافة DeveloperMCPServer في VS Code.

الحل: أغلق Visual Studio Code وأعد فتحه، ثم حاول إضافة الخَادِم مرة أخرى.

مشاكل المصادقة والرموز

تحدث هذه المشاكل عندما لا يستطيع وكيلك المصادقة بشكل صحيح مع خدمات Microsoft 365 أو عندما تنتهي صلاحية بيانات الاعتماد أو يتم إعدادها بشكل خاطئ.

الأعراض:

  • 401 أخطاء غير مصرح بها
  • رسائل "رمز الحامل انتهت صلاحيتها"
  • فشل المصادقة الوكلاء

السبب الجذري:

  • تنتهي صلاحية الرموز بعد حوالي ساعة واحدة
  • تكوين المصادقة غير الصحيح
  • بيانات الاعتماد المفقودة أو غير الصالحة

الحلول‏‎:

  • بالنسبة لانتهاء انتهاء الرمز الحامل

    حدث الرمز الخاص بك وحدث متغيرات البيئة.

    # Get a new token
a365 develop get-token

# Update your .env file with the new token

  • بالنسبة لأخطاء المصادقة الوكائلية (بايثون)

    تحقق من ملفك .env :

    # Should be (with underscore):
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION

# Not:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection

  • بسبب الشهادات المفقودة

    تأكد من وجود الاعتمادات المطلوبة قبل الاختبار.

    ضمان .env أو appsettings.json احتواية:

    • مفاتيح وأسرار واجهة برمجة التطبيقات
    • معرف المستأجر
    • معرف العميل
    • معرف Blueprint ID (إذا كنت تستخدم المصادقة الوكيلية)

    التحقق:

    اختبر بطلب بسيط في ملعب الوكلاء. يجب أن تتلقى ردا بدون أخطاء 401.

  • مشاكل الأداة والإشعارات

    تشمل هذه المشاكل مشاكل في استدعاءات الأدوات، وتفاعلات خوادم MCP، وتسليم الإشعارات.

لم يتم استلام البريد الإلكتروني

الأعراض: يشير العامل إلى أنه تم إرسال البريد الإلكتروني، ولكنك لم تتلقه

الحلول‏‎:

  • تحقق من مجلد الرسائل غير المزعجة أو البريد المزعج.
  • يمكن تأخير تسليم البريد الإلكتروني لبضع دقائق. انتظر حتى خمس دقائق.
  • تحقق من صحة عنوان البريد الإلكتروني للمستلم.
  • تحقق من سجلات الوكيل لأي أخطاء أثناء إرسال البريد الإلكتروني.

استجابات تعليق Word لا تعمل

المشكلة المعروفة: خدمة الإشعارات حاليا لا تستطيع الرد مباشرة على تعليقات وورد. يتم تطوير هذه الوظيفة.

الرسائل لا تصل إلى الوكيل

العرض: تطبيق الوكيل لا يستقبل الرسائل التي ترسل إلى الوكيل في Teams.

الأسباب المحتملة:

  • بوابة المطورين غير مهيأة مع مخطط الوكيل.
  • مشاكل تطبيق الويب في Azure (فشل في النشر، التطبيق لا يعمل، أخطاء في الإعدادات).
  • نسخة الوكيل غير منشأة بشكل صحيح في Teams.

الحلول‏‎:

  • تحقق من تكوين بوابة المطورين:

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

  • تحقق من Azure Web App health:

    إذا قمت بنشر وكيلك على Azure، تحقق من أن تطبيق الويب يعمل بشكل صحيح:

    1. انتقل إلى مدخل Azure.
    2. اذهب إلى مورد تطبيق الويب الخاص بك.
    3. تحقق منحالة> (يجب أن يظهر "قيد التشغيل").
    4. تحقق من تدفق السجلات تحت قسم المراقبة بحثا عن أخطاء وقت التشغيل.
    5. راجع سجلات مركز النشر للتحقق من نجاح النشر.
    6. تحقق من إعدادات الإعدادات>تحتوي على جميع المتغيرات البيئية المطلوبة.

  • تحقق من إنشاء نسخة الوكيل:

    تأكد من إنشاء نسخة الوكيل بشكل صحيح في Microsoft Teams:

    1. افتح Microsoft Teams.
    2. اذهب إلى التطبيقات وابحث عن وكيلك.
    3. تحقق من ظهور الوكيل في نتائج البحث.
    4. إذا لم يتم العثور عليه، تحقق من أنه منشور في مركز إدارة Microsoft 365 - Agents.
    5. أنشئ نسخة جديدة باختيار إضافة إلى وكيلك.
    6. للحصول على تعليمات تفصيلية، راجع وكلاء الخدمة.
  • Last updated on