مشاركة عبر

pac copilot

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

Commands

الأمر الوصف
إنشاء pac copilot إنشاء copilot جديد باستخدام ملف قالب موجود كمرجع.
pac copilot extract-template استخراج ملف قالب من copilot موجود في بيئة.
pac copilot extract-translation استخراج ملف يحتوي على محتوى مترجم لواحد أو أكثر من الروبوتات.
قائمة pac copilot قائمة الأقباط في بيئة Dataverse الحالية أو المستهدفة.
pac copilot mcp معلومات حول خادم MCP المحلي (بروتوكول سياق النموذج).
ترجمة دمج pac copilot دمج الملفات التي تحتوي على محتوى مترجم لروبوت واحد أو أكثر.
قائمة نماذج pac copilot الذكاء الاصطناعي نماذج Builder في البيئة الحالية.
توقع نموذج pac copilot إرسال نص أو مطالبة إلى نموذج الذكاء الاصطناعي
نموذج pac copilot prepare-fetch يأخذ ملف FetchXML من الذكاء الاصطناعي Large Language Model (LLM) ويعده للتنفيذ مقابل البيئة الحالية.
نشر pac copilot نشر Copilot مخصص
حالة pac copilot تحقق من حالة نشر copilot محدد في بيئة Dataverse الحالية أو الهدف.

إنشاء pac copilot

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

المعلمات المطلوبة لإنشاء copilot

--displayName

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

--schemaName

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

--solution -s

اسم الحل.

--templateFileName

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

معلمات اختيارية لإنشاء 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

--bot -id

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

--templateFileName

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

معلمات اختيارية لقالب استخراج copilot

--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

--all -a

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

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

--bot -id

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

--environment -env

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

--format

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

--outdir

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

--overwrite -o

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

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

--sourcedir -src

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

قائمة pac copilot

قائمة الأقباط في بيئة 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

--environment -env

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

pac copilot mcp

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

مثال

pac copilot mcp --run

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

--run -r

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

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

Remarks

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

ترجمة دمج pac copilot

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

مثال

يدمج هذا الأمر الملفات التي تحتوي على محتوى مترجم لواحد أو أكثر من 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

--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

الذكاء الاصطناعي نماذج 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

--environment -env

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

توقع نموذج pac copilot

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

معلمات اختيارية للتنبؤ بنموذج copilot

--environment -env

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

--model-id -id

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

--model-name -n

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

--prompt -p

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

--text -t

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

نموذج pac copilot prepare-fetch

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

المعلمات المطلوبة لإحضار نموذج copilot

--inputFile -i

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

--outputFile -o

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

معلمات اختيارية لإحضار نموذج copilot

--environment -env

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

نشر pac copilot

نشر Copilot مخصص

المعلمات المطلوبة لنشر copilot

--bot -id

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

معلمات اختيارية لنشر copilot

--environment -env

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

حالة pac copilot

تحقق من حالة نشر 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

--bot-id -id

معرف copilot (Chatbot).

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

--environment -env

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

راجع أيضًا

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

  • Last updated on