pac copilot

Rīki un komunālie pakalpojumi kopilota vadībai.

Komandas initclone, , pullpush, un pack ļauj saglabāt Copilot Studio aģentu kā failu kopu diskā, rediģēt to lokāli un sinhronizēt ar Dataverse vidi.

Tipiska cilpa izskatās šādi:

1. Sāciet darbvietu. Izveidojiet pavisam jaunu aģentu ar pac copilot init, vai lejupielādējiet esošu aģentu, izmantojot pac copilot clone. Jebkurā gadījumā jūs iegūstat lokālu darbvietu, kurā ir sinhronizācijas metadati, no kuriem ir atkarīgas citas komandas.
2. Velciet pirms rediģēšanas. pac copilot pull Attālās izmaiņas tiek noņemtas un sapludinātas lokālajos failos, lai sāktu no pašreizējā servera stāvokļa.
3. Spiediet, kad esat pabeidzis. pac copilot push Nosūta atpakaļ vietējās izmaiņas. Ja pa to laiku serverī mainījies tas pats vienums, nospiediet pieturas un lūdz vispirms vilkt.
4. Izvietošanas pakete. pac copilot pack pārvērš darbvietu par risinājumu .zip , kuru var izvietot ar pac solution import.

Lai vienā solī pārietu no nekā, lai kļūtu par reālu aģentu, pac copilot init --environment sastatnes, iesaiņo, importē un savieno darbvietu jūsu vietā. Atsevišķās komandas ļauj vadīt katru cilpas daļu atsevišķi.

Komandas

pac copilot clone

Klonējiet Copilot Studio aģentu vietējā darbvietas direktorijā.

pac copilot clonelejupielādē esošu Copilot Studio aģentu lokālajā darbvietas direktorijā kopā ar sinhronizācijas metadatiem, kas pac copilot pull un pac copilot push paļaujas uz. Aģenta faili tiek ierakstīti apakšmapē, kas nosaukta pēc tā parādāmā nosaukuma.

Piemērs

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

Nepieciešamie parametri copilot clone

--bot -id

Copilot ID vai shēmas nosaukums (unikāls nosaukums, kas atrodams robota detalizētajā informācijā vai faila nosaukums risinājumu pārlūkā).

Neobligātie parametri copilot clone

--component-collection -cc

Komponentu kolekcijas ID, kas jāklonē. Atkārtojiet vairākus.

--display-name -dn

Aģenta parādāmais nosaukums (tiek izmantots mapju nosaukumu piešķiršanai).

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--output-dir -od

Saknes mape klona izvadei. Noklusējums ir pašreizējais direktorijs.

Piezīmes

• --botpieņem Copilot ID vai shēmas nosaukumu. Nododiet Copilot ID (GUID) vai aģenta shēmas nosaukumu. Komanda atrisina shēmas nosaukumu mērķa vidē.
• Mērķa apakšmapei jābūt tukšai. Klons raksta mapē, kas nosaukta pēc aģenta (sanitizētā) parādāmā vārda sadaļā --output-dir. Ja šajā mapē jau ir faili, klonēšana tiek apturēta, nevis pārrakstīta. Izmantojiet --display-name , lai izvēlētos citu mapes nosaukumu.
• Komponentu kolekciju klonēšana. Lai komponentu kolekcijas novietotu līdzās aģentam, nododiet vienu vai vairākus kolekcijas ID ar --component-collection, atdalot ar semikoliem.
• Klonēšanai ir nepieciešams autentificēts profils (pac auth create), un tā atrisina vidi no --environmentaktīvā profila organizācijas vai no aktīvā profila organizācijas, kad to izlaižat.

pac copilot create

Izveido jaunu otro pilotu, izmantojot esošu veidnes failu kā atsauci.

Nepieciešamie parametri copilot create

--displayName

Jaunā otrā pilota parādāmais nosaukums

--schemaName

Jaunā kopilota shēmas nosaukums (unikālais nosaukums).

--solution -s

Risinājuma nosaukums.

--templateFileName

Avota yaml fails, kas satur copilot veidni, kas tika izvilkta, izmantojot komandu extract-template.

Neobligātie parametri copilot create

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac copilot delete

Izdzēsiet pielāgotu Copilot.

Nepieciešamie parametri copilot delete

--bot -id

Copilot ID vai shēmas nosaukums (unikāls nosaukums, kas atrodams robota detalizētajā informācijā vai faila nosaukums risinājumu pārlūkā).

