pac copilot

Nástroje a pomôcky pre správu kopilotu.

Príkazy init, clone, pushpulla pack umožňujú uchovávať agenta Copilot Studio ako množinu súborov na disku, lokálne upravovať a synchronizovať ho s prostredím Dataverse.

Typická slučka vyzerá takto:

Spustite pracovný priestor. Podporná aplikácia pre úplne nového agenta s pac copilot initalebo stiahnutie existujúceho pomocou pac copilot clone. V oboch smeroch získate lokálny pracovný priestor, ktorý obsahuje metaúdaje synchronizácie, od čoho závisia ostatné príkazy.
Pred úpravou vytiahnite. pac copilot pull Spustí vzdialené zmeny a zlúči ich do lokálnych súborov, takže začnete od aktuálneho stavu servera.
Posunutie, keď skončíte. pac copilot push funkcia odošle lokálne zmeny späť. Ak sa rovnaká položka zmenila na serveri do tej doby, push zastaví a požiada vás, aby ste vytiahnuť ako prvý.
Balík na nasadenie. pac copilot packZmení pracovný priestor na riešenie.zip, ktoré môžete nasadiť s .pac solution import

Ak chcete prejsť z ničoho na dynamického agenta v jednom kroku, pac copilot init --environment podporne, balíky, importy a pripojí pracovný priestor za vás. Jednotlivé príkazy vám umožňujú samostatne riadiť každú časť slučky.

Príkazy

Príkaz	Popis
pac copilot clone	Naklonujte agenta Copilot Studio do adresára lokálneho pracovného priestoru.
pac copilot create	Vytvorí novú kopilot s použitím existujúceho súboru šablóny ako odkazu.
pac copilot delete	Odstránenie vlastného Copilot.
pac copilot extract-template	Extrahuje súbor šablóny z existujúceho kopilotu v prostredí.
pac copilot extract-translation	Extrahuje súbor obsahujúci lokalizovaný obsah pre jedného alebo viacerých botov.
pac copilot init	Vytvorte nový pracovný priestor Copilot Studio agenta zo šablóny.
pac copilot list	Zoznam kopírovaných polí v aktuálnom alebo cieľovom prostredí Dataverse.
pac copilot mcp	Informácie o lokálnom serveri MCP (kontextový protokol modelu).
pac copilot merge-translation	Zlúčenie súborov obsahujúcich lokalizovaný obsah pre jedného alebo viacerých botov.
pac copilot model list	Modely AI Buildera v aktuálnom prostredí.
pac copilot model predict	Odoslanie textu alebo výzvy modelu AI
pac copilot model prepare-fetch	Vezme súbor FetchXML z modelu AI Large Language Model (LLM) a pripraví ho na vykonanie v aktuálnom prostredí.
pac copilot pack	Zbalte pracovný priestor Copilot Studio agenta do súboru zip riešenia.
pac copilot publish	Publikovanie vlastného kopilotu
pac copilot pull	Vyžiadať vzdialené zmeny z Copilot Studio a zlúčiť s lokálnym pracovným priestorom.
pac copilot push	Presunutie zmien lokálneho pracovného priestoru do Copilot Studio.
pac copilot quarantine	Karanténny stav kopilota.
pac copilot status	Prehľad stavu nasadenia určeného kopilotu v aktuálnom alebo cieľovom prostredí Dataverse.

pac copilot clone

Naklonujte agenta Copilot Studio do adresára lokálneho pracovného priestoru.

pac copilot cloneStiahne existujúceho Copilot Studio agenta do adresára lokálneho pracovného priestoru spolu so synchronizáciou metaúdajov, ktoré pac copilot pull sú závislé od nichpac copilot push. Súbory agenta sa zapíšu do podpriečinka pomenovaného podľa jeho zobrazovaného mena.

Príklad

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

Povinné parametre pre copilot clone

`--bot` `-id`

ID kopilotu alebo názov schémy (jedinečný názov, ktorý sa nachádza v časti Bot Details alebo názov súboru v prieskumníkovi riešení).

Voliteľné parametre pre copilot clone

`--component-collection` `-cc`

ID kolekcie súčastí na klonovanie. Opakujte postup pre viaceré položky.

`--display-name` `-dn`

Zobrazovaný názov agenta (používa sa na pomenovanie priečinkov).

`--environment` `-env`

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

