pac copilot

כלים וכלי שירות לניהול טייסים.

הפקודות init, clone, pull, pushוpack- מאפשרות לך לשמור Copilot Studio כערכת קבצים בדיסק, לערוך אותו באופן מקומי ולסנכרן אותו עם סביבת Dataverse.

לולאה אופיינית נראית כך:

הפעל סביבת עבודה. פנה לסוכן חדש לגמרי באמצעות pac copilot init, או הורד סוכן קיים עם pac copilot clone. בכל מקרה, תקבל סביבת עבודה מקומית שנושאת את המטה-נתונים של הסינכרון שהפקודות האחרות תלויות בהם.
משוך לפני העריכה. pac copilot pull מביא שינויים מרוחקים כלפי מטה וממזג אותם לתוך הקבצים המקומיים שלך, כך שאתה מתחיל מהשרת הנוכחי.
תלחץ כשתסיים. pac copilot push שולח את השינויים המקומיים שלך בחזרה. אם אותו פריט השתנה בשרת בינתיים, הפסקות דחיפה ובקש ממך למשוך תחילה.
חבילה לפריסה. pac copilot pack הפיכת סביבת עבודה לפתרון שבאפשרותך .zip לפרוס באמצעות pac solution import.

כדי לעבור מכלום לסוכן חי בשלב אחד, pac copilot init --environment פיגומים, חבילות, ייבוא וחיבור סביבת העבודה עבורך. הפקודות הבודדות מאפשרות לך לנהוג בכל חלק של הלולאה בנפרד.

פקודות

הפקודה	תיאור
pac copilot clone	שכפל סוכן Copilot Studio למדריך כתובות מקומי של סביבת עבודה.
pac copilot create	יצירת טייס-ית חדש באמצעות קובץ תבנית קיים כהפניה.
pac copilot delete	מחיקת פריט מותאם Copilot.
pac copilot extract-template	חילוץ קובץ תבנית מקובץ Copilot קיים בסביבה.
pac copilot extract-translation	חילוץ קובץ המכיל תוכן המותאם לשפות אחרות עבור תוכנית Bot אחת או יותר.
pac copilot init	צור סביבת עבודה Copilot Studio של סוכן חדש מתבנית.
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 pack	ארוז סביבת Copilot Studio של סוכן דואר אלקטרוני לתוך קובץ zip של פתרון.
pac copilot publish	פרסום Copilot מותאם אישית
pac copilot pull	משוך שינויים מרוחקים Copilot Studio ומיזוג עם סביבת עבודה מקומית.
pac copilot push	דחוף שינויים בסביבת העבודה המקומית Copilot Studio.
pac copilot quarantine	מצב הבידוד של סוכן הטייס המשנה.
pac copilot status	תשאול מצב הפריסה של נקודות מיקוד שצוינו בסביבה הנוכחית או בסביבה 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 או שם הסכימה (שם ייחודי נמצא בפרטי Bot או בשם הקובץ בסייר הפתרונות).

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

`--component-collection` `-cc`

מזהה אוסף רכיבים לשכפול. חזור על פעולות מרובות.

`--display-name` `-dn`

שם התצוגה של הסוכן (משמש למתן שמות לתיקיה).

`--environment` `-env`

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

`--output-dir` `-od`

תיקיית בסיס לפלט משוכפל. ברירות מחדל למדריך הכתובות הנוכחי.

הערות

--botמקבל מזהה Copilot או שם סכימה. להעביר את Copilot המזהה (GUID) או את שם הסכימה של הסוכן. הפקודה מזהה שם סכימה מול סביבת היעד.
תיקיית המשנה המהווה יעד חייבת להיות ריקה. שכפול כתיבה בתיקיה ששמה נקרא על שם התצוגה של הסוכן (מבוטאות) תחת --output-dir. אם תיקיה זו כבר מכילה קבצים, השכפול מפסיק במקום להחליף אותם. השתמש --display-name כדי לבחור שם תיקיה אחר.
שכפול אוספי רכיבים. כדי להוסיף אוספי רכיבים לצד הסוכן, העבר זהה --component-collectionאוסף אחד או יותר באמצעות , המופרדים באמצעות תווי נקודה-פסיק.
שכפול דורש פרופיל מאומת (pac auth create) ופתר --environmentאת הסביבה מתוך , או מהארגון של הפרופיל הפעיל כאשר אתה מושמט אותו.

pac copilot create

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

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

`--displayName`

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

`--schemaName`

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

`--solution` `-s`

שם הפתרון.

`--templateFileName`

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

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

`--environment` `-env`

pac copilot delete

מחיקת פריט מותאם Copilot.

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