Neobligātie parametri copilot delete

--confirm -y

Nepieciešams, lai apstiprinātu kopilota dzēšanu.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac copilot extract-template

Izvelk veidnes failu no esoša kopilota vidē.

Piemērs

Šī komanda izvelk veidnes failu no esoša kopilota vidē.

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

Komanda atgriež šādu izvadi otrajam pilotam, kas izmanto angļu un vācu valodas:

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

Nepieciešamie parametri copilot extract-template

--bot -id

Copilot ID vai shēmas nosaukums (unikāls nosaukums, kas atrodams robota detalizētajā informācijā vai faila nosaukums risinājumu pārlūkā).

--templateFileName

Yaml faila atrašanās vieta, kurā rakstīt copilot veidni.

Neobligātie parametri copilot extract-template

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--overwrite -o

Atļaut pārrakstīt izvades datu failu, ja tas jau pastāv.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--templateName

Veidnes nosaukums vai 'kickStartTemplate', ja nosaukums nav norādīts.

--templateVersion

Veidnes versija X.X.X formātā vai 1.0.0, ja versija nav norādīta.

pac copilot extract-translation

Izvelk failu, kas satur lokalizētu saturu vienam vai vairākiem robotiem.

Piemērs

Šī komanda izvelk failu, kas satur lokalizētu saturu vienam vai vairākiem otrajiem pilotiem.

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

Komanda atgriež šādu izvadi:

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

Neobligātie parametri copilot extract-translation

--all -a

Rakstiet lokalizācijas failus visām atbalstītajām valodām. Pēc noklusējuma tiek rakstīta tikai primārā valoda.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--bot -id

Copilot ID vai shēmas nosaukums (unikāls nosaukums, kas atrodams robota detalizētajā informācijā vai faila nosaukums risinājumu pārlūkā).

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--format

Faila formāts, kurā rakstīt lokalizētus failus, vai nu 'resx' vai 'json'. Noklusējums ir "resx".

--outdir

Izvades direktorijs, kurā rakstīt.

--overwrite -o

Atļaut pārrakstīt izvades datu failu, ja tas jau pastāv.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--sourcedir -src

Avota risinājumu direktorijs. Ja norādīts, ignorēs saistīto vidi, meklējot robotus, un tā vietā meklēs saturu risinājuma mapē.

pac copilot init

Izveidojiet jaunu Copilot Studio aģenta darbvietu no veidnes.

pac copilot initno veidnes izveido jaunu Copilot Studio aģenta darbvietu. Tas darbojas vienā no diviem režīmiem, un tā klātbūtne --environment izlemj, kuru režīmu izmantot:

• Vietējās sastatnes - nē --environment. Ieraksta veidnes failus projekta direktorijā un apstājas. Komanda neko nerada Dataverse un neprasa pierakstīšanos. Izmantojiet šo režīmu, ja vēlaties rediģēt lokāli un vēlāk izveidot savienojumu ar vidi.
• Bootstrap - --environment piegādāts. Sastatnes failus, iepako tos risinājumā, importē šo risinājumu vidē un savieno darbvietu ar jaunizveidoto aģentu. Šis režīms ir viena soļa ceļš no nekā, uz reālu, sinhronizācijai gatavu aģentu, un tam ir nepieciešams autentificēts profils.

Piemēri

Sastatnes darbvietu lokāli:

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

Sastatnes un bootstrap dzīvu aģentu vidē vienā solī:

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

Ievietojiet CLI autora (CliCopilot) aģentu noteiktā mapē:

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

Nepieciešamie parametri copilot init

--name -n

Aģenta parādāmais vārds.

--publisher-prefix -pp

Publisher pielāgošanas prefikss risinājumam.

Neobligātie parametri copilot init

--authoring-mode -am

Aģents, kas veido formu sastatnēm (noklusējums: 'klasisks'). Izmantojiet "cli-copilot", lai izveidotu CLI autora CliCopilot aģentu.

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--instructions -ins

Aģentu sistēmas instrukcijas.

--project-dir -pd

Aģenta darbvietas mērķa direktorijs. Noklusējums ir pašreizējais direktorijs.

--schema-name -sn

Pilns aģenta shēmas nosaukums. Ignorē noklusējuma atvasinājumu ({publisher-prefix}_{sanitized-name}). Lietots as-is bez izmaiņām.

