שתף דרך

pac copilot

כלים וכלי שירות לניהול Copilot

פקודות

פקודה תיאור‬‏‫‬
pac copilot create יצירת טייס-ית חדש באמצעות קובץ תבנית קיים כהפניה.
pac copilot extract-template חילוץ קובץ תבנית מקובץ Copilot קיים בסביבה.
pac copilot extract-translation חילוץ קובץ המכיל תוכן המותאם לשפות אחרות עבור תוכנית Bot אחת או יותר.
pac copilot list רשימה של נקודות אחסון בסביבה הנוכחית או בסביבה Dataverse המשמשת כיעד.
pac copilot mcp מידע אודות שרת MCP מקומי (פרוטוקול הקשר מודל).
pac copilot merge-translation מזג קבצים המכילים תוכן המותאם לשפות אחרות עבור תוכנית Bot אחת או יותר.
pac copilot model list מודלים של AI Builder בסביבה הנוכחית.
pac copilot model predict שליחת טקסט או בקשה למודל בינה מלאכותית
pac copilot model prepare-fetch לוקח את קובץ FetchXML ממודל השפה הגדול של בינה מלאכותית (LLM) ומכין אותו לביצוע מול הסביבה הנוכחית.
pac copilot publish פרסום Copilot מותאם אישית
pac copilot status תשאול מצב הפריסה של נקודות מיקוד שצוינו בסביבה הנוכחית או בסביבה Dataverse המשמשת כיעד.

pac copilot create

יצירת טייס-ית חדש באמצעות קובץ תבנית קיים כהפניה.

פרמטרים נדרשים עבור copilot create

--displayName

שם התצוגה של קובץ ההשוטרים החדש

--schemaName

שם הסכימה (שם ייחודי) של קובץ ה- Copilot החדש.

--solution -s

שם הפתרון.

--templateFileName

קובץ yaml המשמש כמקור המכיל את תבנית ההשוטרים שחולצה באמצעות הפקודה 'תבנית חילוץ'.

פרמטרים אופציונליים עבור copilot create

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

pac copilot extract-template

חילוץ קובץ תבנית מקובץ Copilot קיים בסביבה.

דוגמה

פקודה זו מחלץ קובץ תבנית מקובץ Copilot קיים בסביבה.

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

הפקודה מחזירה פלט באופן הבא עבור טייס-תוקף באמצעות השפות אנגלית וגרמנית:

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 או שם הסכימה (שם ייחודי נמצא בפרטי Bot או בשם הקובץ בסייר הפתרונות).

--templateFileName

מיקום קובץ yaml שבו יש לכתוב את תבנית ההשוטרים.

פרמטרים אופציונליים עבור copilot extract-template

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--overwrite -o

אפשר החלפה של קובץ נתוני הפלט אם הוא כבר קיים.

לפרמטר זה אין כל ערך. זה מתג.

--templateName

שם תבנית או 'kickStartTemplate' אם לא צוין שם.

--templateVersion

גירסת תבנית בתבנית X.X.X או 1.0.0 אם לא צוינה גירסה.

pac copilot extract-translation

חילוץ קובץ המכיל תוכן המותאם לשפות אחרות עבור תוכנית Bot אחת או יותר.

דוגמה

פקודה זו מחלץ קובץ המכיל תוכן מותאם לשפות אחרות עבור קובץ אחד או יותר.

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 או שם הסכימה (שם ייחודי נמצא בפרטי Bot או בשם הקובץ בסייר הפתרונות).

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--format

תבנית הקובץ שבה יש לכתוב קבצים המותאמים לשפות אחרות, 'resx' או 'json'. ברירת המחדל היא 'resx'.

--outdir

ספריית הפלט שבה יש לכתוב.

--overwrite -o

אפשר החלפה של קובץ נתוני הפלט אם הוא כבר קיים.

לפרמטר זה אין כל ערך. זה מתג.

--sourcedir -src

