بدء استخدام تطوير Agent 365

يعمل العميل 365 مع مجموعة من تنفيذات الوكيل. يمكن للعامل مساعدة المستخدمين عند الطلب، أو التشغيل بشكل مستقل في الخلفية، أو العمل بهوية المستخدم الخاصة به في Microsoft 365. يعد فهم النمط الذي يصف عاملك على أفضل نحو أمرا مهما لأنه يحدد نموذج هوية العامل، وما هو الوصول الذي لديه Microsoft 365 الموارد، وما هي خطوات دورة الحياة التي تنطبق.

أنواع العوامل

قبل أن تبدأ، اسأل نفسك: ما نوع العميل الذي أقوم ببنائه؟

هناك نوعان من العوامل اعتمادا على نوع الوصول الذي لديهم:

نوع العامل	نظرة عامة
العاملون	العمل نيابة عن مستخدم لديه وصول مفوض، أو العمل كتطبيق بأذونات محددة النطاق. مسجلة كتطبيقات Microsoft Entra أو مخططات هوية الوكيل.
زميل في فريق الذكاء الاصطناعي	العمل باستخدام هوية المستخدم الخاصة بهم في Microsoft 365، بما في ذلك علبة البريد ووجود Teams وإدخال الدليل. هذا النوع من الوكلاء يتوفر فقط للمستأجرين المشاركين في برنامج المعاينة الحدودية.

وكلاء

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

يأتي الوكلاء في جميع الأشكال. بعضها عبارة عن محادثة - يسأل المستخدم شيئا ويستجيب العامل. يعمل بعضها بهدوء في الخلفية - يتم تشغيله بواسطة جدول زمني أو حدث أو رسالة واردة - دون أي شخص يشارك بنشاط. البعض يفعل كليهما.

أمثلة على السيناريوهات:

• يطلب المستخدم من الوكيل تلخيص رسائل البريد الإلكتروني غير المقروءة وردود المسودة. يقوم العامل بالعمل، والوصول إلى الموارد التي يمكن للمستخدم الوصول إليها فقط، وإعادة توجيه النتيجة.
• يساعد وكيل خدمة العملاء مهندس الدعم على استعلام قواعد المعرفة الداخلية وإنشاء استجابات أثناء جلسة دعم مباشرة.
• يعمل وكيل مراقبة الامتثال كل ليلة، ويفحص مواقع SharePoint التي يُمنح الوكيل حق الوصول إليها بحثاً عن انتهاكات السياسات، ويقدم تقارير التدقيق - دون أن يراقبها أحد.
• يلتقط وكيل معالجة الطلبات أوامر مبيعات جديدة من قائمة انتظار، ويحدث CRM، ويرسل رسائل البريد الإلكتروني بالتأكيد - كل ذلك دون أن يقوم أي شخص ببدء تشغيله.

أساس الهوية:

تقليدياً، تقوم بتسجيل الوكلاء كتطبيقات Microsoft Entra. ولا يزال هذا النهج يعمل. من الآن فصاعدا، يمكنك أيضا إنشاء وكلاء على معرف عامل Microsoft Entra عبر مخطط هوية agent - التعريف المعتمد من قبل تكنولوجيا المعلومات والمفرض من قبل الحوكمة لقدرات العامل والوصول إلى الأدوات المسموح بها وقيود التوافق. البناء على مخطط هو المسار الموصى به للوكلاء الجدد. فهو يفتح الوصول المحكوم إلى أداة ذكاء العمل، وحماية البيانات Microsoft Purview، ومراقبة التهديدات Microsoft Defender، وحوكمة Entra ID - مما يجعل وكيلك هوية مؤسسة مدارة بالكامل من اليوم الأول.

زميل في فريق الذكاء الاصطناعي

مهم

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

يعمل زميل فريق الذكاء الاصطناعي في Microsoft 365 باستخدام هوية الوكيل الخاصة به. يمكنك تزويده بقدرات مثل إرسال البريد الإلكتروني وتلقيه من خلال علبة البريد الخاصة به، والمشاركة في Teams 1:1 ومحادثات المجموعة، والظهور في الدليل وبيانات التعريف التنظيمية مع علاقة مدير معينة. يمكن للأشخاص التفاعل معها من خلال نقاط إدخال Microsoft 365 مألوفة مثل @mentions والبريد الإلكتروني ودعوات التقويم ودردشة Teams.

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