--template -t

Veidnes profila nosaukums (noklusējums, minimāls). Noklusējums ir "noklusējums".

Piezīmes

• Projekta direktorijai jābūt tukšai. init nenovieto virs esošajiem failiem, tāpēc norādiet --project-dir uz jaunu vai tukšu mapi.
• Shēmas nosaukuma atvasināšana. Izlaižot --schema-name, aģenta shēmas nosaukums tiek veidots kā {publisher-prefix}_{sanitized-name}. Pass --schema-name , lai to skaidri iestatītu; vērtība tiek izmantota as-is.
• Bootstrap darbojas abos autorēšanas režīmos. init --environmentBootstraps Live aģents vienā solī noklusējuma klasiskajam režīmam un .--authoring-mode cli-copilot Kā alternatīvu CliCopilot aģentam, jūs varat sastatnes lokāli (nē --environment), pēc tam palaist pac copilot pack pēc tam pac solution import , lai to izvietotu pats.
• Bootstrap izveido servera puses objektus. Sāknēšanas režīmā init importē risinājumu un izveido aģentu mērķa vidē. Ja aģents ar tādu pašu shēmas nosaukumu jau pastāv, apstājas un norāda, init lai pac copilot clone izveidotu savienojumu ar esošo aģentu.
• Pavisam jauna vide var lēni pieņemt pirmo importēšanu. Svaigi izveidota vide var aizņemt minūti vai divas, lai iesildītos. Agrīna sāknēšana var neizdoties ar "Asinhronās operācijas šai organizācijai pašlaik ir atspējotas". Pagaidiet brīdi un palaidiet to vēlreiz.
• --template (default vai minimal) attiecas tikai uz klasisko autorēšanas režīmu.

pac copilot list

Otro pilotu saraksts pašreizējā vai mērķa Dataverse vidē.

Piemērs

Šī komanda uzskaita visus kopilotus pašreizējā vai mērķa Dataverse vidē.

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

Komanda atgriež šādu izvadi:

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

Neobligātie parametri copilot list

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac copilot mcp

Informācija par lokālo MCP (Model Context Protocol) serveri.

Piemērs

pac copilot mcp --run

Neobligātie parametri copilot mcp

--run -r

Palaidiet lokālo MCP (modeļa konteksta protokola) serveri.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

Piezīmes

Uzziniet, kā izmantot Power Platform CLI ar iebūvētu MCP serveri

pac copilot merge-translation

Sapludiniet failus, kas satur lokalizētu saturu vienam vai vairākiem robotiem.

Piemērs

Šī komanda sapludina failus, kas satur lokalizētu saturu vienam vai vairākiem otrajiem pilotiem.

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

Atjauninot vācu valodu, komanda atgriež šādu izvadi:

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.

Uzziniet, kā pārvaldīt kļūdas, izmantojot sapludināšanas tulkošanas komandu

Neobligātie parametri copilot merge-translation

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--file -f

Tulkojumu saturošo failu saraksts. Tiek atbalstīti glob modeļi.

--solution -s

Risinājuma nosaukums.

--sourcedir -src

Avota risinājumu direktorijs. Ja norādīts, ignorēs saistīto vidi, meklējot robotus, un tā vietā meklēs saturu risinājuma mapē.

--verbose

Izvadiet vairāk diagnostikas informācijas datu importēšanas/eksportēšanas laikā

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

--whatif

Neizpilda komandu, bet izvada informāciju par to, kas notiks.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

Sapludināšanas tulkošanas kļūdas

Pamatojoties uz iepriekš minēto piemēru, ja kopilota atjaunināšanai izmantotajā failā ir viena kļūda, izvade izskatās šādi:

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.

Karodziņš --verbose pievieno detalizētu informāciju par kļūdu:

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 modeļi pašreizējā vidē.

Piemērs

Šajā komandā ir uzskaitīti visi AI Builder modeļi.

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

Komanda atgriež šādu izvadi:

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

Neobligātie parametri copilot model list

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac copilot model predict

Nosūta tekstu vai uzvedni uz AI modeli

Neobligātie parametri copilot model predict

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

--model-id -id

AI Builder modeļa ID

--model-name -n

Pilns vai daļējs AI modeļa nosaukums

--prompt -p

Uzvedne nosūtīt uz AI modeli

--text -t

Teksts, kas jānosūta AI modelim

