pac copilot

الأدوات والأدوات المساعدة لإدارة copilot.

init push pull cloneتتيح لك الأوامر و pack و الاحتفاظ بعامل Copilot Studio كملف على القرص وتحريره محليا ومزامنته مع بيئة Dataverse.

يبدو التكرار الحلقي النموذجي كما يلي:

  1. بدء مساحة عمل. قم بدعم وكيل العلامة التجارية الجديدة مع pac copilot init، أو قم بتنزيل وكيل موجود باستخدام pac copilot clone. في كلتا الحالتين تحصل على مساحة عمل محلية تحمل بيانات تعريف المزامنة التي تعتمد عليها الأوامر الأخرى.
  2. اسحب قبل التحرير. pac copilot pull يؤدي إلى خفض التغييرات عن بعد ودمجها في ملفاتك المحلية، بحيث تبدأ من حالة الخادم الحالية.
  3. دفع عند الانتهاء. pac copilot push إرسال التغييرات المحلية مرة أخرى. إذا تم تغيير العنصر نفسه على الخادم في هذه الأثناء، يتوقف الدفع ويطلب منك السحب أولا.
  4. حزمة للنشر. pac copilot pack يحول مساحة العمل إلى حل .zip يمكنك نشره باستخدام pac solution import.

للانتقال من لا شيء إلى عامل مباشر في خطوة واحدة، pac copilot init --environment سقالات وحزم واستيراد وتوصيل مساحة العمل نيابة عنك. تتيح لك الأوامر الفردية قيادة كل جزء من الحلقة من تلقاء نفسها.

الأوامر

القيادة الوصف
pac copilot clone استنساخ عامل Copilot Studio إلى دليل مساحة عمل محلي.
pac copilot create إنشاء copilot جديد باستخدام ملف قالب موجود كمرجع.
pac copilot delete حذف Copilot مخصص.
pac copilot extract-template استخراج ملف قالب من copilot موجود في بيئة.
pac copilot extract-translation استخراج ملف يحتوي على محتوى مترجم لواحد أو أكثر من الروبوتات.
pac copilot init إنشاء مساحة عمل عامل Copilot Studio جديدة من قالب.
pac copilot list قائمة الأقباط في بيئة Dataverse الحالية أو المستهدفة.
pac copilot mcp معلومات حول خادم MCP المحلي (بروتوكول سياق النموذج).
pac copilot merge-translation دمج الملفات التي تحتوي على محتوى مترجم لروبوت واحد أو أكثر.
pac copilot model list الذكاء الاصطناعي نماذج Builder في البيئة الحالية.
pac copilot model predict إرسال نص أو مطالبة إلى نموذج الذكاء الاصطناعي
pac copilot model prepare-fetch يأخذ ملف FetchXML من الذكاء الاصطناعي Large Language Model (LLM) ويعده للتنفيذ مقابل البيئة الحالية.
pac copilot pack قم بتعبئة مساحة عمل عامل Copilot Studio في ملف مضغوط للحل.
pac copilot publish نشر Copilot مخصص
pac copilot pull اسحب التغييرات عن بعد من Copilot Studio ودمجها مع مساحة العمل المحلية.
pac copilot push ادفع تغييرات مساحة العمل المحلية إلى Copilot Studio.
pac copilot quarantine حالة الحجر الصحي لعميل مساعد الطيار.
pac copilot status تحقق من حالة نشر copilot محدد في بيئة Dataverse الحالية أو الهدف.

pac copilot clone

استنساخ عامل Copilot Studio إلى دليل مساحة عمل محلي.

pac copilot cloneتنزيل عامل Copilot Studio موجود في دليل مساحة عمل محلي، جنبا إلى جنب مع بيانات تعريف المزامنة التي pac copilot pull تعتمد عليها.pac copilot push تتم كتابة ملفات العامل إلى مجلد فرعي يسمى باسم العرض الخاص به.

مثال

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

المعلمات المطلوبة ل copilot clone

--bot -id

معرف Copilot أو اسم المخطط (الاسم الفريد الموجود في تفاصيل الروبوت أو اسم الملف في مستكشف الحلول).

