إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
في هذا البدء السريع، تقوم بتوصيل وكيل موجود بالوكيل 365 باستخدام مهارات الوكيل 365 في مساعد البرمجة الخاص بك. يبدأ المسار بتسجيل الوكيل، ثم يضيف القدرات التي تختارها، وينتهي بالتحقق من الصحة. إذا أنشأت زميل ذكاء اصطناعي، والذي يتطلب برنامج معاينة Frontier، يمكنك أيضا اختباره محليا.
كل خطوة تذكر المهارة التي تتعامل معها وتعرض نموذجا للطلب. تستدعي مهارة بذكر النتيجة، وليس بكتابة اسم المهارة.
المتطلبات المسبقه
- وكيل موجود على مكدس مدعوم: Python، Node.js، أو .NET.
- مستأجر Microsoft مع تفعيل Agent 365. سجل الدخول كمسؤول عام، أو كمطور معرف وكيل مع وجود مسؤول عالمي متاح لإكمال منح أمن OAuth.
- اشتراك في Azure مع إذن لإنشاء الموارد.
- مساعد البرمجة المدعوم: Claude Code، GitHub Copilot CLI، أو وضع وكيل VS Code.
- كان GitHub CLI (
gh)، يستخدم لتثبيت المهارات.
يعتمد الترخيص على القدرات التي تتبناها:
- الهوية. لا يوجد ترخيص إضافي. يجب أن يكون لدى المستأجر تفعيل 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. أعد تشغيل مساعدك بعد ذلك ليتعلم المهارات الجديدة.
إعداد واكتشاف المشروع
افتح مشروع الوكيل في مساعد البرمجة الخاص بك، ثم شغل:
المهارة: a365-setup
أنشأ هذا المشروع للعميل 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 Advanced hunting لكنها لا تظهر في أي من الأسطح الثلاثة. امتداد الجذر هو الامتداد الأعلى المستوى الذي يصدره SDK لاستدعاء وكيل واحد؛ كل استدعاء أداة وحدث استنتاج يخضع داخله.
Connect بيانات Microsoft 365
أكمل هذه الخطوة في أي من المسارين إذا قرأ وكيلك بيانات Microsoft 365 أو تصرف بناء عليها. تتطلب أدوات Work IQ نموذج إذن مفوض، لذا يتم تخطي هذه الخطوة تلقائيا إذا اخترت S2S في خطوة الملاحظة.
المهارة: add-workiq-tools
توصيل بريد وجدول العمل في 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.
Troubleshoot
استخدم الجدول التالي لتحديد وحل المشكلات الشائعة عند توصيل وكيلك بالوكيل 365.
| عَرَض | القرار |
|---|---|
| مساعد البرمجة يصف الأوامر لكنه لا يشغلها | استخدم وضعا يوفر وصولا عبر الطرفية. في VS Code، استخدم وضع الوكيل. أوضاع السؤال والتحرير لا يمكنها تشغيل أوامر الطرفية. |
| الإعداد يفيد بعدم وجود متطلبات Azure | أكمل المتطلبات المسبقة التي a365-setup تدرج، ثم أعد تشغيل المهارة مرة أخرى. |
| فشل تسجيل المخطط، أو أن أوامر CLI تعيد أخطاء التفويض | تأكد من تسجيل الدخول بحساب لديه إذن بتسجيل مخططات هوية الوكيل في المستأجر. |
| لا يظهر أي بيانات عن بعد | تأكد من أن مستخدما واحدا على الأقل في المستأجر لديه ترخيص Microsoft 365 E7 أو Microsoft Agent 365 معين، ثم تأكد من أن التشغيل يصدر فترة صلاحية invoke_agent في جذورها، ثم تأكد من أن وضع المصادقة الذي اخترته يطابق بيئتك. اطلب من مساعد البرمجة التحقق من تكامل Agent 365؛ مهارة المدقق المثبتة يمكنها تشخيص الأجهزة. |
| يبدو أن هناك خطوة تم تخطيها | المهارات واعية للدولة وتتجاوز الأعمال التي تم تركيبها بالفعل، لذا من المحتمل أن تكون الخطوة مكتملة بالفعل. شغل المهارة المحددة مرة أخرى واذكر النتيجة بشكل صريح. |
| يجب أن تتغير قيم التكوين بعد الإعداد | إذا كان إعدادك يستخدم a365.config.json، قم بتحريره وإعادة تشغيله a365 config init -c ./a365.config.json، ثم أعد تشغيل المهارة المطلوبة. |