pac copilot model prepare-fetch

Ņem FetchXML failu no AI lielā valodas modeļa (LLM) un sagatavo to izpildei pašreizējā vidē.

Nepieciešamie parametri copilot model prepare-fetch

--inputFile -i

Ievadiet FetchXML failu, kas parasti nāk no AI LLM.

--outputFile -o

Izvades FetchXML fails, kas ir gatavs izpildei pašreizējā vidē.

Neobligātie parametri copilot model prepare-fetch

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac copilot pack

Iepakojiet Copilot Studio aģenta darbvietu risinājuma zip failā.

pac copilot pack Aģenta darbvietu iepako Dataverse risinājumā .zip , kuru varat izvietot ar pac solution import. Tā ir atsevišķa iepakojuma darbības forma, kas pac copilot init --environment darbojas jūsu vietā, tāpēc izvietojamo risinājumu varat izveidot kā atsevišķu darbību, piemēram, būvēšanas konveijerā. Tas darbojas gan klasiskajās, gan CLI autoru (CliCopilot) aģentu darbvietās.

Piemērs

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

Nepieciešamie parametri copilot pack

--publisher-prefix -pp

Publisher pielāgošanas prefikss risinājumam.

Neobligātie parametri copilot pack

--output-path -op

Risinājuma zip faila izvades ceļš. Noklusējums ir pašreizējais direktorijs.

--project-dir -pd

Aģenta darbvietas direktorijs pakotnei. Noklusējums ir pašreizējais direktorijs.

--solution-name -sn

Risinājuma unikālais nosaukums. Ja tas ir izlaists, atvasināts no aģenta shēmas nosaukuma.

Piezīmes

• Tā ir vietējā operācija. Pack nolasa darbvietu un raksta risinājumu .zip. Tam nav nepieciešama autentifikācija un vide, tāpēc to ir droši palaist būvēšanas konveijerā.
• Izdevēja prefiksam jābūt derīgam. --publisher-prefix Jābūt labi izveidotam pielāgošanas prefiksam vai iesaiņošanai pirms kaut ko rakstīšanas.
• Risinājuma nosaukums un izvade. Ja izlaižat --solution-name, risinājuma unikālais nosaukums tiek atvasināts no aģenta shēmas nosaukuma. Tiek .zip rakstīts pašreizējā direktorijā, ja vien neesat iestatījis --output-path.
• Pakotne netiek izvietota. Tas rada risinājumu, bet to neimportē. Sekojiet tam pac solution import , lai izvietotu aģentu, tad pac copilot clone , ja vēlaties tam sinhronizācijas darbvietu.

pac copilot publish

Pielāgota Copilot publicēšana

Nepieciešamie parametri copilot publish

--bot -id

Copilot ID vai shēmas nosaukums (unikāls nosaukums, kas atrodams robota detalizētajā informācijā vai faila nosaukums risinājumu pārlūkā).

Neobligātie parametri copilot publish

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

pac copilot pull

Izvelciet attālinātās izmaiņas no Copilot Studio un apvienojiet ar vietējo darbvietu.

Komanda pac copilot pull iegūst aģenta pašreizējo servera stāvokli un sapludina to lokālajā darbvietā, izmantojot trīsvirzienu sapludināšanu. Šis process nodrošina, ka gan servera puses rediģēšana, gan neskarti lokālie faili paliek neskarti. Palaidiet to pirms rediģēšanas sākšanas un palaidiet to vēlreiz, pirms veicat izmaiņas.

Piemērs

Palaidiet komandu no darbvietas mapes:

pac copilot pull

Vai norādiet to uz darbvietu citur diskā:

pac copilot pull --project-dir contoso-support

Neobligātie parametri copilot pull

--project-dir -pd

Ceļš uz projekta direktoriju. Noklusējums ir pašreizējais darba direktorijs.

Piezīmes

• Palaidiet to sinhronizācijas darbvietā. Komanda pull darbojas tikai mapē, ko izveidojis pac copilot clone vai pac copilot init. Tas nolasa mērķa vidi un aģentu no darbvietas sinhronizācijas metadatiem, tāpēc nav --environment argumentu. Ja palaižat to citur, tas neizdodas ar kļūdu "darbvieta nav atrasta".
• Tas raksta lokālajos failos. Vilkšana sapludina attālās izmaiņas darbvietā un lejupielādē zināšanu failus. Pirms vilkšanas apņemieties vai dublējiet vietējo darbu, kas jums rūp.
• Vispirms pierakstieties ar pac auth create.