معلمات اختيارية ل copilot clone

--component-collection -cc

معرف مجموعة المكونات المراد استنساخه. كرر هذا الإجراء لعدة مرات.

--display-name -dn

اسم العرض للعامل (يستخدم لتسمية المجلد).

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--output-dir -od

المجلد الجذر لإخراج النسخ. الإعدادات الافتراضية للدليل الحالي.

الملاحظات

  • --botيقبل معرف Copilot أو اسم مخطط. مرر إما معرف Copilot (GUID) أو اسم مخطط العامل. يحل الأمر اسم مخطط مقابل البيئة الهدف.
  • يجب أن يكون المجلد الفرعي الوجهة فارغا. يكتب النسخ في مجلد يسمى باسم اسم عرض العامل (المطهر) ضمن --output-dir. إذا كان هذا المجلد يحتوي بالفعل على ملفات، يتوقف النسخ بدلا من الكتابة فوقها. استخدم --display-name لاختيار اسم مجلد آخر.
  • استنساخ مجموعات المكونات. لجلب مجموعات المكونات إلى جانب العامل، قم بتمرير معرف مجموعة واحد أو أكثر باستخدام --component-collection، مفصولة بفواصل منقوطة.
  • يتطلب النسخ ملف تعريف مصادق عليه (pac auth create) ويحل البيئة من --environmentأو من مؤسسة ملف التعريف النشط عند حذفه.

pac copilot create

إنشاء copilot جديد باستخدام ملف قالب موجود كمرجع.

المعلمات المطلوبة ل copilot create

--displayName

اسم العرض لملف copilot الجديد

--schemaName

اسم المخطط (اسم فريد) لملف copilot الجديد.

--solution -s

اسم الحل.

--templateFileName

ملف yaml المصدر الذي يحتوي على قالب copilot الذي تم استخراجه باستخدام الأمر extract-template.

معلمات اختيارية ل copilot create

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac copilot delete

حذف Copilot مخصص.

المعلمات المطلوبة ل copilot delete

--bot -id

معرف Copilot أو اسم المخطط (الاسم الفريد الموجود في تفاصيل الروبوت أو اسم الملف في مستكشف الحلول).

معلمات اختيارية ل copilot delete

--confirm -y

مطلوب لتأكيد حذف copilot.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac copilot extract-template

استخراج ملف قالب من copilot موجود في بيئة.

مثال

يستخرج هذا الأمر ملف قالب من صورة شرطية موجودة في بيئة.

