مشاركة عبر

اختبار العَوامِل باِسْتِخْدَام Microsoft Agent 365 SDK

مهم

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

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

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

المتطلبات

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

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

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

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

يغطي هذا القسم تعيين متغيرات البيئة، ومصادقة بيئة التطوير الخاصة بك، وإعداد العامل الذي يعمل بالطاقة Agent 365 للاختبار.

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

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

  2. تكوين LLM - الحصول على مفاتيح API وتكوين إعدادات OpenAI أو Azure OpenAI

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

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

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

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

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

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

cp .env.template .env

إشعار

راجع نماذج Microsoft Agent 365 SDK للعثور على قوالب التكوين التي تعرض الحقول المطلوبة.

الخطوة 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: قم بتكوين المصادقة لوكيلك

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

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

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

استخدم أمر 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

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

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

أولا، استخدم 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

مطلوب تكوين نقطة نهاية 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 لم يتم تحديده، تعيينه افتراضيا إلى نقطة نهاية الإنتاج.

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

قم بتكوين هذه المتغيرات المطلوبة لتمكين التسجيل والتتبع الموزع لعاملك. تَعَرَّفْ على المَزِيدُ حَوْلَ ميزات إمكانية المراقبة وأفضل الممارسات

إشعار

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

المتغير الوصف افتراضي مثال
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.

إشعار

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

افتح محطة طرفية جديدة (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 ويعيد قائمة بالمواقع التي يمكنك الوصول إليها.

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

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

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

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

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

تتطلب الإعلامات تكوين الأداة المناسب وإعداد الإعلامات للعمل بشكل صحيح. يمكنك اختبار سيناريوهات مثل إعلامات البريد الإلكتروني أو تعليقات Word باِسْتِخْدَام ميزة النشاط المخصص.

لإرسال أنشطة مخصصة:

  1. بدء تشغيل وكيلك ووكلاء Playground
  2. في Agents Playground، انتقل إلى سخرية من نشاط ما>نشاط مخصص
  3. انسخ conversationId من النشاط (يتغير معرف المحادثة في كل مرة يتم فيها إعادة تشغيل Agents Playground)
  4. الصق نشاطك المخصص JSON وقم بتحديث personal-chat-id الحقل بمعرف المحادثة الذي نسخته. راجع مثال إعلام البريد الإلكتروني
  5. حدد ارسال نشاط
  6. عرض النتيجة في كل من محادثة الدردشة ولوحة السجل

‏‫إعلام البريد الإلكتروني

هذا التكوين يحاكي بريدا إلكترونيا مرسل إلى الوكيل. استبدل قيم العنصر النائب بتفاصيل العامل الفعلي:

{
  "type": "message",
  "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "timestamp": "2025-09-24T17:40:19+00:00",
  "serviceUrl": "http://localhost:56150/_connector",
  "channelId": "agents",
  "name": "emailNotification",
  "from": {
    "id": "manager@contoso.com",
    "name": "Agent Manager",
    "role": "user"
  },
  "recipient": {
    "id": "agent@contoso.com",
    "name": "Agent",
    "agenticUserId": "<your-agentic-user-id>",
    "agenticAppId": "<your-agent-app-id>",
    "tenantId": "<your-tenant-id>"
  },
  "conversation": {
    "conversationType": "personal",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "personal-chat-id"
  },
  "membersAdded": [],
  "membersRemoved": [],
  "reactionsAdded": [],
  "reactionsRemoved": [],
  "locale": "en-US",
  "attachments": [],
  "entities": [
    {
      "id": "email",
      "type": "productInfo"
    },
    {
      "type": "clientInfo",
      "locale": "en-US",
      "timezone": null
    },
    {
      "type": "emailNotification",
      "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
      "conversationId": "personal-chat-id",
      "htmlBody": "<body dir=\"ltr\">\n<div class=\"elementToProof\" style=\"font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);\">\nYour email message content here</div>\n\n\n</body>"
    }
  ],
  "channelData": {
    "tenant": {
      "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
    }
  },
  "listenFor": [],
  "textHighlights": []
}

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

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

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

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

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

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

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

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

مشكلات اتصال Agents Playground

الأعراض: لا يمكن ل Agents Playground الاتصال بوكيلك

الحلول‏‎:

  • تحقق من تشغيل خَادِم الوكيل
  • تحقق من تطابق أرقام المنافذ بين الوكيل الخاص بك وS agents Playground
  • تأكد من عدم وجود قواعد جدار حماية تمنع الاتصالات المحلية
  • حاول إعادة تشغيل كل من العامل وS agents Playground

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

الأعراض: أخطاء غير متوقعة أو ميزات مفقودة في 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 استجابة غير مصرح بها

الحل: تنتهي صلاحية الرموز المميزة للحامل بعد حوالي ساعة واحدة. الحصول على رمز مميز جديد وتحديث التكوين الخاص بك.

أخطاء المصادقة الوكيلة في Python

الأعراض: خطأ في الحصول على رمز مميز للمثيل العامل

الحل: تحقق من ALT_BLUEPRINT_NAME الإعداد في .env:

# Change from:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection

# To:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION

مشاكل الأَدَوَات والإعلامات

تتضمن هذه المشكلات مشكلات في استدعاءات الأَدَوَات وتفاعلات خَادِم MCP وتسليم الإعلامات.

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

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

الحلول‏‎:

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

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

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

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

العرض: الرسائل المرسلة إلى الوكيل في Teams لا تستقبل من قبل تطبيق الوكيل الخاص بك

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

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

الحلول‏‎:

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

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

  2. تحقق من Azure Web App health:

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

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

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

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

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

الحصول على التعليمات

إذا واجهت مشكلات غير مشمولة في قسم استكشاف الأخطاء وإصلاحها هذا، فاستكشف هذه الموارد:

مستودعات Microsoft Agent 365 SDK

المزيد من الدعم

  • مراجعة نموذج التعليمات البرمجية والوثائق في مستودعات Microsoft Agent 365 SDK
  • إرسال المشكلات من خلال GitHub Issues في المستودع ذي الصلة

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

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

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

  • Last updated on