pac copilot push

Pārvietojiet vietējās darbvietas izmaiņas uz Copilot Studio.

pac copilot push nosūta izmaiņas jūsu lokālajā darbvietā atpakaļ aģentam Dataverse. Tas salīdzina jūsu failus ar pēdējo zināmo servera stāvokli, augšupielādē tikai to, kas mainījies, tostarp zināšanu failus, mākoņa plūsmas un savienojuma atsauces, un ziņo par to, ko tas virzīja.

Piemērs

Palaidiet to no darbvietas mapes:

pac copilot push

Vai norādiet to uz darbvietu citur diskā:

pac copilot push --project-dir contoso-support

Neobligātie parametri copilot push

--project-dir -pd

Ceļš uz projekta direktoriju. Noklusējums ir pašreizējais darba direktorijs.

Piezīmes

• Palaidiet to sinhronizācijas darbvietā. Tāpat kā pull, push darbojas tikai mapē, ko izveidojis pac copilot clone vai pac copilot init. Tas nolasa mērķa vidi no darbvietas sinhronizācijas metadatiem. Nav nekādu --environment argumentu.
• Vispirms velciet, ja rodas konflikts. Ja viens un tas pats vienums ir mainījies gan lokāli, gan serverī, nospiediet apturēšanu un lūdz palaist pac copilot pull pirms vēlreiz mēģinājuma. Šis process neļauj klusi pārrakstīt servera puses izmaiņas, kuras neredzējāt.
• Vietējās izmaiņas nav no-op. Ja push neatrod neko, ko sūtīt, tas ziņo par to un iziet, nepieskaroties videi.
• Veiksmīga virzīšana mutē reālo aģentu mērķa vidē.
• Vispirms pierakstieties ar pac auth create.

pac copilot quarantine

Otrā pilota aģenta karantīnas statuss.

Nepieciešamie parametri copilot quarantine

--bot-id -id

Otrā pilota ID karantīnai/karantīnai.

Neobligātie parametri copilot quarantine

--environment -env

Vide (ID, organizācijas ID, URL, unikāls nosaukums vai daļējs nosaukums).

--status -s

Karantīnas statusa vērtība. true = karantīna, false = atcelt karantīnu. Noklusējums ir true.

Šim parametram nav nepieciešama vērtība. Tas ir slēdzis.

pac copilot status

Aptaujājiet norādītā kopilota izvietošanas statusu pašreizējā vai mērķa Dataverse vidē.

Piemērs

Šī komanda aptaujā norādītā otrā pilota izvietošanas statusu pašreizējā vai mērķa Dataverse vidē.

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

Komanda atgriež šādu izvadi:

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

Nepieciešamie parametri copilot status

--bot-id -id

Otrā pilota ID (Chatbot).

Neobligātie parametri copilot status

--environment -env

Norāda mērķa Dataverse. Vērtība var būt GUID vai absolūtais https URL. Ja tas nav norādīts, tiks izmantota aktīvā organizācija, kas atlasīta pašreizējam autentifikācijas profilam.

Sinhronizācijas komandu autentifikācija un vide

clone push pullVisas komandas sazinās ar Dataverse vidi, tāpēc tām ir init --environment nepieciešams autentifikācijas profils. Vispirms pierakstieties ar pac auth create.

• clone, pullun push ir nepieciešams aktīvs profils. pac copilot initVajag tikai vienu, init kad jūs iet garām--environment; bez tā sastatnes failus lokāli un nav nepieciešama pierakstīšanās.
• pull un push nolasiet mērķa vidi no darbvietas sinhronizācijas metadatiem, lai viņi nepieņemtu --environment argumentus. clone un init dara.
• pac copilot pack ir tīri lokāls. Tas lasa un raksta tikai failus, tāpēc tam nav nepieciešama autentifikācija un vide.

pull un push strādāt tikai darbvietā, ko izveidojis clone vai init. Sinhronizācijas metadati, kas rakstīti, kad darbvieta tiek izveidota, norāda, ar kuru aģentu un vidi sarunāties, tāpēc to palaišana jebkur citur ātri neizdodas ar kļūdu "darbvieta nav atrasta".

Skatiet arī

Microsoft Power Platform CLI komandgrupas
Microsoft Power Platform CLI pārskats