pac copilot extract-template `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --templateFileName NewTestCopilot.yaml

يقوم الأمر بإرجاع الإخراج كما يلي ل copilot باستخدام اللغات الإنجليزية والألمانية:

Connected as user@contoso.org

Loaded 34 components for bot 'New Test Copilot ' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

New Test Copilot -> C:\Users\user\NewTestCopilot.yaml

المعلمات المطلوبة ل copilot extract-template

--bot -id

معرف Copilot أو اسم المخطط (الاسم الفريد الموجود في تفاصيل الروبوت أو اسم الملف في مستكشف الحلول).

--templateFileName

موقع ملف yaml لكتابة قالب copilot إليه.

معلمات اختيارية ل copilot extract-template

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--overwrite -o

السماح بالكتابة فوق ملف بيانات الإخراج إذا كان موجودا بالفعل.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--templateName

اسم القالب أو "kickStartTemplate" إذا لم يتم تحديد الاسم.

--templateVersion

إصدار القالب بتنسيق X.X.X أو 1.0.0 إذا لم يتم تحديد الإصدار.

pac copilot extract-translation

استخراج ملف يحتوي على محتوى مترجم لواحد أو أكثر من الروبوتات.

مثال

يستخرج هذا الأمر ملفا يحتوي على محتوى مترجم لواحد أو أكثر من الكوبيلوت.

pac copilot extract-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
   --all `
   --outdir . `
   --format json

يقوم الأمر بإرجاع الإخراج كما يلي:

Connected as user@contoso.org

Loaded 32 components for bot 'New Test Copilot' with id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e. Primary language: English, supported languages: German

معلمات اختيارية ل copilot extract-translation

--all -a

كتابة ملفات الترجمة لجميع اللغات المدعومة. بشكل افتراضي، تتم كتابة اللغة الأساسية فقط.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--bot -id

معرف Copilot أو اسم المخطط (الاسم الفريد الموجود في تفاصيل الروبوت أو اسم الملف في مستكشف الحلول).

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--format

تنسيق الملف لكتابة الملفات المترجمة، إما "resx" أو "json". الإعداد الافتراضي هو 'resx'.

--outdir

دليل الإخراج للكتابة إليه.

--overwrite -o

السماح بالكتابة فوق ملف بيانات الإخراج إذا كان موجودا بالفعل.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--sourcedir -src

دليل حل المصدر. عند تحديده، سيتجاهل البيئة المتصلة عند البحث عن الروبوتات والبحث عن المحتوى في مجلد الحل بدلا من ذلك.

pac copilot init

إنشاء مساحة عمل عامل Copilot Studio جديدة من قالب.

pac copilot initيدع مساحة عمل عامل Copilot Studio جديدة من قالب. يتم تشغيله في أحد الوضعين، ويقرر وجود --environment أي وضع يجب استخدامه:

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

الأمثلة

دعم مساحة عمل محليا:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

دعم وكيل مباشر في بيئة في خطوة واحدة:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

دعم عامل تأليف CLI (CliCopilot) في مجلد معين:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

المعلمات المطلوبة ل copilot init

--name -n

اسم عرض العامل.

--publisher-prefix -pp

Publisher بادئة التخصيص للحل.

معلمات اختيارية ل copilot init

--authoring-mode -am

شكل تأليف العامل إلى سقالة (افتراضي: 'كلاسيكي'). استخدم "cli-copilot" لدعم عامل CliCopilot الذي تأليف CLI.

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--instructions -ins

إرشادات نظام العامل.

--project-dir -pd

الدليل الهدف لمساحة عمل العامل. الإعدادات الافتراضية للدليل الحالي.

--schema-name -sn

اسم مخطط العامل الكامل. يتجاوز الاشتقاق الافتراضي ({publisher-prefix}_{sanitized-name}). يستخدم as-is دون تعديل.

--template -t

اسم ملف تعريف القالب (افتراضي، الحد الأدنى). الإعدادات الافتراضية إلى "افتراضي".

الملاحظات

  • يجب أن يكون دليل المشروع فارغا. init لا يحرك الملفات الموجودة، لذا أشر --project-dir إلى مجلد جديد أو فارغ.
  • اشتقاق اسم المخطط. عند حذف --schema-name، يتم إنشاء اسم مخطط العامل ك {publisher-prefix}_{sanitized-name}. تمرير --schema-name لتعيينه بشكل صريح؛ يتم استخدام القيمة as-is.
  • يعمل Bootstrap لكلا وضعي التأليف. init --environment تمهيد تشغيل عامل مباشر في خطوة واحدة للوضع الكلاسيكي الافتراضي و ل --authoring-mode cli-copilot. كبديل لعامل CliCopilot، يمكنك دعم محليا (لا --environment)، ثم تشغيل pac copilot pack متبوعا pac solution import بنشره بنفسك.
  • ينشئ Bootstrap كائنات من جانب الخادم. في وضع bootstrap، init يقوم باستيراد حل وإنشاء العامل في البيئة المستهدفة. إذا كان هناك عامل بنفس اسم المخطط موجود بالفعل، init يوقفك ويشير إلى pac copilot clone الاتصال بالعامل الموجود بدلا من ذلك.
  • يمكن أن تكون البيئة الجديدة بطيئة في قبول الاستيراد الأول. قد تستغرق البيئة التي تم إنشاؤها حديثا دقيقة أو دقيقتين للتدفئة. يمكن أن يفشل تمهيد التشغيل المبكر مع "عمليات غير متزامنة معطلة حاليا لهذه المؤسسة. " انتظر لحظة وقم بتشغيلها مرة أخرى.
  • --template (default أو minimal) ينطبق على وضع التأليف الكلاسيكي فقط.

pac copilot list

قائمة الأقباط في بيئة Dataverse الحالية أو المستهدفة.

مثال

يسرد هذا الأمر جميع الأقباط في بيئة Dataverse الحالية أو المستهدفة.

pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

يقوم الأمر بإرجاع الإخراج كما يلي:

Name                           Bot ID                               Component State Is Managed Solution ID                          Status Code State Code
Ask Me Anything Copilot       584e012c-dc95-46d6-af5a-1263b6a44342 Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned
New Test Copilot               9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e Published       Unmanaged  285af946-6383-49a0-8615-4e2afafeaf38 Active      Provisioned

معلمات اختيارية ل copilot list

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac copilot mcp

معلومات حول خادم MCP المحلي (بروتوكول سياق النموذج).

مثال

pac copilot mcp --run

معلمات اختيارية ل copilot mcp

--run -r

تشغيل خادم MCP المحلي (بروتوكول سياق النموذج).

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

الملاحظات

تعرف على كيفية استخدام Power Platform CLI مع خادم MCP المضمن

pac copilot merge-translation

دمج الملفات التي تحتوي على محتوى مترجم لروبوت واحد أو أكثر.

مثال

يدمج هذا الأمر الملفات التي تحتوي على محتوى مترجم لواحد أو أكثر من copilots.

pac copilot merge-translation `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --file ms_store_newTestCopilot.de-DE.json `
   --solution SolutionName

يقوم الأمر بإرجاع الإخراج كما يلي عند تحديث اللغة الألمانية:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 0 key(s) were missing, 0 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

تعرف على كيفية إدارة الأخطاء من أمر دمج الترجمة

معلمات اختيارية ل copilot merge-translation

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--file -f

قائمة الملفات التي تحتوي على ترجمات. يتم دعم أنماط Glob.

--solution -s

اسم الحل.

--sourcedir -src

دليل حل المصدر. عند تحديده، سيتجاهل البيئة المتصلة عند البحث عن الروبوتات والبحث عن المحتوى في مجلد الحل بدلا من ذلك.

--verbose

إخراج المزيد من المعلومات التشخيصية أثناء استيراد/تصدير البيانات

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

--whatif

لا ينفذ الأمر، ولكنه يقوم بإخراج تفاصيل ما قد يحدث.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

أخطاء ترجمة الدمج

استنادا إلى المثال أعلاه، إذا كان هناك خطأ واحد في الملف المستخدم لتحديث copilot، فإن الإخراج يبدو كما يلي:

Connected as user@contoso.org

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

--verbose تضيف العلامة تفاصيل حول الخطأ:

Connected as user@contoso.org

Missing translation key: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmond)'.DisplayName.

Unused translation: 'dialog(ms_store_newTestCopilot.topic.Lesson2)'.'trigger(main)'.'action(LbWwpD)'.Entity.Definition.'closedListItem(Redmont)'.DisplayName, value: Redmond

Loading language German into bot 'ms_store_newTestCopilot' (New Test Copilot) from file 'C:\Users\user\ms_store_newTestCopilot'. 1 key(s) were missing, 1 value(s) were not used. Use the --verbose switch to get more details.

Updated 16 out of 16 components.

pac copilot model list

الذكاء الاصطناعي نماذج Builder في البيئة الحالية.

مثال

يسرد هذا الأمر جميع نماذج الذكاء الاصطناعي Builder.

pac copilot model list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118

يقوم الأمر بإرجاع الإخراج كما يلي:

Id                                   State    Name
32a9e265-1149-4155-af54-d2856d2b83f5 Active   Document Processing 2023/09/20, 12:21:40
2bcd7b94-50bc-4767-af4a-367c63fb5487 Inactive AI Classify
4e72b59a-17d6-451e-8657-89fbdec56d7a Inactive AI Extract
572f57a7-7a8f-49fc-adb4-331e02c509a6 Inactive AI Reply
b9b636cf-9748-47a7-b617-6df5f00f5151 Inactive AI Sentiment
c076eac8-f218-4feb-8ad1-7ee4fb039419 Inactive AI Summarize
a0440df3-2656-e911-8194-000d3a6cd5a5 Inactive BusinessCard model
62d1e848-5ca7-490a-94bf-79baabe85ef4 Inactive CategoryClassification model
4da7ec17-5c26-4fd2-9ddb-be4f7eda21a9 Inactive DataGenieEmailAddressValidation
51f4da11-5702-401d-b53a-9638744e8ac9 Inactive Document Layout Analysis Model
d1bb8d57-24ab-3b36-9592-bd792e153b79 Inactive DVCopilotQueryModel
3fbd4e5c-32bc-40fc-acce-59c2821cf113 Inactive Empty Dynamic Prompt
8c281981-c5d6-484f-bac7-4924ddd0b8ae Inactive EntityExtraction model
a1afa5d4-7a44-4c31-9cd2-e852a78431fa Inactive GptPromptEngineering model
2c444168-f8b1-4c6a-9313-2d9c03be6fea Inactive Id Scanning Model
77365cfa-7021-4cb7-a9b2-dc9823cde772 Inactive ImageDescription model
aef1bdd2-2a74-4f74-b4eb-9dfa22e35ded Inactive Invoice Model
5ed4d0fd-e9d4-4026-b09b-71f83ea90c60 Inactive Invoice Processing Model
c8425db7-c5a7-4226-b38e-c93a044c0fe1 Inactive KeyPhraseExtraction model
17a6f893-5b0b-4867-8fac-fb2eda9080b2 Inactive LanguageDetection model
046ab801-2756-e911-8194-000d3a6cd5a5 Inactive ObjectDetectionProposal model
892d3698-ba03-3d15-8e9e-843ca4ac5e7d Inactive PowerAppsAppCopilotModel
baa44529-bebe-49e6-837a-80bee63b0d2c Inactive Receipt Scanning Model
f1c549c2-a97e-47a5-b612-c5c2bab0f163 Inactive SentimentAnalysis model
7f8a7856-003a-3662-9871-0000d7674433 Inactive SimsModel
86419a67-205a-454f-b6fc-601394f2786d Inactive TextRecognition model
6225038a-8b5a-4913-bfd2-d8236f4102ba Inactive TextTranslation model
02e1fca3-232a-4f58-8c93-bdd8c9cd6de9 Inactive TextTranslationInternal model

معلمات اختيارية ل copilot model list

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac copilot model predict

إرسال نص أو مطالبة إلى نموذج الذكاء الاصطناعي

معلمات اختيارية ل copilot model predict

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

--model-id -id

معرف نموذج الذكاء الاصطناعي Builder

--model-name -n

اسم نموذج الذكاء الاصطناعي الكامل أو الجزئي

--prompt -p

المطالبة بإرسال إلى نموذج الذكاء الاصطناعي

--text -t

نص لإرساله إلى نموذج الذكاء الاصطناعي

pac copilot model prepare-fetch

يأخذ ملف FetchXML من الذكاء الاصطناعي Large Language Model (LLM) ويعده للتنفيذ مقابل البيئة الحالية.

المعلمات المطلوبة ل copilot model prepare-fetch

--inputFile -i

إدخال ملف FetchXML الذي يأتي عادة من الذكاء الاصطناعي LLM.

--outputFile -o

ملف Output FetchXML الجاهز للتنفيذ مقابل البيئة الحالية.

معلمات اختيارية ل copilot model prepare-fetch

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac copilot pack

قم بتعبئة مساحة عمل عامل Copilot Studio في ملف مضغوط للحل.

pac copilot pack يحزم مساحة عمل عامل في حل .zip Dataverse الذي يمكنك نشره باستخدام pac solution import. إنه الشكل المستقل لخطوة التعبئة والتغليف التي pac copilot init --environment تعمل من أجلك، حتى تتمكن من إنتاج الحل القابل للنشر كخطوة منفصلة - على سبيل المثال، في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء. وهو يعمل لكل من مساحات عمل عامل الكلاسيكية وCLI (CliCopilot).

مثال

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

المعلمات المطلوبة ل copilot pack

--publisher-prefix -pp

Publisher بادئة التخصيص للحل.

معلمات اختيارية ل copilot pack

--output-path -op

مسار الإخراج لملف مضغوط للحل. الإعدادات الافتراضية للدليل الحالي.

--project-dir -pd

دليل مساحة عمل العامل لحزمه. الإعدادات الافتراضية للدليل الحالي.

--solution-name -sn

اسم فريد للحل. إذا تم حذفه، يتم اشتقاقه من اسم مخطط العامل.

الملاحظات

  • إنها عملية محلية. تقرأ الحزمة مساحة العمل وتكتب حلا .zip. لا يحتاج إلى مصادقة ولا بيئة، لذلك من الآمن تشغيله في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء.
  • يجب أن تكون بادئة الناشر صالحة. --publisher-prefix يجب أن تكون بادئة تخصيص جيدة التكوين، أو تتوقف الحزمة قبل كتابة أي شيء.
  • اسم الحل والإخراج. إذا حذفت --solution-name، يتم اشتقاق الاسم الفريد للحل من اسم مخطط العامل. .zip تتم كتابة إلى الدليل الحالي ما لم تقم بتعيين --output-path.
  • لا يتم نشر الحزمة. ينتج الحل ولكنه لا يستورده. اتبعه pac solution import مع لنشر العامل، إذا pac copilot clone كنت تريد مساحة عمل متصلة بالمزامنة له.

pac copilot publish

نشر Copilot مخصص

المعلمات المطلوبة ل copilot publish

--bot -id

معرف Copilot أو اسم المخطط (الاسم الفريد الموجود في تفاصيل الروبوت أو اسم الملف في مستكشف الحلول).

معلمات اختيارية ل copilot publish

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

pac copilot pull

اسحب التغييرات عن بعد من Copilot Studio ودمجها مع مساحة العمل المحلية.

pac copilot pull يجلب الأمر حالة الخادم الحالية للعامل ويدمجها في مساحة العمل المحلية باستخدام دمج ثلاثي الاتجاه. تضمن هذه العملية بقاء عمليات التحرير من جانب الخادم والملفات المحلية التي لم تمسها سليمة. قم بتشغيله قبل بدء التحرير، ثم قم بتشغيله مرة أخرى قبل دفع التغييرات.

مثال

قم بتشغيل الأمر من داخل مجلد مساحة العمل:

pac copilot pull

أو أشر إليه في مساحة عمل في مكان آخر على القرص:

pac copilot pull --project-dir contoso-support

معلمات اختيارية ل copilot pull

--project-dir -pd

المسار إلى دليل المشروع. الإعدادات الافتراضية لدليل العمل الحالي.

الملاحظات

  • قم بتشغيله داخل مساحة عمل مزامنة. pull يعمل الأمر فقط في مجلد تم إنشاؤه بواسطة pac copilot clone أو pac copilot init. يقرأ البيئة المستهدفة والعامل من بيانات تعريف مزامنة مساحة العمل، وهذا هو السبب في عدم وجود وسيطة --environment . إذا قمت بتشغيله في أي مكان آخر، فإنه يفشل مع خطأ "لم يتم العثور على مساحة العمل".
  • يكتب إلى ملفاتك المحلية. يدمج السحب التغييرات عن بعد في مساحة العمل وينزل ملفات المعرفة. قم بتنفيذ أو إجراء نسخ احتياطي للعمل المحلي الذي تهتم به قبل السحب.
  • سجل الدخول أولا باستخدام pac auth create.

pac copilot push

ادفع تغييرات مساحة العمل المحلية إلى Copilot Studio.

pac copilot push يرسل التغييرات في مساحة العمل المحلية مرة أخرى إلى العامل في Dataverse. فهو يقارن ملفاتك بحالة الخادم المعروفة الأخيرة، ويحمل فقط ما تم تغييره - بما في ذلك ملفات المعرفة وتدفقات السحابة ومراجع الاتصال - ويبلغ عما دفعه.

مثال

قم بتشغيله من داخل مجلد مساحة العمل:

pac copilot push

أو أشر إليه في مساحة عمل في مكان آخر على القرص:

pac copilot push --project-dir contoso-support

معلمات اختيارية ل copilot push

--project-dir -pd

المسار إلى دليل المشروع. الإعدادات الافتراضية لدليل العمل الحالي.

الملاحظات

  • قم بتشغيله داخل مساحة عمل مزامنة. مثل pull، push يعمل فقط في مجلد تم إنشاؤه بواسطة pac copilot clone أو pac copilot init. يقرأ البيئة الهدف من بيانات تعريف مزامنة مساحة العمل. لا --environment توجد حجة.
  • اسحب أولا إذا كان هناك تعارض. إذا تغير العنصر نفسه محليا وعلى الخادم، يتوقف الدفع ويطلب منك التشغيل pac copilot pull قبل المحاولة مرة أخرى. تحافظ هذه العملية على الدفع من الكتابة فوق تغيير من جانب الخادم لم تشاهده بصمت.
  • لا توجد تغييرات محلية هي no-op. إذا لم يعثر الدفع على أي شيء لإرساله، فإنه يبلغ عن ذلك ويخرج دون لمس البيئة.
  • يقوم الدفع الناجح بتحول العامل المباشر في البيئة المستهدفة.
  • سجل الدخول أولا باستخدام pac auth create.

pac copilot quarantine

حالة الحجر الصحي لعميل مساعد الطيار.

المعلمات المطلوبة ل copilot quarantine

--bot-id -id

هوية المساعد للحجر الصحي/إلغاء الحجر الصحي.

معلمات اختيارية ل copilot quarantine

--environment -env

البيئة (المعرف أو معرف المؤسسة أو عنوان url أو الاسم الفريد أو الاسم الجزئي).

--status -s

قيمة حالة الحجر الصحي. صحيح = حجر صحي، خطأ = إلغاء الحجر الصحي. الإعدادات الافتراضية إلى true.

لا تتطلب هذه المعلمة أي قيمة. إنه مفتاح

pac copilot status

تحقق من حالة نشر copilot محدد في بيئة Dataverse الحالية أو الهدف.

مثال

يستقصي هذا الأمر حالة نشر copilot محدد في بيئة Dataverse الحالية أو الهدف.

pac copilot status `
   --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
   --bot-id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e