`--output-dir` `-od`

Koreňový priečinok pre výstup klonovania. Predvolene sa nastaví na aktuálny adresár.

Poznámky

--botmetóda akceptuje ID Copilot alebo názov schémy. Odovzdajte buď ID Copilot (IDENTIFIKÁTOR GUID), alebo názov schémy agenta. Príkaz vyrieši názov schémy v cieľovom prostredí.
Cieľový podpriečinok musí byť prázdny. Clone zapíše do priečinka pomenovaného podľa (dezinfikovaného) zobrazovaného názvu agenta v časti --output-dir. Ak tento priečinok už obsahuje súbory, klon sa zastaví a nie ich prepíše. Pomocou --display-name vyberte iný názov priečinka.
Klonovanie kolekcií súčastí. Ak chcete spolu s agentom presunúť kolekcie súčastí, odovzdajte jedno alebo viacero ID kolekcií oddelenými --component-collectionbodkočiarkami.
Clone vyžaduje overený profil (pac auth create) a vyrieši prostredie z --environment, alebo z organizácie aktívneho profilu, keď ho vynecháte.

pac copilot create

Vytvorí novú kopilot s použitím existujúceho súboru šablóny ako odkazu.

Povinné parametre pre copilot create

`--displayName`

Zobrazovaný názov novej kopilotu

`--schemaName`

Názov schémy (jedinečný názov) novej kopilotu.

`--solution` `-s`

Názov riešenia.

`--templateFileName`

Zdrojový súbor yaml obsahujúci šablónu kopilotu, ktorá bola extrahovaná pomocou príkazu extract-template.

Voliteľné parametre pre copilot create

`--environment` `-env`

pac copilot delete

Odstránenie vlastného Copilot.

Povinné parametre pre copilot delete

`--bot` `-id`

ID kopilotu alebo názov schémy (jedinečný názov, ktorý sa nachádza v časti Bot Details alebo názov súboru v prieskumníkovi riešení).

Voliteľné parametre pre copilot delete

`--confirm` `-y`

Vyžaduje sa na potvrdenie odstránenia kopilotu.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

`--environment` `-env`

pac copilot extract-template

Extrahuje súbor šablóny z existujúceho kopilotu v prostredí.

Príklad

Tento príkaz extrahuje súbor šablóny z existujúceho kopilotu v prostredí.

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

Príkaz vráti pre kopilot výstup v rovnakom ako v anglickom a nemeckom jazyku:

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

Povinné parametre pre copilot extract-template

`--bot` `-id`

ID kopilotu alebo názov schémy (jedinečný názov, ktorý sa nachádza v časti Bot Details alebo názov súboru v prieskumníkovi riešení).

`--templateFileName`

Umiestnenie súboru yaml, do ktorého sa má zapisovať šablóna kopilotu.

Voliteľné parametre pre copilot extract-template

`--environment` `-env`

`--overwrite` `-o`

Povoliť prepísanie výstupného súboru údajov, ak už existuje.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

`--templateName`

Názov šablóny alebo kickStartTemplate, ak názov nie je zadaný.

`--templateVersion`

Verzia šablóny vo formáte X.X.X alebo 1.0.0, ak verzia nie je zadaná.

pac copilot extract-translation

Extrahuje súbor obsahujúci lokalizovaný obsah pre jedného alebo viacerých botov.

Príklad

Tento príkaz extrahuje súbor obsahujúci lokalizovaný obsah pre jedno alebo viacero kópií.

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

Príkaz vráti výstup približne takto:

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

Voliteľné parametre pre copilot extract-translation

`--all` `-a`

Píšte lokalizované súbory pre všetky podporované jazyky. Predvolene je zapísaný iba primárny jazyk.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

`--bot` `-id`

ID kopilotu alebo názov schémy (jedinečný názov, ktorý sa nachádza v časti Bot Details alebo názov súboru v prieskumníkovi riešení).

`--environment` `-env`

`--format`

Formát súboru, v ktorom sa majú zapisovať lokalizované súbory, resx alebo json. Predvolená hodnota je resx.

`--outdir`

Výstupný adresár, do ktorý sa má zapisovať.

`--overwrite` `-o`

Povoliť prepísanie výstupného súboru údajov, ak už existuje.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

`--sourcedir` `-src`