يعتمد ما يفعله الوكيل - سواء كان محادثة أو خلفية أو كليهما- على كيفية تصميمه. بعض الوكلاء تفاعليون للغاية، ويستجيبون للرسائل ويدعمون العمل في الوقت الحقيقي. يقوم آخرون بمعالجة المهام في الخلفية، والعمل على رسائل البريد الإلكتروني أو الأحداث دون مشاركة المستخدم المباشر. يعمل العامل بهوية المستخدم الخاصة به، وتتم إدارة إجراءاته وقابلة للتدقيق من خلال تلك الهوية.

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

أمثلة على السيناريوهات:

• قم بإضافة زميل ذكاء اصطناعي مخصص لإلحاق الموارد البشرية إلى قناة إلحاق الموظفين الجديدة في Teams. يرسل رسائل البريد الإلكتروني الترحيبية من علبة البريد الخاصة به، ويجدول الاجتماعات التوجيهية على تقويمه الخاص، ويجيب على الأسئلة باستخدام الإمكانات التي تم تكوينها لمثيل العامل هذا.
• تعيين علاقة إدارة في بيانات التعريف الخاصة بالدليل إلى زميل في فريق الذكاء الاصطناعي المعدَّ لدعم المشتريات. يرسل الموظفون طلبات الشراء عبر البريد الإلكتروني إلى صندوق البريد المخصص لها. يعالج الوكيل الطلب، ويستعلم عن أنظمة ERP والأنظمة المالية باستخدام وصوله إلى أداة Work IQ المحكومة، ويستجيب إما بالموافقة أو التصعيد باسمه الخاص.
• أضف زميلا في فريق الذكاء الاصطناعي للبحث إلى موقع SharePoint لفريق المشروع وقناة Teams. يمكنه عرض المستندات ذات الصلة أثناء الاجتماعات، والاستجابة في مؤشرات ترابط المحادثات، وصياغة تقارير الحالة الأسبوعية باستخدام الأذونات والأدوات التي تم تكوينها لهذا العامل.

أساس الهوية:

مبني على مخطط هوية وكيل، والذي ينشئ معرف عامل Microsoft Entra وحساب مستخدم مقترن: وهو دائماً مطلوب.

إضافة قدرات Agent 365 بشكل متزايد

الوكيل 365 ليس كل شيء أو لا شيء. لا تحتاج إلى بناء زميل في فريق الذكاء الاصطناعي في اليوم الأول - أو على الإطلاق، إذا كان السيناريو الخاص بك لا يتطلب ذلك. اعتماد القدرات بشكل متزايد، بدءا مما يحتاجه وكيلك الآن والتوسع مع تطور متطلباتك.

لماذا تعتمد على مخطط هوية الوكيل؟

عند إنشاء مخطط هوية عامل، يقوم Agent 365 CLI بتوفير معرف عامل Microsoft Entra لوكيلك - هوية من الدرجة الأولى في المستأجر الخاص بك، تخضع لنفس نهج حوكمة المؤسسة مثل المستخدمين البشريين. هذه الهوية الفردية هي الأساس لفوائد الأمان التي تتدفق تلقائيا إلى كل عامل يستند إلى المخطط:

الميزة	ماذا يعني لوكيلك
حوكمة معرف Microsoft Entra	تتم إدارة هوية العامل ودورة حياة الوصول من خلال نفس الوصول المشروط وحماية الهوية ومراجعات الوصول التي تنطبق على المستخدمين البشريين.
Microsoft Purview	يخضع كل تفاعل بيانات يقوم به العامل لتسميات حساسية المستأجر ونهج DLP ونهج الاستبقاء - تلقائيا، دون أي تعليمات برمجية إضافية.
Microsoft Defender	تتم مراقبة سلوك العامل باستمرار للشذوذ والتهديدات. يقوم النشاط المشبوه بتشغيل نفس التنبيهات وسير عمل الاستجابة كما هو الحال مع أي مستخدم في المستأجر.

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