يقوم الأمر بإرجاع الإخراج كما يلي:

Connected as user@contoso.org
Connected to... Contoso Organization
Virtual Agent New Bot German with ID 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e has been provisioned.

المعلمات المطلوبة ل copilot status

--bot-id -id

معرف copilot (Chatbot).

معلمات اختيارية ل copilot status

--environment -env

تحديد Dataverse الهدف. قد تكون القيمة GUID أو مطلق https URL. عند عدم التحديد، سيتم استخدام المؤسسة النشطة المحددة لملف تعريف المصادقة الحالي.

المصادقة والبيئة لأوامر المزامنة

clone push pullتتحدث جميع الأوامر و و إلى init --environment بيئة Dataverse، لذلك فإنها تحتاج إلى ملف تعريف مصادقة. سجل الدخول أولا باستخدام pac auth create.

  • clone، pull، واطلب push ملف تعريف نشط. pac copilot init يحتاج إلى واحد فقط عند المرور --environment؛ بدونه، init يقوم بدعم الملفات محليا ولا يحتاج إلى تسجيل الدخول.
  • pull واقرأ push البيئة الهدف من بيانات تعريف مزامنة مساحة العمل، حتى لا تأخذ وسيطة --environment . clone وفعل init .
  • pac copilot pack محلي بحت. يقرأ الملفات ويكتبها فقط، لذلك لا يحتاج إلى مصادقة ولا بيئة.

pull والعمل push فقط داخل مساحة عمل تم إنشاؤها بواسطة clone أو init. بيانات تعريف المزامنة المكتوبة عند إنشاء مساحة العمل هي ما يخبرهم بالعامل والبيئة التي يجب التحدث إليها، لذا يفشل تشغيلها في أي مكان آخر بسرعة مع ظهور خطأ "لم يتم العثور على مساحة العمل".

(راجع أيضًا)

Microsoft Power Platform مجموعات أوامر CLI
نظرة عامة على Microsoft Power Platform CLI

  • Last updated on