Zdrojový adresár riešení. Ak je zadaná, bude pri vyhľadávaní botov ignorovať pripojené prostredie a namiesto toho vyhľadať obsah v priečinku riešení.

pac copilot init

Vytvorte nový pracovný priestor Copilot Studio agenta zo šablóny.

pac copilot initnový Copilot Studio pracovný priestor agenta zo šablóny. Spustí sa v jednom z dvoch režimov a prítomnosť --environment rozhodne, ktorý režim používať:

Lokálna podporná podpora – nie --environment. Zapíše súbory šablón do adresára projektu a zastaví sa. Príkaz nevytvorí nič v službe Dataverse a nevyžaduje prihlásenie. Tento režim použite, ak chcete vykonať lokálne vytváranie a neskôr sa pripojiť k prostrediu.
Bootstrap – --environment dodávané. Podporne súbory ich zhrnú do riešenia, importujú toto riešenie do prostredia a prepoja pracovný priestor s novovytvoreným agentom. Tento režim je cesta s jedným krokom od nič k dynamickému agentovi pripravenému na synchronizáciu a vyžaduje overený profil.

Príklady

Podporná služba lokálne v pracovnom priestore:

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

Podpora a spustenie živého agenta v prostredí v jednom kroku:

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

Podporná agentka typu CLI (CliCopilot) je určená pre konkrétny priečinok:

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

Povinné parametre pre copilot init

`--name` `-n`

Zobrazované meno agenta.

`--publisher-prefix` `-pp`

Publisher predponu prispôsobenia riešenia.

Voliteľné parametre pre copilot init

`--authoring-mode` `-am`

Agent, ktorý má tvar na scaffold (predvolené: klasický). Použite cli-copilot na oslnenia agenta CliCopilot vytvoreného pomocou rozhrania CLI.

`--environment` `-env`

`--instructions` `-ins`

Pokyny týkajúce sa systému agenta.

`--project-dir` `-pd`

Cieľový adresár pre pracovný priestor agenta. Predvolene sa nastaví na aktuálny adresár.

`--schema-name` `-sn`

Úplný názov schémy agenta. Prepíše predvolené odvodenie ({publisher-predpona}_{sanitized-name}). Použité as-is bez modifikácie.

`--template` `-t`

Názov profilu šablóny (predvolený, minimálny). Predvolená hodnota je predvolená.

Poznámky

Adresár projektu musí byť prázdny. init sa neprenáša nad existujúcimi súbormi, takže ukážte --project-dir na nový alebo prázdny priečinok.
Odvodenie názvu schémy. Keď vynecháte --schema-nameparameter , názov schémy agenta bude vytvorený ako {publisher-prefix}_{sanitized-name}. Úspešné absolvovanie --schema-name , ak ho chcete nastaviť explicitne. Hodnota sa použije as-is.
Bootstrap funguje v oboch režimoch na vytváranie. init --environment bootstraps dynamického agenta v jednom kroku pre predvolený klasický režim a pre --authoring-mode cli-copilot. Ako alternatívu k agentovi CliCopilot môžete postupovať lokálne (nie --environment), potom ju spustiť pac copilot pack a pac solution import nasadiť sami.
Bootstrap vytvorí objekty na strane servera. V režime bootstrapu init importuje riešenie a vytvorí agenta v cieľovom prostredí. Ak už existuje agent s rovnakým názvom schémy, zastaví sa a nastoľuje vás, init aby pac copilot clone ste sa namiesto toho pripojili k existujúcemu agentovi.
Úplne nové prostredie môže spomaliť prijatie prvého importu. Čerstvo vytvorené prostredie môže minútu alebo dve trvať, kým sa zohreje. Skoré spustenie môže zlyhať s textom "Async operations are currently disabled for this organization" (Asynchrónne operácie sú v tejto organizácii momentálne zakázané). Počkajte chvíľu a spustite ho znova.
--template (default alebo minimal) sa vzťahuje iba na klasický režim authoring.

pac copilot list

Zoznam kopírovaných polí v aktuálnom alebo cieľovom prostredí Dataverse.

Príklad

Tento príkaz obsahuje zoznam všetkých kopírovaní v aktuálnom alebo cieľovom prostredí Dataverse.

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

Príkaz vráti výstup približne takto:

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

Voliteľné parametre pre copilot list

`--environment` `-env`

pac copilot mcp

Informácie o lokálnom serveri MCP (kontextový protokol modelu).

