تجيب هذه المقالة على الأسئلة الشائعة حول مجموعة تطوير البرمجيات للعامل 365: ما الذي يفعله وما لا يفعله، ومتى تحتاجه، وما هي القدرات المتاحة، وكيف تعمل الهوية، وكيفية التحقق من صحة التكامل.
النطاق والموقع
هل يمكنني بناء وكيل باستخدام حزمة تطوير العامل 365؟
لا. حزمة تطوير البرمجيات ليست إطار عمل لبناء الوكلاء. ابن وكيل عملك باستخدام الإطار الذي اخترته، ثم استخدم مجموعة تطوير Agent 365 لدخوله إلى Agent 365. اطلع على متى تستخدم مجموعة تطوير Agent 365.
هل تقوم SDK بإجراء استدعاءات نماذج لغوية أم تنظم الخطوات؟
لا. يواصل وكيلك إجراء استدعاءاته الخاصة للنموذج، ويظل التنسيق داخل إطار العمل أو بيئة وقت التشغيل لديك. انظر حزمة تطوير البرامج (SDK) لـ Agent 365 ومنظومة الوكلاء.
هل تستضيف SDK وكيلي أو تنشره؟
لا. يعمل وكيلك حيثما يعمل اليوم. انظر كيف يختلف SDK الخاص ب Agent 365؟
هل تنفذ مجموعة تطوير البرمجيات (SDK) استدعاءات أدوات وكيلي؟
لا. تسجّل حزمة SDK خوادم بروتوكول سياق النموذج (MCP) الخاضعة للحوكمة؛ ويظل التنفيذ ضمن بيئة التشغيل لديك. راجع مجموعة أدوات تطوير البرامج Agent 365 والنظام البنئي للوكلاء.
هل تحل حزمة تطوير البرمجيات محل إطار عمل وكيلي الخاص بي؟
لا. احتفظ بنموذجك، إطار عملك، وقت التشغيل، ومضيفك. تعمل حزمة تطوير البرمجيات جنبا إلى جنب مع هذه النقاط وتضيف الهوية، وقابلية الملاحظة، والأدوات، والإشعارات. للتعرّف على الحدود بين الطبقات، راجع نظرة عامة على مجموعة أدوات تطوير البرامج Agent 365.
كيف يختلف مجموعة تطوير Agent 365 عن مجموعة Microsoft 365 Agents SDK؟
يقوم Microsoft 365 Agents SDK ببناء وكلاء حوارية، ويتعامل مع الاتصال بالقنوات وحالة المحادثة. تُوسّع حزمة تطوير البرامج لـ Agent 365 إمكانات الوكيل الذي سبق أن أنشأته. يعمل الاثنان معا. انظر نظرة عامة على مجموعة تطوير Agent 365.
ما هي اللغات التي يدعمها SDK؟
Python، جافاسكريبت، و.NET. انظر حزم SDK الخاصة بالعميل 365.
اختيار آلية التكامل
هل أحتاج إلى حزمة تطوير البرمجيات؟
ليس دائما. إذا كان التكامل المدمج أو مزامنة السجل يوفر بالفعل الإمكانيات التي يحتاجها وكيلك، فقد لا تحتاج إلى SDK. انظر اختر خيار التكامل الخاص بك.
متى يكون التكامل المدمج كافيا؟
عندما يوفر مسار المنصة بالفعل قدرات Agent 365 المطلوبة في سيناريوك. يمكن أن تندرج Copilot Studio و منصة Azure للذكاء الاصطناعي ضمن هذه الفئة، لكن الدعم يعتمد على كيفية بناء الوكيل ومصادقته واستضافته. امتلاك أو نشر الكود لا يتطلب بحد ذاته مجموعة تطوير البرمجيات. انظر مقارنة آليات تكامل العامل 365.
ما الفرق بين مزامنة السجل وتكامل SDK؟
تجلب مزامنة السجل وكلاء من منصات الوكلاء المتصلة، مثل Google Vertex AI وAmazon Bedrock، إلى Agent 365 من خلال تكوين على مستوى المنصة. تكامل حزمة تطوير البرامج (SDK) مخصص للوكلاء الذين تنشئهم باستخدام حزمة تطوير برامج للوكلاء أو إطار عمل، ويمنحك تحكمًا على مستوى الشفرة البرمجية. انظر مقارنة آليات تكامل العامل 365.
وكيل أعمالي يعمل خارج Azure. هل لا يزال بإمكاني استخدام مجموعة تطوير البرمجيات؟
نعم. لا تغيّر حزمة تطوير البرمجيات مكان تشغيل وكيلك. يعمل مع وكلاء مستضافين على Azure أو AWS أو Google Cloud أو الأنظمة المحلية. انظر دورة حياة تطوير Agent 365.
القدرات
هل يجب أن أتبنى جميع القدرات الأربع؟
لا، لكن لديهم متطلبات مسبقة. يدعم مخطط هوية الوكيل أساس قدرات الهوية والأدوات والإشعارات، كما تتطلب الإشعارات حساب مستخدم الوكيل، وهو متاح فقط للمستأجرين المشاركين في برنامج معاينة فرونتير. تعمل ميزة الملاحظة أيضا مع تسجيل تطبيق Microsoft Entra القياسي. بعيدا عن ذلك، أضف القدرات بأي ترتيب. انظر التحقق من الإشعارات.
أي قدرة يجب أن أبدأ بها؟
الهوية. التسجيل هو ما يجعل الوكيل مرئيا في الوكيل 365، لذا ابدأ من هناك. أضف إمكانية المراقبة لاحقًا عندما تحتاج إلى رؤية واضحة للعمليات. راجع تسجيل الوكيلوالجهاز للملاحظة.
أين تذهب بيانات التليمترية الخاصة بي؟
تظهر امتدادات الوكيل في Microsoft Defender وMicrosoft Purview ومركز مسؤولي Microsoft 365.
هناك سببان قد يجعلان بيانات القياس عن بُعد تبدو كما لو أنها اختفت، رغم أن عملية استيعاب البيانات تعيد الرمز HTTP 200.
إذا لم يكن لدى أي مستخدم في المستأجر ترخيص Microsoft 365 E7 أو Microsoft Agent 365 معين، يتم إسقاط الطلب بالكامل.
إذا لم يكن للتشغيل نطاق صالح invoke_agent في الجذر، فلا يزال من الممكن الاستعلام عن النطاقات في Microsoft Defender Advanced Hunting، لكنها لا تظهر في أي من الواجهات الثلاث.
انظر أين تظهر بيانات الرصد الخاصة بعامل 365وحدود وظروف الإسقاط.
ما هو Work IQ؟
Work IQ هو مجموعة خوادم MCP الخاضعة للرقابة التي تعرض Microsoft 365 أعباء العمل مثل البريد، التقويم، Word، SharePoint، وTeams لوكيلك تحت سيطرة المسؤول. برنامج Work IQ MCP قيد العرض ويتطلب رخصة Microsoft 365 Copilot. انظر التحقق من الأدوات.
ما هي مصادر الإشعارات المدعومة؟
تعليقات Teams وOutlook وWord والبريد الإلكتروني. تتطلب الإشعارات حساب مستخدم الوكيل، وهو متاح فقط للمستأجرين المشاركين في برنامج معاينة فرونتير. راجع أنواع الإشعاراتوالتحقق من الإشعارات.
Identity
هل يحتاج وكيلي إلى هويته الخاصة؟
كل تكامل مع Agent 365 يحتاج إلى نموذج هوية، لكن هذا لا يعني دائما إعطاء الوكيل حساب مستخدم خاص به. يمكن للوكيل استخدام S2S ليعمل كهوية وكيل، أو OBO ليعمل نيابة عن مستخدم مسجل، أو Agentic-User ليعمل من خلال حساب المستخدم Microsoft Entra الخاص به. اختر الوضع الذي يتناسب مع عمل الوكيل وأذوناته وموارد Microsoft 365 المطلوبة. انظر هوية الوكيل.
ما الفرق بين مخطط هوية الوكيل وهوية الوكيل؟
المخطط هو القالب القابل لإعادة الاستخدام الذي يتضمن بيانات الاعتماد والأذونات المعلنة لفئة من الوكلاء. هوية الوكيل هي الحساب الذي يصادق عليه الوكيل الفردي. مخطط واحد يمكن أن ينشئ العديد من هويات الوكلاء. راجع كائنات الهوية وS2S، هوية الوكيل المشتقة من Blueprint.
أين تخزن بيانات اعتماد وكيلي؟
على المخطط، وليس على هوية الوكيل. نظرا لأن المخطط المخترق يؤثر على كل وكيل يتم إنشاؤه منه، اعتبر عدد المخططات قرارا بحدود الأمان. انظر هوية الوكيل.
كم عدد المخططات التي يجب أن أنشئها؟
أي عدد تحتاج إليه للحفاظ على حدود بيانات الاعتماد والأذونات منفصلة. اجمع فقط هويات الوكلاء التي يمكنها مشاركة بيانات اعتماد المخطط والأذونات الموروثة بأمان. انظر أساس الهويةوS2S، هوية الوكيل المشتقة من المخطط.
أي نموذج إذن يجب أن أستخدم؟
أذونات التطبيق للعمل من خدمة إلى خدمة، حيث يعمل العامل بأذوناته الخاصة. الأذونات المفوضة نيابة عن العمل، حيث يتصرف الوكيل وفقا لأصلاحيات وسياق المستخدم المسجل. انظر هوية الوكيل.
هل يحتاج وكيلي إلى ترخيص Microsoft 365؟
فقط إذا كان لديه حساب مستخدم للوكيل ويحتاج إلى خدمات مثل Teams أو Exchange أو SharePoint. الوكلاء الذين لديهم حساب مستخدم خاص بهم متاحون فقط للمستأجرين في برنامج معاينة Frontier. لا يزال ترخيص المستأجر ينطبق على قدرات أخرى: يتم حذف القياس عن بعد ما لم يكن لدى مستخدم واحد على الأقل في المستأجر ترخيص Microsoft 365 E7 أو Microsoft Agent 365 معين، ويتطلب Work IQ MCP رخصة Microsoft 365 Copilot. راجع حساب مستخدم الوكيل، التحقق من الهوية، التحقق من الملاحظة، وأدوات التحقق.
لماذا صندوق بريد وكيل عمالي غير متاح بعد؟
توفير الموارد قد يؤخر تعيين الترخيص. راجع قائمة التحقق من صحة SDK الخاص بالوكيل 365 للاطلاع على التوقيت المتوقع.
ما هو الراعي؟
الممثل التجاري مسؤول عن هدف الوكيل ودورة حياته. يُشترط وجود راعٍ واحد على الأقل لكل هوية وكيل ومخطط هوية وكيل. تستخدم فرق الأمن الجهة الراعية للوصول إلى شخص مسؤول أثناء وقوع حادثة. راجع الرعاةوالتحقق من الهوية.
الإعداد والمهارات
ما هي مهارات العميل 365؟
هناك طريقة لجعل مساعد برمجة، مثل GitHub Copilot CLI، يقوم بخطوات التكامل نيابة عنك. انظر مهارات العميل 365.
ما الذي حلّ محل سير العمل الخاص بإعداد instructions.md؟
استبدل Agent 365 Skills هذا السير العملي. استخدم المهارات بدلا من ذلك.
إذا كان مساعد البرمجة لديك يتيح الإمكانات الداخلية للتحقق والتشخيص، فيمكنك أن تطلب منه التحقق من تكامل Agent 365؛ ويُشار إليه أيضًا داخليًا باسم a365-code-validator.
يعتمد التوفر على المساعد وحزمة المهارات المثبتة. انظر مهارات العميل 365.
هل يجب أن أستخدم المهارات؟
لا. يمكنك تنفيذ كل خطوة يدويا. المهارات تناسب الإعدادات القياسية والبدء المتكرر؛ الإعداد اليدوي يناسب البيئات غير القياسية وحل المشكلة. انظر متى تستخدم المهارات.
هل من الآمن تشغيل مهارة أكثر من مرة؟
نعم. المهارات تكون إضافية وذات قدرة ذاتية، لذا يتم تخطي الخطوات المكتملة بدلا من تكرارها. انظر السلامة والتكرار.
بدا أن المهارة قد تخطت خطوة. هل هذه مشكلة؟
عادة لا. تتخطى المهارات المهام التي تم تكوينها بالفعل. شغل المهارة المحددة مرة أخرى واذكر النتيجة صراحة إذا أردت التأكد. انظر السلامة والتكرار.
هل يمكنني الاختبار قبل النشر على السحابة؟
على مسار زميل الذكاء الاصطناعي، نعم.
تشغل هذه test-local المهارة وكيلك جنبا إلى جنب مع Agents Playground، وهو حزام اختبار محلي، لاختبار الدخان.
يتصل Agents Playground عبر نقطة نهاية رسائل الوكلاء، لذا لا ينطبق على الوكلاء العاديين.
انظر المهارات السبعواختبار الوكيل في ملعب الوكلاء.
التحقق من الصحة
كيف أؤكد أن التكامل قد نجح؟
اعمل من خلال قائمة التحقق من صحة حزمة تطوير Agent 365.
يعمل وكيلي بشكل مختلف بعد التكامل. ما الخطأ الذي حدث؟
حزمة تطوير البرمجيات تُوسِّع إمكانات وكيلك بدلًا من استبدال أي جزء منه. تحقق من أي تغيير سلوكي قبل النشر: الكود المولد، تعارضات التبعيات، التكوين، وتوافق SDK كلها أسباب محتملة. ابدأ بالتحقق من السلوك الحالي.