تجيب هذه المقالة على الأسئلة الشائعة حول مجموعة تطوير البرمجيات للعامل 365: ما الذي يفعله وما لا يفعله، ومتى تحتاجه، وما هي القدرات المتاحة، وكيف تعمل الهوية، وكيفية التحقق من صحة التكامل.
النطاق والموقع
هل يمكنني بناء وكيل باستخدام حزمة تطوير العامل 365؟
لا. حزمة تطوير التطوير ليست إطار عمل لبناء الوكلاء. ابن وكيل عملك باستخدام الإطار الذي اخترته، ثم استخدم مجموعة تطوير Agent 365 لدخوله إلى Agent 365. اطلع على متى تستخدم مجموعة تطوير Agent 365.
هل تقوم SDK بإجراء استدعاءات نماذج لغوية أم تنظم الخطوات؟
لا. وكيلك يستمر في إجراء استدعاءات النماذج، وتبقى التنسيق ضمن إطار عملك أو وقت تشغيلك. انظر مجموعة تطوير الوكيل 365 ونظام الوكلاء البيئي.
هل تستضيف SDK وكيلي أو تنشره؟
لا. وكيلك يدير أينما يدار اليوم. انظر كيف يختلف SDK الخاص ب Agent 365؟
هل تنفذ مجموعة تطوير البرمجيات (SDK) استدعاءات أدوات وكيلي؟
لا. خوادم بروتوكول السياق النموذجي (MCP) التي تحكم سجلات SDK؛ التنفيذ يبقى ضمن وقت تشغيلك. انظر مجموعة تطوير الوكيل 365 ونظام الوكلاء البيئي.
هل تحل حزمة تطوير البرمجيات محل إطار عمل وكيلي الخاص بي؟
لا. احتفظ بنموذجك، إطار عملك، وقت التشغيل، ومضيفك. تعمل حزمة تطوير البرمجيات جنبا إلى جنب مع هذه النقاط وتضيف الهوية، وقابلية الملاحظة، والأدوات، والإشعارات. للحدود طبقة بطبقة، انظر نظرة عامة على مجموعة تطوير العامل 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 مخصص للوكلاء الذين تبناؤهم باستخدام SDK أو إطار عمل للوكيل، ويمنحك تحكما على مستوى الكود. انظر مقارنة آليات تكامل العامل 365.
وكيل أعمالي يعمل خارج Azure. هل لا يزال بإمكاني استخدام مجموعة تطوير البرمجيات؟
نعم. حزمة تطوير الاتجاهات لا تغير مكان عمل وكيلك. يعمل مع وكلاء مستضافين على Azure أو AWS أو Google Cloud أو الأنظمة المحلية. انظر دورة حياة تطوير وكيل 365.
القدرات
هل يجب أن أتبنى جميع القدرات الأربع؟
لا، لكن لديهم متطلبات مسبقة. يدعم مخطط هوية الوكيل أساس قدرات الهوية والأدوات والإشعارات، كما تتطلب الإشعارات حساب مستخدم الوكيل، وهو متاح فقط للمستأجرين المشاركين في برنامج معاينة فرونتير. تعمل ميزة الملاحظة أيضا مع تسجيل تطبيق Microsoft Entra القياسي. بعيدا عن ذلك، أضف القدرات بأي ترتيب. انظر التحقق من الإشعارات.
أي قدرة يجب أن أبدأ بها؟
الهوية. التسجيل هو ما يجعل الوكيل مرئيا في الوكيل 365، لذا ابدأ من هناك. أضف الملاحظة بعد ذلك، عندما تحتاج إلى رؤية تشغيلية. راجع تسجيل الوكيلوالجهاز للملاحظة.
أين تذهب بيانات التليمترية الخاصة بي؟
تظهر امتدادات الوكيل في Microsoft Defender وMicrosoft Purview ومركز مسؤولي Microsoft 365.
هناك أمران يمكن أن يجعلا التليمترية تبدو وكأنها اختفت، رغم أن الابتلاع يعود ب HTTP 200.
إذا لم يكن لدى أي مستخدم في المستأجر ترخيص Microsoft 365 E7 أو Microsoft Agent 365 معين، يتم إسقاط الطلب بالكامل.
إذا لم يكن للسلسلة امتداد صالح invoke_agent في جذورها، فإن الفترات لا تزال قابلة للاستفسار في Defender Advanced hunting لكنها لا تظهر في أي من الأسطح الثلاثة.
انظر أين تظهر بياناتكوحدد وشروط الإسقاط.
ما هو Work IQ؟
Work IQ هو مجموعة خوادم MCP الخاضعة للرقابة التي تعرض Microsoft 365 أعباء العمل مثل البريد، التقويم، Word، SharePoint، وTeams لوكيلك تحت سيطرة المسؤول. برنامج Work IQ MCP قيد العرض ويتطلب رخصة Microsoft 365 Copilot. انظر التحقق من الأدوات.
ما هي مصادر الإشعارات المدعومة؟
تعليقات Teams وOutlook وWord والبريد الإلكتروني. تتطلب الإشعارات حساب مستخدم الوكيل، وهو متاح فقط للمستأجرين المشاركين في برنامج معاينة فرونتير. راجع أنواع الإشعاراتوالتحقق من الإشعارات.
الهوية
هل يحتاج وكيلي إلى هويته الخاصة؟
كل تكامل مع Agent 365 يحتاج إلى نموذج هوية، لكن هذا لا يعني دائما إعطاء الوكيل حساب مستخدم خاص به. يمكن للوكيل استخدام S2S ليعمل كهوية وكيل، أو OBO ليعمل نيابة عن مستخدم مسجل، أو Agentic-User ليعمل من خلال حساب المستخدم Microsoft Entra الخاص به. اختر الوضع الذي يتوافق مع عمل الوكيل والأصوات وموارد Microsoft 365 المطلوبة. انظر هوية الوكيل.
ما الفرق بين مخطط هوية الوكيل وهوية الوكيل؟
المخطط هو القالب القابل لإعادة الاستخدام الذي يحمل بيانات الاعتماد والأصوات المعلنة لنوع من الوكلاء. هوية الوكيل هي الحساب الذي يصادق عليه الوكيل الفردي. مخطط واحد يمكن أن ينشئ العديد من هويات الوكلاء. انظر كائنات الهويةوS2S، هوية الوكيل المشتقة من المخطط.
أين تخزن بيانات اعتماد وكيلي؟
على المخطط، وليس على هوية العميل. نظرا لأن المخطط المخترق يؤثر على كل وكيل يتم إنشاؤه منه، اعتبر عدد المخططات قرارا بحدود الأمان. انظر هوية الوكيل.
كم عدد المخططات التي يجب أن أنشئها؟
بقدر ما تحتاج، يجب فصل حدود الاعتماد والتصريح. هويات الوكلاء فقط التي يمكنها مشاركة بيانات اعتماد المخطط والأمنات الموروثة بأمان. انظر أساس الهويةو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 هذا السير العملي. استخدم المهارات بدلا من ذلك.
إذا كان مساعد البرمجة الخاص بك يكشف عن القدرة الداخلية للتحقق من الصحة والتشخيص، يمكنك طلبه التحقق من صحة تكامل العميل 365؛ ويشار إليها داخليا أيضا باسم a365-code-validator.
يعتمد التوفر على المساعد وحزمة المهارات المثبتة. انظر مهارات العميل 365.
هل يجب أن أستخدم المهارات؟
لا. يمكنك تنفيذ كل خطوة يدويا. المهارات تناسب الإعدادات القياسية والبدء المتكرر؛ الإعداد اليدوي يناسب البيئات غير القياسية وحل المشكلة. انظر متى تستخدم المهارات.
هل من الآمن تشغيل مهارة أكثر من مرة؟
نعم. المهارات تكون إضافية وذات قدرة ذاتية، لذا يتم تخطي الخطوات المكتملة بدلا من تكرارها. انظر السلامة والتكرار.
بدت مهارة وكأنها تخطت خطوة. هل هذه مشكلة؟
عادة لا. المهارات تتجاوز العمل الذي تم تكوينه بالفعل. شغل المهارة المحددة مرة أخرى واذكر النتيجة صراحة إذا أردت التأكد. انظر السلامة والتكرار.
هل يمكنني الاختبار قبل النشر على السحابة؟
على مسار زميل الذكاء الاصطناعي، نعم.
تشغل هذه test-local المهارة وكيلك جنبا إلى جنب مع Agents Playground، وهو حزام اختبار محلي، لاختبار الدخان.
يتصل Agents Playground عبر نقطة نهاية رسائل الوكلاء، لذا لا ينطبق على الوكلاء العاديين.
انظر المهارات السبعواختبار الوكيل في ملعب الوكلاء.
التحقق من الصحة
كيف أؤكد أن التكامل قد نجح؟
اعمل من خلال قائمة التحقق من صحة حزمة تطوير Agent 365.
وكيلي يتصرف بشكل مختلف بعد الاندماج. ما الخطأ الذي حدث؟
حزمة تطوير التطوير توسع وكيلك بدلا من استبدال أي جزء منه. تحقق من أي تغيير سلوكي قبل النشر: الكود المولد، تعارضات التبعيات، التكوين، وتوافق SDK كلها أسباب محتملة. ابدأ بالتحقق من السلوك الحالي.