Príklad

pac copilot mcp --run

Voliteľné parametre pre copilot mcp

`--run` `-r`

Spustite lokálny server MCP (kontextový protokol modelu).

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

Poznámky

Naučte sa používať nástroj Power Platform CLI so vstavaným MCP serverom

pac copilot merge-translation

Zlúčenie súborov obsahujúcich lokalizovaný obsah pre jedného alebo viacerých botov.

Príklad

Tento príkaz zlučuje súbory obsahujúce lokalizovaný obsah pre jedno alebo viacero kópií.

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

Príkaz vráti pri aktualizácii nemeckého jazyka výstup približne takto:

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.

Informácie o spravovaní chýb pomocou príkazu zlúčenia a prekladu

Voliteľné parametre pre copilot merge-translation

`--environment` `-env`

`--file` `-f`

Zoznam súborov, ktoré obsahujú preklady. Podporované sú glob vzory.

`--solution` `-s`

Názov riešenia.

`--sourcedir` `-src`

Zdrojový adresár riešení. Ak je zadaná, bude pri vyhľadávaní botov ignorovať pripojené prostredie a namiesto toho vyhľadať obsah v priečinku riešení.

`--verbose`

Výstup ďalších diagnostických informácií počas importu a exportu údajov

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

`--whatif`

Príkaz sa nevykoná, ale výstupom budú podrobnosti o tom, čo sa stane.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

chyby zlúčenia a prekladu

Ak v súbore, ktorý sa používa na aktualizáciu kopilotu, na základe vyššie uvedeného príkladu existuje jedna chyba, výstup bude vyzerať takto:

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.

Príznak --verbose pridá podrobnosti o chybe:

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

Modely AI Buildera v aktuálnom prostredí.

Príklad

Tento príkaz obsahuje zoznam všetkých modelov AI Buildera.

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

Príkaz vráti výstup približne takto:

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

Voliteľné parametre pre copilot model list

`--environment` `-env`

pac copilot model predict

Odoslanie textu alebo výzvy modelu AI

Voliteľné parametre pre copilot model predict

`--environment` `-env`

`--model-id` `-id`

ID modelu AI Buildera

`--model-name` `-n`

Úplný alebo čiastočný názov modelu AI

`--prompt` `-p`

Výzva na odoslanie do modelu AI

`--text` `-t`

Text, ktorý sa má odoslať do modelu AI

pac copilot model prepare-fetch

Vezme súbor FetchXML z modelu AI Large Language Model (LLM) a pripraví ho na vykonanie v aktuálnom prostredí.

Povinné parametre pre copilot model prepare-fetch

`--inputFile` `-i`

Vstupný súbor FetchXML, ktorý zvyčajne pochádza z rozhrania AI LLM.

`--outputFile` `-o`

Výstupný súbor FetchXML, ktorý je pripravený na vykonanie v aktuálnom prostredí.

Voliteľné parametre pre copilot model prepare-fetch

`--environment` `-env`

pac copilot pack

Zbalte pracovný priestor Copilot Studio agenta do súboru zip riešenia.

pac copilot packZhotí pracovný priestor agenta do riešenia .zip Dataverse, ktoré môžete nasadiť s .pac solution import Ide o samostatnú formu kroku balenia, ktorý pac copilot init --environment sa spúšťa za vás, takže môžete vytvoriť nasaditeľné riešenie ako samostatný krok – napríklad v kanáli zostáv. Funguje v klasických agentoch aj v pracovných priestoroch vytvorených pomocou rozhrania CLI (CliCopilot).

Príklad

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

Povinné parametre pre copilot pack

`--publisher-prefix` `-pp`

Publisher predponu prispôsobenia riešenia.

Voliteľné parametre pre copilot pack

`--output-path` `-op`

Výstupná cesta k súboru zip riešenia. Predvolene sa nastaví na aktuálny adresár.

`--project-dir` `-pd`

Adresár agenta pracovného priestoru na vytvorenie balíka. Predvolene sa nastaví na aktuálny adresár.

`--solution-name` `-sn`

Jedinečný názov riešenia. Ak sa vynechá, odvodený od názvu schémy agenta.

Poznámky