تمثل مستويات الحد الأقصى الأربعة أدناه المستويات التي يمكنك اعتمادها بشكل متزايد. يوضح الجدول التالي ما هو متاح للعامل 365 استنادا إلى نقطة البداية:

Capability	Microsoft 365 عامل محرك مخصص	جميع العوامل الأخرى 1
تسجيل	✓ 2	✓
إمكانية المراقبة	✓	✓
ذكاء العمل	✓	✓
زميل في فريق الذكاء الاصطناعي	✓ 3	✓ 3

¹ يجب على العوامل المسجلة حاليا كتطبيقات Microsoft Entra أولا إنشاء مخطط هوية الوكيل للبدء بأي إمكانية في هذا العمود.

² محركات Microsoft 365 المخصصة تم تسجيلها بالفعل باستخدام تسجيل تطبيق Microsoft Entra الحالي — لا يتطلب ذلك إعداد إضافي.

يتطلب زميل الذكاء الاصطناعي لوكلاء محرك Microsoft 365 المخصصين مخطط هوية الوكيل. متاح للمشاركين في برنامج الحدود فقط.

تسجيل

عند تسجيل وكيلك، يمكنك جعله مرئيا وقابلا للإدارة في مركز مسؤولي Microsoft 365. يمكن للمسؤولين اكتشافه ورؤيتها في مخزون وكيل مؤسستهم.

ما تحصل عليه:

• يظهر وكيلك في مركز مسؤولي Microsoft 365؛ يمكن للمسؤولين العثور عليه ورؤيتها في مخزون وكيل مؤسستهم.
• يحصل الوكلاء المستندون إلى البنية التصورية أيضاً على الحوكمة الكاملة لـ Entra ID وPurview وفوائد Defender كما هو موضح في لماذا نبني بالاعتماد على بنية هوية الوكيل؟

ما تقوم ببناءه:

سجل وكيلك باستخدام تسجيل تطبيق Microsoft Entra الحالي أو مخطط.

ملحوظة

إذا قمت ببناء وكلائك على Google Vertex AI أو Amazon Bedrock، فإن التسجيل لا يتطلب أي عمل تطوير. تسحب واجهات برمجة تطبيقات Google وAmazon العوامل تلقائيا. لا يلزم وجود تكامل SDK، ولا مخطط، ولا تغييرات في التعليمات البرمجية. بعد التسجيل، يمكنك استخدام Agent 365 SDK لإضافة إمكانية الملاحظة والوصول إلى أداة Work IQ والقدرات الأخرى بشكل متزايد. للبدء، راجع تسجيل عملاء Google Vertex AI وAmazon Bedrock.

كيفية إنشائها:

استخدم الإعداد الموجه بالذكاء الاصطناعي وأجب عن أسئلة نوع العامل وفقا لذلك. يقوم الإعداد الموجه بالذكاء الاصطناعي بتنفيذ الخطوات المطلوبة لهذا المستوى. عوامل Microsoft 365 للمحركات المخصصة يمكن اكتشافها بالفعل اليوم باستخدام التسجيل الحالي لتطبيق Microsoft Entra.

قابلية الرصد

بعد تسجيل وكيلك، استثمر في إمكانية الملاحظة. يمنح هذا الاستثمار تكنولوجيا المعلومات وفرق الأمان وفريق الهندسة لديك رؤية لما يفعله وكيلك بالفعل. يتم التقاط كل استدعاء استدلال واستدعاء أداة والتفاعل وتتبعها وجعلها قابلة للتدقيق.

إمكانية الملاحظة هي أساس الثقة. بدون ذلك، لن يكون لدى المسؤولين طريقة للتحقق من السلوك أو تدقيق التوافق أو تشخيص المشكلات على نطاق واسع. مع ذلك، يصبح وكيلك أصل مؤسسي بدلا من صندوق أسود.

ملحوظة