ספריית פתרונות מקור. כאשר צוין, תתעלם מהסביבה המחוברת בעת חיפוש בוטים ובמקום זאת תחפש תוכן בתיקיה פתרון.

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

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

pac copilot mcp

מידע אודות שרת MCP מקומי (פרוטוקול הקשר מודל).

דוגמה

pac copilot mcp --run

פרמטרים אופציונליים עבור copilot mcp

--run -r

הפעל את שרת ה- MCP המקומי (פרוטוקול הקשר מודל).

לפרמטר זה אין כל ערך. זה מתג.

הערות

למד כיצד להשתמש ב- CLI של Power Platform עם שרת MCP מוכלל

pac copilot merge-translation

מזג קבצים המכילים תוכן המותאם לשפות אחרות עבור תוכנית Bot אחת או יותר.

דוגמה

פקודה זו ממזגת קבצים המכילים תוכן מותאם לשפות אחרות עבור צירוף אחד או יותר.

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

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--file -f

רשימת הקבצים המכילים תרגומים. דפוסי גלובוס נתמכים.

--solution -s

שם הפתרון.

--sourcedir -src

ספריית פתרונות מקור. כאשר צוין, תתעלם מהסביבה המחוברת בעת חיפוש בוטים ובמקום זאת תחפש תוכן בתיקיה פתרון.

--verbose

פלט מידע אבחון נוסף במהלך ייבוא/ייצוא של נתונים

לפרמטר זה אין כל ערך. זה מתג.

--whatif

אינו מבצע את הפקודה, אך יוצר פלט של הפרטים לגבי מה שיקרה.

לפרמטר זה אין כל ערך. זה מתג.

שגיאות מיזוג תרגום

בהתבסס על הדוגמה שלעיל, אם קיימת שגיאה אחת בקובץ המשמש לעדכון קובץ ההשוטרים, הפלט נראה כך:

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

מודלים של AI 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

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

pac copilot model predict

שליחת טקסט או בקשה למודל בינה מלאכותית

פרמטרים אופציונליים עבור copilot model predict

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

--model-id -id

מזהה מודל של AI Builder

--model-name -n

שם מודל בינה מלאכותית מלא או חלקי

--prompt -p

בקשה לשלוח למודל בינה מלאכותית

--text -t

טקסט לשליחה למודל בינה מלאכותית

pac copilot model prepare-fetch

לוקח את קובץ FetchXML ממודל השפה הגדול של בינה מלאכותית (LLM) ומכין אותו לביצוע מול הסביבה הנוכחית.

פרמטרים נדרשים עבור copilot model prepare-fetch

--inputFile -i

קובץ FetchXML של קלט שמגיע בדרך כלל מ- AI LLM.

--outputFile -o

קובץ FetchXML של פלט המוכן להפעלה מול הסביבה הנוכחית.

פרמטרים אופציונליים עבור copilot model prepare-fetch

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

pac copilot publish

פרסום Copilot מותאם אישית

פרמטרים נדרשים עבור copilot publish

--bot -id

מזהה Copilot או שם הסכימה (שם ייחודי נמצא בפרטי Bot או בשם הקובץ בסייר הפתרונות).

פרמטרים אופציונליים עבור copilot publish

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

pac copilot status

תשאול מצב הפריסה של נקודות מיקוד שצוינו בסביבה הנוכחית או בסביבה Dataverse המשמשת כיעד.

דוגמה

פקודה זו משאלת את מצב הפריסה של נקודות מיקוד שצוינו בסביבה הנוכחית או בסביבה 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 status

--environment -env

מציין את target Dataverse. הערך עשוי להיות GUID או כתובת URL מוחלטת של https. כאשר לא צוין, המערכת תשמש את הארגון הפעיל שנבחר עבור פרופיל האימות הנוכחי.

למידע נוסף

קבוצות פקודות CLI של Microsoft Power Platform
מבט כולל על Microsoft Power Platform CLI

  • Last updated on