`--bot` `-id`

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

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

`--confirm` `-y`

נדרש כדי לאשר את מחיקת קובץ ה- Copilot.

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

`--environment` `-env`

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`

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

`--format`

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

`--outdir`

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

`--overwrite` `-o`

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

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

`--sourcedir` `-src`

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

pac copilot init

צור סביבת עבודה Copilot Studio של סוכן חדש מתבנית.

pac copilot initפיגומים של סביבת Copilot Studio של סוכן חדש מתבנית. הוא פועל באחד משני מצבים, והנוכחות קובעת --environment באיזה מצב להשתמש:

פיגם מקומי - לא --environment. כתיבת קבצי התבנית במדריך הכתובות של הפרוייקט והפסקתה. הפקודה אינה יוצרת דבר ב- Dataverse שאינה דורשת כניסה. השתמש במצב זה כאשר ברצונך לבצע עריכה מקומית ולחבר לסביבה במועד מאוחר יותר.
Bootstrap — --environment מסופק. Scaffolds the files, packages them into a solution, imports that solution into the environment, and connects the workspace to the newly created agent. מצב זה הוא נתיב של שלב אחד מכלום לסוכן חי ומוכן לסינכרון, והוא דורש פרופיל מאומת.

דוגמאות

פיגם סביבת עבודה באופן מקומי:

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

Scaffold and bootstrap a live agent in an environment in a single step:

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

Scaffold a CLI-authored (CliCopilot) agent into a specific folder:

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`

`--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 Bootstraps a live agent in one step for the default classic mode and for --authoring-mode cli-copilot. לחלופין, עבור סוכן CliCopilot, באפשרותך לבצע פיגום באופן מקומי (לא --environment) pac copilot packpac solution import ולאחר מכן להפעיל אותו כדי לפרוס אותו בעצמך.
Bootstrap יוצר אובייקטים בצד השרת. במצב bootstrap, init מייבא פתרון וייצור את הסוכן בסביבות היעד. אם כבר קיים סוכן בעל שם סכימה זהה, initpac 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`

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`

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

pac copilot model predict

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

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

`--environment` `-env`

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

pac copilot pack

ארוז סביבת Copilot Studio של סוכן דואר אלקטרוני לתוך קובץ zip של פתרון.

pac copilot pack אריזת סביבת עבודה של סוכן לפתרון Dataverse .zip שניתן לפרוס באמצעות pac solution import. זו צורת האריזה pac copilot init --environment העצמאית שפועלת עבורך, כך שתוכל להפיק את הפתרון הניתן לפריסה כצעד נפרד - לדוגמה, בצינור של גירסת Build. הוא פועל הן עבור סביבות עבודה קלאסיות והן עבור סביבות עבודה של סוכן (CliCopilot) שעורכים CLI.

לדוגמה

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

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

`--publisher-prefix` `-pp`

Publisher התאמה אישית של הפתרון.

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

`--output-path` `-op`

נתיב פלט עבור קובץ ה- zip של הפתרון. ברירות מחדל למדריך הכתובות הנוכחי.

`--project-dir` `-pd`

מדריך הכתובות של סביבת העבודה של הסוכן לחבילה. ברירות מחדל למדריך הכתובות הנוכחי.

`--solution-name` `-sn`

שם ייחודי של פתרון. אם הוא מושמט, נגזר משם הסכימה של הסוכן.

הערות

זו פעולה מקומית. הערכה מקריאת את סביבת העבודה וכותבים פתרון .zip. הוא אינו זקוק לאימות ולא לסביבה, ולכן בטוח לפעול בצינור של גירסת Build.
קידומת המפרסם חייבת להיות חוקית. --publisher-prefix חייבת להיות קידומת התאמה אישית במבנה תקין, או שהערכה מפסיקה לפני כתיבת פריטים.
שם הפתרון והפלט. אם אתה מושמט --solution-name, השם הייחודי של הפתרון נגזר משם הסכימה של הסוכן. ה .zip - נכתב במדריך הכתובות הנוכחי, אלא אם תגדיר את --output-path.
הערכה אינה נפרסת. הוא יוצר את הפתרון אך אינו מייבא אותו. עקוב אחריו pac solution import כדי לפרוס את הסוכן, ולאחר pac copilot clone מכן אם אתה מעוניין בסביבת עבודה המחוברת לסינכרון עבורה.

pac copilot publish

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

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

`--bot` `-id`

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

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

`--environment` `-env`

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 initpac copilot clone . הוא קורא את סביבת היעד ואת הסוכן ממטה-נתונים של הסינכרון של סביבת העבודה, ולכן אין --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, פועל רק בתיקיה שנוצרה על-ידי או pac copilot clonepac copilot init. push הוא קורא את סביבת היעד ממטה-נתונים של הסינכרון של סביבת העבודה. אין שום --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 = בידוד, שקר = הסרת בידוד. ברירת המחדל היא true.

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

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`