إذا كان وكيلك وكيلًا رئيسيًا - مما يعني أنه يستدعي داخليًا وكيلًا فرعيًا واحدًا أو أكثر لإكمال مهمة - يمكن أيضًا تسجيل استدعاءات الوكيل الفرعي هذه في نظام قابلية المراقبة. سجلها كاستدعاء أداة أو مكالمة وكيل إلى وكيل (A2A)، حسب الاقتضاء، لضمان وضوح سلسلة التفويض الكاملة وقابليتها للتدقيق.

ما تحصل عليه:

• تتبع كامل [OpenTelemetry (OTel) (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/) استنادا إلى كل تفاعل عامل: المدخلات والمخرجات واستدعاءات الأدوات واستدعاءات النموذج.
• النشاط المرئي في مركز إدارة Microsoft 365 وأسْطُح المراقبة المتصلة.
• تتبعات التدقيق التي تندمج في Microsoft Entra، وMicrosoft Purview، وMicrosoft Defender، والتي تدعم متطلبات الامتثال وحماية البيانات والاستجابة للتهديدات.

ما تقوم ببناءه:

التحكم بالأجهزة باستخدام واجهات برمجة تطبيقات قابلية المراقبة في Agent 365 SDK: إما التحكم الأتمتي بالأجهزة (إذا كنت تستخدم OpenAI أو LangChain أو Agent Framework) أو التحكم اليدوي لأي تقنية أخرى.

كيفية إنشائها:

استخدم الإعداد الموجه بالذكاء الاصطناعي وأجب عن أسئلة إمكانية الملاحظة وفقا لذلك. يقوم الإعداد الموجه بالذكاء الاصطناعي بتنفيذ الخطوات المطلوبة لهذه الإمكانية.

ذكاء العمل

بعد التسجيل وجعل وكيلك قابلا للملاحظة، امنحه حق الوصول إلى بيانات Microsoft 365 والإجراءات من خلال Work IQ. ذكاء العمل هو مجموعة مدارة من الأدوات التي تتيح لوكيلك العمل مع البريد والتقويم OneDrive SharePoint وTeams والمزيد.

تتطلب أدوات IQ للعمل موافقة المسؤول، ويتم تدقيقها، وقابلة للإبطال. يستدعيهم وكيلك باستخدام الأذونات المحددة في مخططه - لا توجد تدفقات OAuth إضافية أو موصلات مخصصة مطلوبة.

ما تحصل عليه:

• الوصول إلى كتالوج أدوات Work IQ الكامل - البريد والتقويم OneDrive SharePoint وTeams والمزيد.
• الأذونات التي يتحكم فيها المسؤولون ويتم تحديدها لتوافق بدقة مع احتياجات وكيلك.
• يتم تتبع كل استدعاء أداة ويمكن تدقيقه من خلال مجرى قابلية الرصد.

ما تقوم ببناءه:

التعليمات البرمجية للعامل التي تستدعي أدوات Work IQ باستخدام واجهات برمجة تطبيقات أدوات Agent 365 SDK.

كيفية إنشائها:

استخدم واجهات برمجة تطبيقات أدوات Agent 365 SDK لإضافة استدعاءات أداة Work IQ إلى التعليمات البرمجية للعامل يدويا. لا يدعم الإعداد الموجه بالذكاء الاصطناعي هذه الإمكانية حاليا.

زميل في فريق الذكاء الاصطناعي

زملاء فريق الذكاء الاصطناعي متاحون للمشاركين في برنامج الحدود .

تمكن المرحلة النهائية وكيلك من العمل في Microsoft 365 لهويته الخاصة. اعتمادا على التكوين، يمكن أن يكون لها علبة بريد، ووجود Teams، وإدخال الدليل، وعلاقة المدير. يمكن للأشخاص التفاعل معها من خلال تجارب Microsoft 365 مألوفة مثل البريد الإلكتروني والدردشة والاجتماعات وأسطح التطبيقات.

ملحوظة

نقل نموذج الهوية والأذونات

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

يعني هذا التغيير:

• في وصول المستخدم المفوض، يعمل العامل نيابة عن المستخدم الذي سجل الدخول ويقتصر على وصول هذا المستخدم. باستخدام هوية العامل الخاصة، يمكنك منح حق الوصول إلى موارد Microsoft 365 مثل علبة البريد والتقويم وTeams SharePoint مباشرة إلى هوية العامل.
• تحكم في الأذونات وتدقق في الأذونات الممنوحة لهوية الوكيل باعتبارها وصول هذا الوكيل. إنها ليست نفس الأذونات المفوضة من قبل المستخدم التي تم تمريرها من المستخدم المتصل.
• إذا كان التنفيذ الحالي يعتمد على وصول المستخدم المفوض أو أذونات التطبيق، فراجع هذه الأذونات وأعد تحديد نطاقها لهوية العامل قبل تمكين هذه الإمكانية.

ما تحصل عليه:

• كل شيء من قابلية الاكتشاف وقابلية الملاحظة وذكاء العمل.
• هوية مستخدم الوكيل مع علبة البريد الخاصة به - يمكن للأشخاص إرسالها بالبريد الإلكتروني مباشرة ويمكنها إرسال بريد إلكتروني من عنوانها الخاص.
• التواجد عبر تطبيقات Microsoft 365 - يمكن للأشخاص الدردشة معه، @mention، وإضافته إلى القنوات، ودعوته إلى الاجتماعات في Teams؛ والتفاعل معه مباشرة في Word Excel PowerPoint وأسطح M365 الأخرى.
• إدخال في المخطط التنظيمي تحت مدير معين - يظهر الموظف في دليل المؤسسة.
• دورة حياة يتحكم فيها المسؤول - يتم إنشاء العامل وإدارته وإيقافه من خلال مركز مسؤولي Microsoft 365، مع الحوكمة الكاملة على كل مثيل.

ما تقوم ببناءه:

جميع الإمكانات، بالإضافة إلى إنشاء المثيل ونشر Marketplace (اختياريا).

كيفية إنشائها:

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

إعداد موجه بالذكاء الاصطناعي

استخدم عامل ترميز الذكاء الاصطناعي لأتمتة إعداد وتكوين وكيلك للعامل 365. يرشدك الإعداد الموجه بالذكاء الاصطناعي خلال عمليات التحقق من المتطلبات الأساسية وخطوات التكوين وتكامل التعليمات البرمجية اللازمة لتمكين قدرات مثل التسجيل وقابلية المراقبة والوصول إلى أداة Work IQ ووظيفة زميل الذكاء الاصطناعي في الفريق.

متطلبات الإعداد المعتمدة على الذكاء الاصطناعي

قبل البدء، تأكد من أن لديك العناصر التالية:

شرط	التفاصيل
عامل ترميز الذكاء الاصطناعي	تعليمة Visual Studio برمجية مع GitHub Copilot وملحقات GitHub Copilot Chat أو عامل ترميز ذكاء الاصطناعي آخر مع وصول طرفي
رمز الوكيل	مشروع عميل عامل في Python أو Node.js أو .NET. إذا لم يكن لديك واحد، فابدأ بعينة بداية سريعة.
دور إنترا	المسؤول العام - يكمل جميع الخطوات بما في ذلك منح إذن OAuth2. مطور معرف الوكيل - يكمل جميع الخطوات باستثناء منح أذونات OAuth2 و يقوم الإعداد بإنشاء تسليم لمسؤول النظام العام.

خطوات الإعداد الموجهة بالذكاء الاصطناعي

تنطبق هذه الخطوات سواء كنت تقوم بتمكين عامل واحد أو مصنع وكيل. يتحقق عامل الذكاء الاصطناعي من الأدوات المطلوبة ويعالج التثبيت والمصادقة والتحقق من الصحة تلقائيا.

افتح مشروع الوكيل وانسخ هذه المطالبة إلى وكيل الذكاء الاصطناعي الذي تختاره. إذا كنت تستخدم GitHub Copilot، فقم بالتبديل إلى وضع Agent أولا - لا يتوفر الوصول إلى الطرفية في وضعي الطلب والتحرير.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

يبدأ عامل الذكاء الاصطناعي بطرح ثلاثة أسئلة لتحديد القدرات التي تنطبق على وكيلك:

Question 1: هل الوكيل متوفر بالفعل في Teams أو Copilot؟

• ‏‏نعم‬
• No

السؤال 2: كيف سيصادق وكيلك عند استدعاء واجهات برمجة التطبيقات الطرفية؟

• نيابة عن (OBO) — يعمل العامل كمستخدم مسجل الدخول (أذونات مفوضة)
• الخدمة إلى خدمة (S2S) — يقوم الوكيل بالتصرف كأنها هويته الخاصة (صلاحيات التطبيق)
• كل من (OBO وS2S)

السؤال 3: ما هي قدرات العامل 365 التي تريد تمكينها؟

• إذا Yes — العامل موجود بالفعل في Teams أو Copilot (عامل محرك مخصص Microsoft 365):

  • OBO أو كليهما:
  • إمكانية المراقبة
  • زميل في فريق الذكاء الاصطناعي
  • S2S:
  • إمكانية المراقبة
  • زميل في فريق الذكاء الاصطناعي

• إذا كان لا — جميع العوامل الأخرى:

  • OBO أو كليهما:
  • سجل
  • إمكانية المراقبة
  • زميل في فريق الذكاء الاصطناعي
  • S2S:
  • سجل
  • إمكانية المراقبة
  • زميل في فريق الذكاء الاصطناعي

يتضمن الإعداد تلقائيا جميع إمكانيات المتطلبات الأساسية لاختيارك.

ثم يعمل عامل الذكاء الاصطناعي من خلال المستويات القابلة للتطبيق تلقائيا، مع التوقف مؤقتا فقط لطلب إدخالك:

Capability	ما يفعله عامل الذكاء الاصطناعي 1
سجل	التحقق من .NET وواجهه الأوامر Agent 365 CLI (للتثبيت أو التحديث إذا كان مفقوداً)، تثبيت واجهه الأوامر Azure CLI إذا كانت مفقودة، وتشغيل az login في حال عدم المصادقة، وتأكيد صحة تسجيل تطبيق العميل المخصص الخاص بك، وجمع اسم الوكيل والبريد الإلكتروني للمدير، وتكوين وكيلك في بوابة مطوري Teams، وتسجيل القالب الأساسي للوكيل الخاص بك
إمكانية المراقبة	إضافة أدوات مراقبة Agent 365 SDK إلى التعليمات البرمجية للعامل الخاص بك
زميل في فريق الذكاء الاصطناعي	يقوم a365 publish بالتشغيل ويرشدك خلال الخطوات التالية لنشر النظام بما في ذلك إنشاء مثيل العامل

¹ تعتمد الخطوات التي تم تنفيذها على نوع العامل والمراحل التي حددتها في بداية الإعداد.

مهم

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

المعلومات المطلوبة لإكمالها

يتوقف عامل الذكاء الاصطناعي مؤقتا لجمع التكوين أثناء الإعداد:

موجه	ما يجب توفيره
اسم العامل، البريد الإلكتروني للمدير	بيانات تعريف العامل الأساسية
تأكيد القيمة المشتقة	مراجعة الأسماء التي تم إنشاؤها تلقائيًا لهوية الوكيل والمخطط والمستخدم الرئيسي
مراجعة البيان	تأكد من أن manifest.json محدثة باسم وكيلك، ووصفه، ومعلومات المطور الخاص به.

خطوات النشر اللاحقة

عند انتهاء المستويات التلقائية، يتوقف عامل الذكاء الاصطناعي مؤقتا لخطوتين تتطلبان تفاعل المستعرض:

1. إنشاء نسخة وكيل

   (زميل الذكاء الاصطناعي فقط) — في Microsoft Teams، انتقل إلى Apps، وابحث عن وكيلك، وحدد Add. إذا كانت موافقة المسؤول مطلوبة، فسيتلقى مسؤول Microsoft 365 الطلب. بمجرد الموافقة، يظهر وكيلك في المخطط الهيكلي. للحصول على مثيلات إضافية، راجع إنشاء مثيلات عامل. قد يستغرق الأمر بضع دقائق حتى يظهر عامل منشور حديثا في بحث Teams.

2. اختبار وكيلك

   أرسل رسالة إلى وكيلك في Teams للتحقق من أنه يعمل.

تم - تم نشر وكيلك وتفعيله وهو يعمل الآن. راجع إنشاء مثيلات عامل إذا كنت بحاجة إلى مثيلات إضافية.

إذا لم ينجح أي شيء، فإن عامل الذكاء الاصطناعي يوفر استكشاف الأخطاء وإصلاحها المستهدف. يمكنك أيضا الرجوع إلى دليل استكشاف الأخطاء وإصلاحها للعامل 365.

مرجع المسار اليدوي

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

خطوة	مهامه	Guide
إعداد التهيئة	قم بإنشاء a365.config.json باستخدام تفاصيل المستأجر والاشتراك والمشروع الخاصة بك. إذا كان لديك نشر موجود، فقم بتعيين نقطة نهاية المراسلة هنا.	إعداد وكيل 365
مخطط الإعداد	تسجيل هوية الوكيل في إنترا وتوفير موارد Azure (مجموعة الموارد، خطة خدمة التطبيقات، تطبيق الويب)	مخطط وكيل التثبيت
نشر	نشر التعليمات البرمجية للعامل الخاص بك إلى "Azure App Service". اختياري إذا كان مستضافا بالفعل في مكان آخر.	Azure · AWS · GCP
نشر	إنشاء manifest.zip وتحميلها إلى مركز مسؤولي Microsoft 365	نشر عامل

لتثبيت CLI والأوامر واستكشاف الأخطاء وإصلاحها، راجع Agent 365 CLI.

نشر وكيلك إلى Microsoft Marketplace

بعد تطوير وكيلك واختباره بالكامل داخل المستأجر أو المستأجرين، اجعله متاحا في Microsoft Marketplace.

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

تعرف على كيفية إرسال وكيلك إلى Microsoft Marketplace باستخدام Partner Center.

عند الانتهاء، يتم نشر وكيلك في Microsoft Marketplace ويتوفر للعملاء لاكتشافه ونشره.

استكشاف أخطاء الإعداد الموجه بواسطة الذكاء الاصطناعي وإصلاحها

إذا واجهت مشكلات أثناء الإعداد الموجه بالذكاء الاصطناعي، فشاهد المشكلات الشائعة التالية وحلولها.

المشكلة	‏‏الوصف
لا يقوم عامل الذكاء الاصطناعي بتشغيل أوامر المحطة الطرفية	يصف عامل الذكاء الاصطناعي الأوامر ولكنه لا ينفذها
عامل الذكاء الاصطناعي يتخطى الخطوات	يبدو أن الإعداد يتخطى الخطوات المطلوبة
تفشل أوامر CLI مع أخطاء الأذونات	أخطاء التخويل عند تشغيل أوامر واجهة سطر الأوامر a365
قيم التكوين خاطئة	تحتاج إلى تغيير التكوين بعد إنشاء a365.config.json

وكيل الذكاء الاصطناعي لا يشغل أوامر الطرفية

إذا كان عامل الذكاء الاصطناعي يصف الأوامر ولكنه لم ينفذها، فتأكد من أنك تستخدم وضع Agent في GitHub Copilot Chat. أوضاع الاستفسار والتحرير ليست لديها وصول إلى الطرفية.

عامل الذكاء الاصطناعي يتخطى الخطوات

يفرض ملف التعليمات ترتيبا صارما للخطوات. إذا بدا أن عامل الذكاء الاصطناعي يتخطى خطوة، فاطلب منه البدء من جديد:

Please start from Step 1 in the setup instructions and work through each step in order.

أخطاء الإذن تؤدي إلى فشل أوامر CLI

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

لاستكشاف الأخطاء وإصلاحها بشكل عام، راجع دليل استكشاف الأخطاء وإصلاحها للعامل 365.

قيم الإعدادات خاطئة

إذا كنت بحاجة إلى تغيير قيم التكوين بعد إنشاء a365.config.json، فإما:

• تحرير الملف مباشرة وإعادة التشغيل a365 config init -c ./a365.config.json
• اطلب من وكيل الذكاء الاصطناعي تحديث قيم محددة