Je to lokálna operácia. Balík prečíta pracovný priestor a zapíše riešenie .zip. Nepotrebuje žiadne overovanie a žiadne prostredie, takže je bezpečné spúšťať ho v kanáli zostáv.
Predpona vydavateľa musí byť platná. --publisher-prefix Predponou prispôsobenia musí byť dobre vytvorená predpona alebo balík sa pred napísaním čohokoľvek zastaví.
Názov a výstup riešenia. Ak vynecháte --solution-nameparameter , jedinečný názov riešenia je odvodený od názvu schémy agenta. Sa .zip zapíše do aktuálneho adresára, ak nenastavíte --output-path.
Balík sa nenasadí. Vytvorí riešenie, ale neimportuje ho. Postupujte podľa neho s pokynmi pac solution import na nasadenie agenta. pac copilot clone Ak chcete, aby bol pracovný priestor pripojený synchronizovane.

pac copilot publish

Publikovanie vlastného kopilotu

Povinné parametre pre copilot publish

`--bot` `-id`

ID kopilotu alebo názov schémy (jedinečný názov, ktorý sa nachádza v časti Bot Details alebo názov súboru v prieskumníkovi riešení).

Voliteľné parametre pre copilot publish

`--environment` `-env`

pac copilot pull

Vyžiadať vzdialené zmeny z Copilot Studio a zlúčiť s lokálnym pracovným priestorom.

Príkaz pac copilot pull načíta aktuálny stav servera agenta a zlúči ho do vášho lokálneho pracovného priestoru pomocou trojkolesového zlúčenia. Tento proces zabezpečí, že úpravy na strane servera aj vaše nedotknuté lokálne súbory zostanú neporušené. Pred začatím úprav ju spustite a pred presunutím zmien ju spustite znova.

Príklad

Spustite príkaz z vnútra priečinka pracovného priestoru:

pac copilot pull

Prípadne namierte ho na pracovný priestor na inom mieste na disku:

pac copilot pull --project-dir contoso-support

Voliteľné parametre pre copilot pull

`--project-dir` `-pd`

Cesta k adresáru projektu. Predvolene sa nastaví aktuálny pracovný adresár.

Poznámky

Spustite ho v pracovnom priestore synchronizácie. Príkaz pull funguje iba v priečinku, ktorý vytvoril používateľ pac copilot clone alebo pac copilot init. Prečíta cieľové prostredie a agenta zo synchronizácie metaúdajov pracovného priestoru, a preto neexistuje žiadny --environment argument. Ak ju spustíte kdekoľvek inde, zobrazí sa chyba Pracovný priestor, ktorý sa nenašiel.
Zapisuje sa do lokálnych súborov. Potiahnutie zlúči vzdialené zmeny do pracovného priestoru a stiahne súbory vedomostí. Potvrdiť alebo zálohovať miestnu prácu, o ktorú vám pred vytiahnutím záleží.
Najskôr sa prihláste pomocou .pac auth create

pac copilot push

Presunutie zmien lokálneho pracovného priestoru do Copilot Studio.

pac copilot push funkcia odošle zmeny v lokálnom pracovnom priestore späť do agenta v službe Dataverse. Prirovnáva súbory k poslednému známemu stavu servera, nahráva len to, čo sa zmenilo – vrátane súborov vedomostí, cloudových postupov a odkazov na pripojenie – a zostáv, na čo tlačil.

Príklad

Spustite ho z priečinka pracovného priestoru:

pac copilot push

Prípadne namierte ho na pracovný priestor na inom mieste na disku:

pac copilot push --project-dir contoso-support

Voliteľné parametre pre copilot push

`--project-dir` `-pd`

Cesta k adresáru projektu. Predvolene sa nastaví aktuálny pracovný adresár.

Poznámky

Spustite ho v pracovnom priestore synchronizácie. Rovnako ako pull, push funguje len v priečinku, ktorý vytvoril používateľ pac copilot clone alebo pac copilot init. Prečíta cieľové prostredie zo synchronizácie metaúdajov pracovného priestoru. Neexistuje žiadny --environment argument.
Najskôr to v prípade konfliktu natiahnite. Ak sa rovnaká položka zmenila lokálne aj na serveri, zasunutím zastavíte a zobrazí sa požiadavka na spustenie pac copilot pull pred ďalším pokusom. Tento proces udržiava tlak od ticho prepisovanie server-strane zmeny ste nevideli.
Žiadne lokálne zmeny nie sú no-op. Ak push nájde nič poslať, to správy, že a výstupy bez toho, aby sa dotýkali prostredia.
Úspešný push mutuje živý agent v cieľovom prostredí.
Najskôr sa prihláste pomocou .pac auth create