אימות וסביבה עבור פקודות הסינכרון

הפקודות clone, pull, pushו init --environment - מדברות כולן לסביבה Dataverse, כך שהן זקוקות לפרופיל אימות. היכנס תחילה באמצעות pac auth create.

clone, pullודרוש push פרופיל פעיל. pac copilot init צריך רק אחד כאשר אתה מעביר --environment; בלעדיו, init פיגומים קבצים באופן מקומי ולא צריך כניסה.
pull וקרא push את סביבת היעד ממטה-נתונים של הסינכרון של סביבת העבודה, כך שהם לא יתווכנו --environment ארגומנט. clone ותבצע init .
pac copilot pack היא מקומית באופן טהור. הוא קורא כותב קבצים בלבד, כך שאין צורך באימות או בסביבה.

pull ופועלים push רק בתוך סביבת עבודה שנוצרה על-ידי או cloneinit. המטה-נתונים של הסינכרון שנכתבו כאשר סביבת העבודה נוצרת הם מה שמסביר לאילו סוכן וסביבה לדבר, כך שהפעלתם בכל מקום אחר נכשלת במהירות עם השגיאה "סביבת העבודה לא נמצאה".

‏‫ראו גם‬

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

משוב

האם עמוד זה היה מועיל?

Last updated on 2026-07-14

pac copilot

פקודות

pac copilot clone

לדוגמה

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

--bot -id

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

--component-collection -cc

--display-name -dn

--environment -env

--output-dir -od

הערות

pac copilot create

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

--displayName

--schemaName

--solution -s

--templateFileName

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

--environment -env

pac copilot delete

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

--bot -id

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

--confirm -y

--environment -env

pac copilot extract-template

לדוגמה

פרמטרים נדרשים עבור copilot extract-template

--bot -id

--templateFileName

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

--environment -env

--overwrite -o

--templateName

--templateVersion

pac copilot extract-translation

לדוגמה

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

--all -a

--bot -id

--environment -env

--format

--outdir

--overwrite -o

--sourcedir -src

pac copilot init

דוגמאות

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

--name -n

--publisher-prefix -pp

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

--authoring-mode -am

--environment -env

--instructions -ins

--project-dir -pd

--schema-name -sn

--template -t

הערות

pac copilot list

לדוגמה

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

--environment -env

pac copilot mcp

לדוגמה

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

--run -r

הערות

pac copilot merge-translation

לדוגמה

פרמטרים אופציונליים עבור copilot merge-translation

--environment -env

--file -f

--solution -s

--sourcedir -src

--verbose

--whatif

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

pac copilot model list

לדוגמה

`--bot` `-id`

`--component-collection` `-cc`

`--display-name` `-dn`

`--environment` `-env`

`--output-dir` `-od`

`--displayName`

`--schemaName`

`--solution` `-s`

`--templateFileName`

`--environment` `-env`

`--bot` `-id`

`--confirm` `-y`

`--environment` `-env`

`--bot` `-id`

`--templateFileName`

`--environment` `-env`

`--overwrite` `-o`

`--templateName`

`--templateVersion`

`--all` `-a`

`--bot` `-id`

`--environment` `-env`

`--format`

`--outdir`

`--overwrite` `-o`

`--sourcedir` `-src`

`--name` `-n`

`--publisher-prefix` `-pp`

`--authoring-mode` `-am`

`--environment` `-env`

`--instructions` `-ins`

`--project-dir` `-pd`

`--schema-name` `-sn`

`--template` `-t`

`--environment` `-env`

`--run` `-r`

`--environment` `-env`

`--file` `-f`

`--solution` `-s`

`--sourcedir` `-src`

`--verbose`

`--whatif`

`--environment` `-env`

`--environment` `-env`

`--model-id` `-id`

`--model-name` `-n`

`--prompt` `-p`

`--text` `-t`

`--inputFile` `-i`

`--outputFile` `-o`

`--environment` `-env`

`--publisher-prefix` `-pp`

`--output-path` `-op`

`--project-dir` `-pd`

`--solution-name` `-sn`

`--bot` `-id`

`--environment` `-env`

`--project-dir` `-pd`

`--project-dir` `-pd`

`--bot-id` `-id`

`--environment` `-env`

`--status` `-s`

`--bot-id` `-id`

`--environment` `-env`