Zdieľať cez

pac copilot

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

Príkazy

Príkaz Popis
pac copilot create Vytvorí novú kopilot s použitím existujúceho súboru šablóny ako odkazu.
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 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 publish Publikovanie vlastného kopilotu
pac copilot status Prehľad stavu nasadenia určeného kopilotu v aktuálnom alebo cieľovom prostredí Dataverse.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

pac copilot model predict

Odoslanie textu alebo výzvy modelu AI

Voliteľné parametre pre copilot model predict

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

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

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.

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

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.

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

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.

Pozri tiež

Microsoft Power Platform CLI Command Groups
Prehľad rozhrania Microsoft Power Platform CLI

  • Last updated on