دليل قراءة متعدد اللغات للمهارة
declarative-agent-developerالغرض والاستخدام والمصدر
إنشاء وبناء ونشر وتوطين الوكلاء التصريحيين لـ M365Copilot وTeams. استخدم هذه المهارة لأي مهمة تتضمن وكيلًا تصريحيًا - بما في ذلك التوطين، وإنشاء الهيكل، وتعديل البيانات الوصفية، وإضافة الإمكانيات، والنشر. يتطلب التوطين بيانات وصفية مُرمّزة وملفات لغة لا يمكن إنتاجها إلا بهذه المهارة. المحفزات: "إنشاء وكيل"، "إنشاء وكيل تصريحي"، "وكيل تصريحي جديد"، "إنشاء هيكل وكيل"، "مشروع وكيل جديد"، "إضافة إمكانية"، "إضافة مكون إضافي"، "تهيئة الوكيل"، "نشر الوكيل"، "إصلاح بيان الوكيل"، "تعديل الوكيل"، "توطين الوكيل"، "إضافة ترجمة"، "ترجمة الوكيل"، "وكيل متعدد اللغات"، "إضافة مكون إضافي لواجهة برمجة التطبيقات"، "إضافة مكون إضافي لمنصة إدارة الوكلاء"، "إضافة OAuth إلى المكون الإضافي"، "مراجعة التعليمات"، "تحسين التعليمات"، "إصلاح التعليمات".
تم استرجاع المصدر:
- مستودع المصدر
- microsoft/skills
- SKILL.md
.github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md- نجوم المستودع
- 3,157
- آخر تحديث للمستودع
- 2026-10-31
- تصنيف القدرات
- سير عمل الوكيل
- وقت التجميع الأخير
الترخيص: MIT
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
إنشاء وبناء ونشر وتوطين الوكلاء التصريحيين لـ M365Copilot وTeams. استخدم هذه المهارة لأي مهمة تتضمن وكيلًا تصريحيًا - بما في ذلك التوطين، وإنشاء الهيكل، وتعديل البيانات الوصفية، وإضافة الإمكانيات، والنشر. يتطلب التوطين بيانات وصفية مُرمّزة وملفات لغة لا يمكن إنتاجها إلا بهذه المهارة. المحفزات: "إنشاء وكيل"، "إنشاء وكيل تصريحي"، "وكيل تصريحي جديد"، "إنشاء هيكل وكيل"، "مشروع وكيل جديد"، "إضافة إمكانية"، "إضافة مكون إضافي"، "تهيئة الوكيل"، "نشر الوكيل"، "إصلاح بيان الوكيل"، "تعديل الوكيل"، "توطين الوكيل"، "إضافة ترجمة"، "ترجمة الوكيل"، "وكيل متعدد اللغات"، "إضافة مكون إضافي لواجهة برمجة التطبيقات"، "إضافة مكون إضافي لمنصة إدارة الوكلاء"، "إضافة OAuth إلى المكون الإضافي"، "مراجعة التعليمات"، "تحسين التعليمات"، "إصلاح التعليمات".
طريقة الاستخدام وفق المستند الأصلي
⛔ فحص مساحة العمل — الخطوة الأولى الإلزامية
قبل القيام بأي شيء، تحقق من ملفات مساحة العمل لتحديد بصمة المشروع: تشغيلnpx -y --package @microsoft/m365agentstoolkit-cli atk --versionللتأكد من تثبيت ATK CLI. إذا لم يتم العثور عليه ← توقف. اطلب من المستخدم تثبيت ATK. تحقق منm365agents.ymlأوteamsApp.ymlفي جذر المشروع. تحقق منappPackage/declarativeAgent.json.
6قم دائمًا بتحديث التعليمات وبدء التشغيل بعد إجراء التغييرات.
إضافة ميزة أو إضافة دون تحديث التعليمات أمر غير مكتمل. بعد أي تغيير: حدّث التعليمات لوصفnew/changedالوظائف - يجب أن يكون لكل مصدر بيانات تغطية واضحة للغرض (متى ولماذا يُستخدم) وفقًا لمعيار جودة مراجعة التعليمات. لا تحتاج الإمكانيات المدمجة إلى أسماء دقيقة؛actions/pluginsيجب تسميتها. لا تذكر أسماء الأدوات أو أوصافها أو معاييرها في التعليمات - فهذه موجودة بالفعل في بيانات تعريف الملحق (ai-plugin.json(بيانات MCP، وتكوين القدرات). يجب أن تتضمن التعليمات منطق اتخاذ القرار فقط: متى يتم استخدام كل أداة، وقواعد التسلسل، ومعالجة الأعطال. أضف على الأقل1بداية محادثة لكل إضافةcapability/plugin
export ATK_CLI_SKILL=trueالمتطلبات والإعداد
إعداد واجهة سطر الأوامر ATK
قبل تشغيل أي أوامر ATK، تحقق من توفر واجهة سطر أوامر ATK عن طريق تشغيل الأمر التالي:npx -y --package @microsoft/m365agentstoolkit-cli atk --versionإذا لم يتم العثور عليه، فتوقف وأخبر المستخدم - لا تحاول تثبيته بنفسك. جميع الأوامر تستخدمnpx -y --package @microsoft/m365agentstoolkit-cli atkالبادئة (على سبيل المثال،npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local).
3توافق إصدار المخطط
قبل إضافة أي ميزة، اقرأversionحقل فيdeclarativeAgent.jsonوتحقق من مصفوفة ميزات المخطط. إذا لم تكن الميزة مدعومة في هذا الإصدار، فارفض واعرض الترقية. بوابات الإصدار الرئيسية:
الحدود وفحوصات الجودة
2لا تقم أبدًا باختلاق محتوى أو إنشاء ملفات مفقودة.
لا تقم بابتكار أسماء أو أوصاف أو تعليمات مؤقتة. لا تقم بإنشاءdeclarativeAgent.jsonأوappPackage/إذا لم تكن موجودة - فهذا سيناريو رفض، وليس سيناريو "المساعدة عن طريق الإنشاء".
4. يستخدمnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionبالنسبة لملحقات واجهة برمجة التطبيقات (API) — لا تقم أبدًا بإنشاء ملفات الملحقات يدويًا
ممنوع عليك إنشاء ذلك يدويًاai-plugin.jsonمواصفات OpenAPI، أو البطاقات التكيفية، أو تعديلactionsالمصفوفة. استخدم واجهة سطر الأوامر: قم بتشغيل أمر واحدnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionيتم استدعاء كل عملية وفقًا لمواصفات OpenAPI، مع سرد جميع العمليات كقائمة مفصولة بفواصل في--api-operationلا تقم بتشغيلها بشكل منفصل.npx -y --package @microsoft/m365agentstoolkit-cli atk add actionتتطلب هذه العملية عمليات مختلفة من نفس المواصفات، مما يؤدي إلى إنشاء عدة إضافات بدلاً من إضافة واحدة. إذاnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionفي حالة الفشل، قم بالإبلاغ عن الخطأ؛ ولا تلجأ إلى الإنشاء اليدوي.
ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
- وضع علامات القياس عن بعد
- ⛔ فحص مساحة العمل — الخطوة الأولى الإلزامية
- 🚫 قواعد الرفض القاطع — بدون استثناءات
- 🔍 الكشف → الإبلاغ → السؤال (بروتوكول معالجة الأخطاء)
- إعداد واجهة سطر الأوامر ATK
- 1انشر بعد كل تعديل
- 2لا تقم أبدًا باختلاق محتوى أو إنشاء ملفات مفقودة.
- 3توافق إصدار المخطط
- 4. يستخدم
npx -y --package @microsoft/m365agentstoolkit-cli atk add actionبالنسبة لملحقات واجهة برمجة التطبيقات (API) — لا تقم أبدًا بإنشاء ملفات الملحقات يدويًا - 5تكامل خادم MCP
- 6قم دائمًا بتحديث التعليمات وبدء التشغيل بعد إجراء التغييرات.
- 7متطلبات اسم التطبيق
- مشترك
- السقالات
- تطوير JSON
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
00d66a64919edca5bca2c673373444e36a4b5461- المصدر SHA-256
13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412