إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
في هذا البدء السريع، تقوم بتوصيل وكيل موجود بالوكيل 365 باستخدام مهارات الوكيل 365 في مساعد البرمجة الخاص بك. يبدأ المسار بتسجيل الوكيل، ثم يضيف القدرات التي تختارها، وينتهي بالتحقق من الصحة. إذا أنشأت مساعدًا ذكيًا، وهو ما يتطلب برنامج المعاينة Frontier، فيمكنك أيضًا اختباره محليًا.
كل خطوة تذكر المهارة التي تتعامل معها وتعرض نموذجا للطلب. تستدعي مهارة بذكر النتيجة، وليس بكتابة اسم المهارة.
المتطلبات المسبقه
- وكيل حالي ضمن حزمة تقنية مدعومة: Python أو Node.js أو .NET.
- مستأجر Microsoft مع تفعيل Agent 365. سجل الدخول كمسؤول عام، أو كمطور معرف وكيل مع وجود مسؤول عالمي متاح لإكمال منح أمن OAuth.
- اشتراك في Azure مع إذن لإنشاء الموارد.
- أداة مساعدة للبرمجة مدعومة: Claude Code، أو GitHub Copilot CLI، أو وضع الوكيل في VS Code.
- كان GitHub CLI (
gh)، يستخدم لتثبيت المهارات.
ملحوظة
إعداد Agent 365 يستخدم تطبيق Agent 365 CLI المؤسسي المدار من Microsoft عندما يكون متاحا في مستأجرك. لا تحتاج إلى إنشاء تطبيق عميل مخصص لهذا المسار. إذا لم يكن التطبيق المؤسسي متاحا، فإن الإعداد يعود إلى تطبيق مملوك للمستأجر يدعى Agent 365 CLI. يظل تطبيق العميل المخصص المهيأ صراحة مدعوما. لمزيد من المعلومات، راجع تسجيل تطبيق العميل المخصص ل Agent 365 CLI.
يعتمد الترخيص على القدرات التي تتبناها:
- الهوية. لا يوجد ترخيص إضافي. يجب أن يكون لدى المستأجر تفعيل Agent 365.
- الملاحظة. على الأقل مستخدم واحد في المستأجر يحمل ترخيص Microsoft 365 E7 أو Microsoft Agent 365 معين. من دونه، تُسقَط بيانات القياس عن بُعد بصمت.
- الأدوات (ذكاء العمل). رخصة Microsoft 365 Copilot. برنامج Work IQ MCP في مرحلة المعاينة.
- الإشعارات. حساب مستخدم الوكيل، متاح فقط للمستأجرين في برنامج معاينة Frontier.
نصيحة
أولا تأكد من أن SDK هو آلية التكامل المناسبة لوكيلك. انظر اختر خيار التكامل الخاص بك. للاطلاع على نموذج الهوية وراء التسجيل، بما في ذلك المخططات والأذونات والموافقة، انظر المفاهيم الأساسية لهوية الوكيلومعرف معرف عامل Microsoft Entra.
تثبيت المهارات
قم بتثبيت المهارات في مساعد البرمجة الخاص بك:
gh skill add microsoft/agent365-skills
ينطبق الأمر نفسه على Claude Code وGitHub Copilot CLI ووضع الوكيل في VS Code. أعد تشغيل مساعدك بعد ذلك ليتعلم المهارات الجديدة.
إعداد واكتشاف المشروع
افتح مشروع الوكيل في مساعدك البرمجي، ثم شغّل الأمر التالي:
المهارة: a365-setup
قم بإعداد هذا المشروع لـ Agent 365
أجب على الأسئلة المتعلقة بوكيلك. عند اكتمال المهارة، يتم التحقق من استيفائك للمتطلبات الأساسية واكتشاف المكدس التقني لديك.
يقوم الإعداد بحفظ المعرفات والنقاط النهائية المولدة إلى a365.generated.config.json. إعداد الوكيل القياسي لا يحتاج إلى ملف تهيئة مُنشأ يدويًا؛ أما إعداد الزميل المدعوم بالذكاء الاصطناعي فيتطلب a365.config.json مُنشأً يدويًا.
a365-setup ثم يوجهك في أحد مسارين للتموين. أكمل الخطة التي يختارها، ثم تابع الخطوات المشتركة التالية:
- وكيل ستاندرد، الذي لا يحتاج إلى حساب مستخدم خاص به. تابع مع تسجيل الوكيل.
- زميل ذكاء اصطناعي، وهو كذلك. الانتقال إلى إضافة المراسلة والإشعارات. يتطلب هذا المسار برنامج Frontier التجريبي.
يستمر كلا المسارين عند الأداة للملاحظة.
تسجيل الوكيل
أكمل هذه الخطوة إذا كان a365-setup قد وجّهك إلى المسار القياسي للوكيل.
المهارة: make-a365-agent
تسجيل هذا الوكيل لدى الوكيل 365
عندما تنتهي المهارة، يكون لدى وكيلك مخطط مسجّل في Microsoft Entra، وهوية وكيل تم إنشاؤها استنادًا إليه، والأذونات التي يحتاج إليها. يوفر التسجيل رؤية الكتالوج؛ خطوة الملاحظة تضيف بيانات التليمترية.
أضف الرسائل والإشعارات
أكمل هذه الخطوة إذا كان a365-setup قد وجّهك إلى مسار زميل العمل المدعوم بالذكاء الاصطناعي.
المهارة: make-ai-teammate
أضف الرسائل والإشعارات إلى هذا الوكيل
تضيف المهارة طبقة الاستضافة وتوجيه الرسائل، وتسجل الوكيل. يمكن للناس بعد ذلك الوصول إليه عبر Teams وOutlook وتعليقات Word والبريد الإلكتروني.
مهم
تمنح هذه الخطوة وكيلك حساب مستخدم خاص به، بما في ذلك صندوق بريد وحضور في Teams. هذه القدرة متاحة فقط للمستأجرين المشاركين في برنامج معاينة فرونتير. تجاوز هذه الخطوة إذا لم يكن مستأجرك مسجلا.
أداة للملاحظة
أكمل هذه الخطوة في أي من المسارين. المهارة تسأل عن نوع الوكيل الذي لديك.
المهارة: instrument-observability
أضف قابلية الرصد إلى هذا العامل
عند الطلب، اختر وضع المصادقة الذي يستخدمه وكيلك: OBO (نيابة عن مستخدم مسجل)، Agentic-User (حساب المستخدم الخاص بالوكيل الذي يتطلب برنامج معاينة Frontier)، أو S2S (خدمة إلى خدمة، للعمليات الخلفية). يستخدم المصدر نفس الوضع الذي يصادق عليه وكيلك، لذا اختر الوضع الذي يطابق نموذج الإذن الخاص بك. انظر هوية الوكيل.
بعد إجراء تشغيل تجريبي، تظهر النطاقات الخاصة بالوكيل في Microsoft Defender وMicrosoft Purview ومركز مسؤولي Microsoft 365.
مهم
هناك أمران يمكن أن يجعلا التليمترية تبدو وكأنها اختفت، رغم أن الطلب يعيد HTTP 200. إذا لم يكن لدى أي مستخدم في المستأجر ترخيص Microsoft 365 E7 أو Microsoft Agent 365 معين، يتم إسقاط الطلب بالكامل؛ وجود وحدة SKU غير كافية. إذا لم يكن للتشغيل نطاق invoke_agent صالح في الجذر، فستظل النطاقات قابلة للاستعلام في ميزة الصيد المتقدم في Defender، لكنها لن تظهر في أي من الواجهات الثلاث. النطاق الجذر هو النطاق ذو المستوى الأعلى الذي تُنشئه حزمة SDK لعملية استدعاء واحدة للوكيل؛ ويندرج ضمنه كل استدعاء أداة وكل حدث استدلال.
ربط بيانات Microsoft 365
أكمل هذه الخطوة في أي من المسارين إذا قرأ وكيلك بيانات Microsoft 365 أو تصرف بناء عليها. تتطلب أدوات Work IQ نموذج إذن مفوض، لذا يتم تخطي هذه الخطوة تلقائيا إذا اخترت S2S في خطوة الملاحظة.
المهارة: add-workiq-tools
ربط بريد وتقويم Work IQ
حدد أعباء العمل التي تحتاجها، مثل البريد أو التقويم أو Word. تربط المهارة خوادم Work IQ MCP المطابقة، ويمكن لوكيلك بعد ذلك الوصول إلى تلك البيانات تحت سيطرة المسؤول.
مهم
برنامج Work IQ MCP قيد العرض ويتطلب رخصة Microsoft 365 Copilot. يجب على المسؤول العالمي منح أذونات OAuth لخوادم Work IQ قبل أن يتمكن وكيلك من الاتصال بها. راجع إضافة وإدارة الأدوات.
اختبر بشكل محلي
أكمل هذه الخطوة إذا كنت ضمن مسار المساعد الذكي، والذي يتطلب برنامج Frontier التجريبي. يتصل Agents Playground عبر نقطة نهاية رسائل الوكلاء، لذا لا ينطبق على الوكلاء العاديين.
المهارة: test-local
اختبر هذا الوكيل محليا
وكيلك يواجه Agents Playground، وهو حزام اختبار محلي، لذا يمكنك اختباره بالدخان قبل النشر.
تحقق من صحة النتيجة
يجب على وكيلك أن يبدأ ويرد كما فعل قبل الانضمام إليه، ويظهر في العميل 365 تحت هويته المسجلة.
إذا كان مساعد البرمجة الخاص بك يكشف عن قدرة التحقق والتشخيص الداخلية في Agent 365، اطلب منه التحقق من صحة هذا التكامل مع Agent 365 لتشغيل الفحص المسبق على مستوى الكود ضد المشروع. يتحقق من وجود فجوات في أدوات القياس، وعناصر Microsoft Entra، والمراسلة، والوصول إلى الأدوات، والتكوينات ذات الصلة. تعرف هذه القدرة أيضا داخليا باسم a365-code-validator؛ تعتمد التوفر والتوجيه الدقيق على مساعد البرمجة وحزمة المهارات المثبتة.
قبل أن تنشر اللعبة، اعمل على قائمة التحقق من صحة حزمة تطوير Agent 365.
استكشاف الأخطاء وإصلاحها
استخدم الجدول التالي لتحديد وحل المشكلات الشائعة عند توصيل وكيلك بالوكيل 365.
| عَرَض | القرار |
|---|---|
| مساعد البرمجة يصف الأوامر لكنه لا يشغلها | استخدم وضعا يوفر وصولا عبر الطرفية. في VS Code، استخدم وضع الوكيل. أوضاع السؤال والتحرير لا يمكنها تشغيل أوامر الطرفية. |
| برنامج الإعداد يشير إلى افتقاد المتطلبات الأساسية لـ Azure | أكمل المتطلبات المسبقة التي a365-setup تدرج، ثم أعد تشغيل المهارة مرة أخرى. |
| يفشل تسجيل المخطط، أو تُرجع أوامر CLI أخطاء في التخويل | تأكد من تسجيل الدخول بحساب لديه إذن بتسجيل مخططات هوية الوكيل في المستأجر. |
| لا يظهر القياس عن بُعد | تأكد من أن مستخدمًا واحدًا على الأقل في المستأجر مُعيَّن له ترخيص Microsoft 365 E7 أو Microsoft Agent 365، ثم تأكد من أن عملية التشغيل تُنتج عنصر invoke_agent span صالحًا في الجذر، ثم تأكد من أن وضع المصادقة الذي اخترته يطابق بيئتك. اطلب من مساعد البرمجة التحقق من تكامل Agent 365؛ مهارة المدقق المثبتة يمكنها تشخيص الأجهزة. |
| يبدو أن هناك خطوة تم تخطيها | المهارات مدركة للحالة وتتجاوز المهام الموصولة بالفعل، لذا يُرجَّح أن الخطوة اكتملت بالفعل. شغّل المهارة المحددة مرة أخرى واذكر النتيجة صراحةً. |
| يلزم تغيير قيم التكوين بعد الإعداد | إذا كان إعدادك يستخدم a365.config.json، قم بتحريره وإعادة تشغيله a365 config init -c ./a365.config.json، ثم أعد تشغيل المهارة المطلوبة. |