pac copilot quarantine

Karanténny stav kopilota.

Povinné parametre pre copilot quarantine

`--bot-id` `-id`

ID kopilota na karanténu/odkaranténu.

Voliteľné parametre pre copilot quarantine

`--environment` `-env`

Prostredie (ID, ID organizácie, URL adresa, jedinečný názov alebo čiastočný názov).

`--status` `-s`

Hodnota karanténneho stavu. true = karanténa, false = odkaranténa. Predvolene je to pravda.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

pac copilot status

Prehľad stavu nasadenia určeného kopilotu v aktuálnom alebo cieľovom prostredí Dataverse.

Príklad

Tento príkaz načíta stav nasadenia určeného typu kopilotu v aktuálnom alebo cieľovom prostredí Dataverse.

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

Príkaz vráti výstup približne takto:

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

Povinné parametre pre copilot status

`--bot-id` `-id`

ID kopilotu (Chatbot).

Voliteľné parametre pre copilot status

`--environment` `-env`

Overovanie a prostredie pre príkazy synchronizácie

Všetky clonepríkazy , pull, pusha init --environment hovoria s prostredím Dataverse, takže potrebujú profil overenia. Najskôr sa prihláste pomocou .pac auth create

clone, pulla push vyžadujú aktívny profil. pac copilot initFunkcia bude potrebná len vtedy, init keď odovzdávate --environmentobsah . Bez neho sa podporná služba súbory používa lokálne a nepotrebuje žiadne prihlásenie.
pull a push prečítajte si cieľové prostredie zo synchronizovaných metaúdajov pracovného priestoru, aby nepreberá --environment argument. clone a init áno.
pac copilot pack je čisto lokálna. Číta a píše len súbory, takže nepotrebuje žiadne overovanie a žiadne prostredie.

pull a push fungujú iba v pracovnom priestore, ktorý vytvoril používateľ clone alebo init. Synchrónne metaúdaje napísané pri vytvorení pracovného priestoru sú to, čo ich informuje o tom, s ktorým agentom a prostredím sa má rozprávať, takže spustené kdekoľvek inde rýchlo zlyhá a zobrazí sa chyba "pracovný priestor sa nenašiel".

Pozrite tiež

príkazové skupiny rozhrania Microsoft Power Platform CLI
prehľad rozhrania Microsoft Power Platform CLI

Pripomienky

Bola táto stránka užitočná?

Last updated on 2026-07-14

pac copilot

Príkazy

pac copilot clone

Príklad

Povinné parametre pre copilot clone

--bot -id

Voliteľné parametre pre copilot clone

--component-collection -cc

--display-name -dn

--environment -env

--output-dir -od

Poznámky

pac copilot create

Povinné parametre pre copilot create

--displayName

--schemaName

--solution -s

--templateFileName

Voliteľné parametre pre copilot create

--environment -env

pac copilot delete

Povinné parametre pre copilot delete

--bot -id

Voliteľné parametre pre copilot delete

--confirm -y

--environment -env

pac copilot extract-template

Príklad

Povinné parametre pre copilot extract-template

--bot -id

--templateFileName

Voliteľné parametre pre copilot extract-template

--environment -env

--overwrite -o

--templateName

--templateVersion

pac copilot extract-translation

Príklad

Voliteľné parametre pre copilot extract-translation

--all -a

--bot -id

--environment -env

--format

--outdir

--overwrite -o

--sourcedir -src

pac copilot init

Príklady

Povinné parametre pre copilot init

--name -n

--publisher-prefix -pp

Voliteľné parametre pre copilot init

--authoring-mode -am

--environment -env

--instructions -ins

--project-dir -pd

--schema-name -sn

--template -t

Poznámky

pac copilot list

Príklad

Voliteľné parametre pre copilot list

--environment -env

pac copilot mcp

Príklad

Voliteľné parametre pre copilot mcp

--run -r

Poznámky

pac copilot merge-translation

Príklad

Voliteľné parametre pre copilot merge-translation

--environment -env

--file -f

--solution -s

--sourcedir -src

--verbose

--whatif

chyby zlúčenia a prekladu

pac copilot model list

Príklad

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