Pastaba.
Prieigai prie šio puslapio reikalingas įgaliojimas. Galite bandyti prisijungti arba pakeisti katalogus.
Prieigai prie šio puslapio reikalingas įgaliojimas. Galite bandyti pakeisti katalogus.
Kopijavimo valdymo įrankiai ir kūrimo priemonės.
Komandos init, clone, pull, pushir pack leidžia laikyti Copilot Studio agentą kaip failų rinkinį diske, redaguoti vietoje ir sinchronizuoti su "Dataverse" aplinka.
Tipiškas ciklas atrodo taip:
- Pradėti darbo sritį. Sukurkite visiškai naują agentą naudodami
pac copilot initarba atsisiųskite esamą naudodamipac copilot clone. Bet kuriuo atveju galite gauti vietinę darbo sritį, kurioje yra sinchronizavimo metaduomenys, nuo kurių priklauso kitos komandos. - Patraukite prieš redaguokite.
pac copilot pullleidžia nuotolinius keitimus sumažinti ir sulieti juos į vietinius failus, kad galėtumėte pradėti nuo dabartinės serverio būsenos. - Spauskite, kai baigsite.
pac copilot pushsiunčia jūsų vietinius pakeitimus. Jei tuo tarpu tas pats elementas serveryje buvo pakeistas, spauskite nuspaustą klavišą ir pirmiausia paprašysite jį ištraukti. - Diegimo paketas.
pac copilot packdarbo sritį paverčia sprendimu.zip, kurį galite įdiegti naudodamipac solution import.
Norėdami pereiti iš nieko į tiesioginį agentą vienu veiksmu, pac copilot init --environment pastoliai, paketai, importavimas ir darbo sritis sujungia už jus. Atskiros komandos leidžia atskirai važiuoti kiekvieną ciklo dalį.
Komandos
| Komanda | Aprašas |
|---|---|
| pac copilot clone | Klonuokite Copilot Studio agentą į vietinį darbo srities katalogą. |
| pac copilot create | Sukuria naują kopiją kaip nuorodą naudodamas esamą šablono failą. |
| pac copilot delete | Panaikinkite pasirinktinį Copilot. |
| pac copilot extract-template | Išskleidžia šablono failą iš esamos kopijos aplinkoje. |
| pac copilot extract-translation | Išskleidžia failą, kuriame yra lokalizuotas vieno ar kelių robotų turinys. |
| pac copilot init | Naudodami šabloną sukurkite naują Copilot Studio agento darbo sritį. |
| pac copilot list | Kopijuojamų duomenų sąrašas dabartinėje arba tikslinėje "Dataverse" aplinkoje. |
| pac copilot mcp | Informacija apie vietinį MCP (modelio konteksto protokolo) serverį. |
| pac copilot merge-translation | Sulieti failus, kuriuose yra lokalizuotas vieno ar kelių robotų turinys. |
| pac copilot model list | "AI Builder" modeliai dabartinėje aplinkoje. |
| pac copilot model predict | Siunčia tekstą arba raginimą DI modeliui |
| pac copilot model prepare-fetch | Paima FetchXML failą iš AI didelio kalbos modelio (LLM) ir parengia jį vykdymui pagal dabartinę aplinką. |
| pac copilot pack | Supakuokite Copilot Studio agento darbo sritį į sprendimo zip failą. |
| pac copilot publish | Pasirinktinio kopijavimo publikavimas |
| pac copilot pull | Ištraukite nuotolinius keitimus iš Copilot Studio ir suliekite su vietine darbo sritimi. |
| pac copilot push | Įstumkite vietinės darbo srities pakeitimus į Copilot Studio. |
| pac copilot quarantine | Antrojo piloto agento karantino statusas. |
| pac copilot status | Apklausti nurodytos kopijos diegimo būseną dabartinėje arba tikslinėje "Dataverse" aplinkoje. |
pac copilot clone
Klonuokite Copilot Studio agentą į vietinį darbo srities katalogą.
pac copilot cloneatsisiunčia esamą Copilot Studio agentą į vietinį darbo srities katalogą kartu su sinchronizavimo metaduomenimis, kuriais pac copilot pull pasitikite.pac copilot push Agento failai įrašomi poaplankyje, pavadintame po jo rodomo vardo.
Pavyzdžiui
pac copilot clone `
--bot 11111111-1111-1111-1111-111111111111 `
--environment 22222222-2222-2222-2222-222222222222 `
--output-dir contoso-support
Būtini parametrai copilot clone
--bot
-id
Nukopijuotas ID arba schemos pavadinimas (unikalus pavadinimas, rastas roboto informacijoje arba failo varde sprendimų naršyklėje).
Pasirinktiniai parametrai, skirti copilot clone
--component-collection
-cc
Klonuotinas komponentų rinkinio ID. Kartokite su keliais.
--display-name
-dn
Rodomas agento vardas (naudojamas aplankų pavadinimams pavadinti).
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
--output-dir
-od
Šakninis klonų išvesties aplankas. Pagal numatytuosius nustatymus dabartinis katalogas.
Pastabos
-
--botpriima Copilot ID arba schemos pavadinimą. Perduokite Copilot ID (GUID) arba agento schemos pavadinimą. Komanda išsprendžia schemos pavadinimą tikslinėje aplinkoje. - Paskirties poaplankis turi būti tuščias. Klonas rašo į aplanką, pavadintą po agento (sanitized) rodomo vardo dalyje
--output-dir. Jei tame aplanke jau yra failų, klonas sustoja, o ne perrašo. Naudokite--display-namenorėdami pasirinkti kitą aplanko pavadinimą. - Klonavimo komponentų rinkiniai. Norėdami sumažinti komponentų rinkinius šalia agento, perduokite vieną ar daugiau rinkinio IND,
--component-collectionatskirdami juos kabliataškiais. - Klonas reikalauja autentifikuoto profilio (
pac auth create) ir išsprendžia aplinką iš--environment, arba iš aktyvaus profilio organizacijos, kai jos nenurodote.
pac copilot create
Sukuria naują kopiją kaip nuorodą naudodamas esamą šablono failą.
Būtini parametrai copilot create
--displayName
Rodomas naujos kopijos pavadinimas
--schemaName
Naujos kopijos schemos pavadinimas (unikalus pavadinimas).
--solution
-s
Sprendimo pavadinimas.
--templateFileName
Šaltinio yaml failas, kuriame yra antrojo piloto šablonas, išskleistas naudojant komandą extract-template.
Pasirinktiniai parametrai, skirti copilot create
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
pac copilot delete
Panaikinkite pasirinktinį Copilot.
Būtini parametrai copilot delete
--bot
-id
Nukopijuotas ID arba schemos pavadinimas (unikalus pavadinimas, rastas roboto informacijoje arba failo varde sprendimų naršyklėje).
Pasirinktiniai parametrai, skirti copilot delete
--confirm
-y
Būtina patvirtinti kopijos naikinimą.
Šiam parametrui nereikia reikšmės. Tai jungiklis.
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
pac copilot extract-template
Išskleidžia šablono failą iš esamos kopijos aplinkoje.
Pavyzdžiui
Ši komanda išskleidžia šablono failą iš esamo nukopijuoto failo aplinkoje.
pac copilot extract-template `
--environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
--bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
--templateFileName NewTestCopilot.yaml
Komanda pateikia nukopijuotos kopijos išvestį, kaip nurodyta toliau, naudojant anglų ir vokiečių kalbas:
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
Būtini parametrai copilot extract-template
--bot
-id
Nukopijuotas ID arba schemos pavadinimas (unikalus pavadinimas, rastas roboto informacijoje arba failo varde sprendimų naršyklėje).
--templateFileName
Yaml failo vieta, į kurią bus rašomas nukopijuotas šablonas.
Pasirinktiniai parametrai, skirti copilot extract-template
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
--overwrite
-o
Leisti išvesties duomenų failą perrašyti, jei jis jau yra.
Šiam parametrui nereikia reikšmės. Tai jungiklis.
--templateName
Nenurodytas šablono pavadinimas arba kickStartTemplate.
--templateVersion
Šablono versija X.X.X formatu arba 1.0.0, jei nenurodyta versija.
pac copilot extract-translation
Išskleidžia failą, kuriame yra lokalizuotas vieno ar kelių robotų turinys.
Pavyzdžiui
Ši komanda išskleidžia failą, kuriame yra lokalizuotas vieno ar kelių nukopijuotų duomenų turinys.
pac copilot extract-translation `
--environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
--bot 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e `
--all `
--outdir . `
--format json
Komanda pateikia išvestį, pvz.:
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
Pasirinktiniai parametrai, skirti copilot extract-translation
--all
-a
Rašykite lokalizacijos failus visomis palaikomomis kalbomis. Pagal numatytuosius parametrus rašoma tik pagrindinė kalba.
Šiam parametrui nereikia reikšmės. Tai jungiklis.
--bot
-id
Nukopijuotas ID arba schemos pavadinimas (unikalus pavadinimas, rastas roboto informacijoje arba failo varde sprendimų naršyklėje).
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
--format
Failo formatas, kuriuo galima rašyti lokalizuotus failus, "resx" arba "json". Numatytoji reikšmė yra "resx".
--outdir
Išvesties katalogas, į kurį reikia rašyti.
--overwrite
-o
Leisti išvesties duomenų failą perrašyti, jei jis jau yra.
Šiam parametrui nereikia reikšmės. Tai jungiklis.
--sourcedir
-src
Šaltinio sprendimų katalogas. Kai nurodyta, ieškos prijungtos aplinkos ieškodami robotų ir vietoj to ieškos turinio sprendimo aplanke.
pac copilot init
Naudodami šabloną sukurkite naują Copilot Studio agento darbo sritį.
pac copilot initscaffolds a new Copilot Studio agent workspace from a template. Jis veikia vienu iš dviejų režimų ir --environment nusprendžia, kurį režimą naudoti:
-
Vietinis pastoliai – ne
--environment. Šablono failus įrašo į projekto katalogą ir sustabdo. Komanda "Dataverse" nieko nesukuria ir nereikia prisijungti. Naudokite šį režimą, kai norite kurti vietoje ir vėliau prisijungti prie aplinkos. -
"Bootstrap " –
--environmentpateikta. Pastoliai sukuria failus, supakuoja juos į sprendimą, importuoja tą sprendimą į aplinką ir sujungia darbo sritį su naujai sukurtu agentu. Šis režimas yra vieno veiksmo kelias iš nieko į tiesioginį, sinchronizuojamą agentą ir jam reikia autentifikuoto profilio.
Pavyzdžiai
Kurti darbo sritį vietoje:
pac copilot init `
--name "Contoso Support Agent" `
--publisher-prefix contoso
Pastoliai ir "bootstrap" tiesioginis agentas aplinkoje atliekant vieną veiksmą:
pac copilot init `
--name "Contoso Support Agent" `
--publisher-prefix contoso `
--environment 22222222-2222-2222-2222-222222222222
Pastoliai CLI sukurtas (CliCopilot) agentas į konkretų aplanką:
pac copilot init `
--name "Contoso Support Agent" `
--publisher-prefix contoso `
--authoring-mode cli-copilot `
--project-dir contoso-support
Būtini parametrai copilot init
--name
-n
Agento rodomas vardas.
--publisher-prefix
-pp
Publisher sprendimo tinkinimo prefiksą.
Pasirinktiniai parametrai, skirti copilot init
--authoring-mode
-am
Agentas, kuriantis figūrą pastoliais (numatytasis parametras: "klasikinis"). Naudokite "cli-copilot" kurdami CLI pagrįstą CliCopilot agentą.
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
--instructions
-ins
Agento sistemos instrukcijos.
--project-dir
-pd
Agento darbo srities paskirties katalogas. Pagal numatytuosius nustatymus dabartinis katalogas.
--schema-name
-sn
Visas agento schemos pavadinimas. Perrašo numatytąjį išvedimą ({publisher-prefix}_{sanitized-name}). Naudojama as-is be pakeitimų.
--template
-t
Šablono profilio pavadinimas (numatytasis, minimalus). Numatytoji reikšmė yra "numatytoji".
Pastabos
- Projekto katalogas turi būti tuščias.
initnekuria pastolių ant esamų failų, todėl nukreipkite žymiklį--project-dirį naują arba tuščią aplanką. - Schemos pavadinimo nustatymas. Kai praleidžiate
--schema-name, agento schemos pavadinimas yra sukurtas kaip{publisher-prefix}_{sanitized-name}. Perduokite--schema-name, kad aiškiai nustatytumėte; reikšmė naudojama as-is. - "Bootstrap" veikia abiem kūrimo režimais.
init --environment"bootstraps" tiesioginis agentas vienu veiksmu numatytuoju klasikiniu režimu ir--authoring-mode cli-copilot"". Kaip alternatyva CliCopilot agentas, galite pastoliai vietoje (ne--environment), tada paleistipac copilot packpopac solution importto įdiegti jį patys. - "Bootstrap" sukuria serverio objektus. "bootstrap" režimu
initimportuoja sprendimą ir sukuria agentą paskirties aplinkoje. Jei agentas tokiu pačiu schemos pavadinimu jau yra,initsustabdo ir nurodo prisijungti priepac copilot cloneesamo agento. - Visiškai nauja aplinka gali lėtai priimti pirmąjį importavimą. Naujai sukurta aplinka gali užtrukti minutę ar dvi. Ankstyva "bootstrap" gali nepavykti dėl "Async" operacijų šiuo metu išjungtos šioje organizacijoje". Šiek tiek palaukite ir paleiskite dar kartą.
-
--template(defaultarbaminimal) taikoma tik klasikinio kūrimo režimui.
pac copilot list
Kopijuojamų duomenų sąrašas dabartinėje arba tikslinėje "Dataverse" aplinkoje.
Pavyzdžiui
Šioje komandoje išvardijami visi kopijos dabartinėje arba tikslinėje "Dataverse" aplinkoje.
pac copilot list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118
Komanda pateikia išvestį, pvz.:
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
Pasirinktiniai parametrai, skirti copilot list
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
pac copilot mcp
Informacija apie vietinį MCP (modelio konteksto protokolo) serverį.
Pavyzdžiui
pac copilot mcp --run
Pasirinktiniai parametrai, skirti copilot mcp
--run
-r
Paleiskite vietinį MCP (modelio konteksto protokolo) serverį.
Šiam parametrui nereikia reikšmės. Tai jungiklis.
Pastabos
Sužinokite, kaip naudoti "Power Platform" CLI su įtaisytuoju MCP serveriu
pac copilot merge-translation
Sulieti failus, kuriuose yra lokalizuotas vieno ar kelių robotų turinys.
Pavyzdžiui
Ši komanda sulieja failus, kuriuose yra lokalizuotas vieno ar kelių kopijuotų duomenų turinys.
pac copilot merge-translation `
--environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
--file ms_store_newTestCopilot.de-DE.json `
--solution SolutionName
Naujinant vokiečių kalbą, komanda pateikia išvestį, kaip nurodyta toliau:
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.
Sužinokite, kaip tvarkyti klaidas naudojant suliejimo vertimo komandą
Pasirinktiniai parametrai, skirti copilot merge-translation
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
--file
-f
Failų, kuriuose yra vertimų, sąrašas. Gaublio raštai yra palaikomi.
--solution
-s
Sprendimo pavadinimas.
--sourcedir
-src
Šaltinio sprendimų katalogas. Kai nurodyta, ieškos prijungtos aplinkos ieškodami robotų ir vietoj to ieškos turinio sprendimo aplanke.
--verbose
Daugiau diagnostikos informacijos išvestis importuojant / eksportuojant duomenis
Šiam parametrui nereikia reikšmės. Tai jungiklis.
--whatif
Nevykdo komandos, bet pateikia išsamią informaciją apie tai, kas nutiktų.
Šiam parametrui nereikia reikšmės. Tai jungiklis.
suliejimo vertimo klaidos
Remiantis anksčiau pateiktame pavyzdyje, jei faile, kuris buvo naudojamas naujinant kopijos kopiją, yra viena klaida, išvestis atrodo taip:
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.
Vėliavėlė --verbose įtraukia išsamią informaciją apie klaidą:
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" modeliai dabartinėje aplinkoje.
Pavyzdžiui
Šioje komandoje išvardyti visi DI daryklės modeliai.
pac copilot model list --environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118
Komanda pateikia išvestį, pvz.:
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
Pasirinktiniai parametrai, skirti copilot model list
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
pac copilot model predict
Siunčia tekstą arba raginimą DI modeliui
Pasirinktiniai parametrai, skirti copilot model predict
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
--model-id
-id
AI daryklės modelio ID
--model-name
-n
Visas arba dalinis DI modelio pavadinimas
--prompt
-p
Raginimas siųsti DI modeliui
--text
-t
Tekstas, siunčiamas DI modeliui
pac copilot model prepare-fetch
Paima FetchXML failą iš AI didelio kalbos modelio (LLM) ir parengia jį vykdymui pagal dabartinę aplinką.
Būtini parametrai copilot model prepare-fetch
--inputFile
-i
Įvesties "FetchXML" failas, kuris paprastai gaunamas iš AI LLM.
--outputFile
-o
Išvesties "FetchXML" failas, paruoštas vykdyti dabartinėje aplinkoje.
Pasirinktiniai parametrai, skirti copilot model prepare-fetch
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
pac copilot pack
Supakuokite Copilot Studio agento darbo sritį į sprendimo zip failą.
pac copilot pack supakuos agento darbo sritį į "Dataverse" sprendimą .zip , kurį galite įdiegti naudodami pac solution import"". Tai yra atskira pakuotės veiksmo forma, kuri pac copilot init --environment tinka jums, todėl diegtiną sprendimą galite sukurti kaip atskirą veiksmą, pvz., komponavimo versijų sraute. Jis veikia tiek klasikinėms, tiek CLI (CliCopilot) agento darbo sritims.
Pavyzdžiui
pac copilot pack `
--publisher-prefix contoso `
--project-dir contoso-support `
--output-path out
Būtini parametrai copilot pack
--publisher-prefix
-pp
Publisher sprendimo tinkinimo prefiksą.
Pasirinktiniai parametrai, skirti copilot pack
--output-path
-op
Sprendimo zip failo išvesties kelias. Pagal numatytuosius nustatymus dabartinis katalogas.
--project-dir
-pd
Agento darbo srities katalogas paketui. Pagal numatytuosius nustatymus dabartinis katalogas.
--solution-name
-sn
Unikalus sprendimo pavadinimas. Jei nenurodyta, išvesta iš agento schemos pavadinimo.
Pastabos
- Tai vietinė operacija. Paketas perskaito darbo sritį ir rašo sprendimą
.zip. Jai nereikia autentifikavimo ir aplinkos, todėl saugu ją naudoti komponavimo versijos sraute. - Leidėjo prefiksas turi būti galiojantis.
--publisher-prefixturi būti gerai suformuotas tinkinimo prefiksas arba paketas sustoja prieš ką nors rašant. - Sprendimo pavadinimas ir išvestis. Jei praleiskite
--solution-name, unikalus sprendimo pavadinimas gaunamas iš agento schemos pavadinimo. The.zipis written to the current directory unless you set--output-path. - Paketas neįdiegtas. Jis sukuria sprendimą, bet jo neimportuoja. Vykdykite ją ir
pac solution importįdiekite agentą, tadapac copilot clone, jei norite, kad būtų sinchronizuota darbo sritis.
pac copilot publish
Pasirinktinio kopijavimo publikavimas
Būtini parametrai copilot publish
--bot
-id
Nukopijuotas ID arba schemos pavadinimas (unikalus pavadinimas, rastas roboto informacijoje arba failo varde sprendimų naršyklėje).
Pasirinktiniai parametrai, skirti copilot publish
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
pac copilot pull
Ištraukite nuotolinius keitimus iš Copilot Studio ir suliekite su vietine darbo sritimi.
Komanda pac copilot pull iškviečiama dabartinė agento serverio būsena ir sulieja ją į vietinę darbo sritį naudojant trikryptį suliejimą. Šis procesas užtikrina, kad serverio redagavimai ir nepaliesti vietiniai failai liks nepaliesti. Paleiskite ją prieš pradėdami redaguoti ir paleiskite dar kartą prieš spausdami pakeitimus.
Pavyzdžiui
Vykdykite komandą iš darbo srities aplanko:
pac copilot pull
Arba nukreipkite jį į darbo sritį kitoje disko vietoje:
pac copilot pull --project-dir contoso-support
Pasirinktiniai parametrai, skirti copilot pull
--project-dir
-pd
Kelias į projekto katalogą. Numatytoji dabartinio darbinio katalogo reikšmė.
Pastabos
- Paleiskite ją sinchronizavimo darbo srityje. Komanda
pullveikia tik aplanke, kurįpac copilot clonesukūrė arbapac copilot init. Ji perskaito paskirties aplinką ir agentą iš darbo srities sinchronizavimo metaduomenų, todėl argumentų nėra--environment. Jei ją paleisite kur nors kitur, nepavyks dėl klaidos "darbo sritis nerasta". - Jis rašo į jūsų vietinius failus. Patraukus suliejami nuotoliniai pakeitimai darbo srityje ir atsisiunčiami žinių failai. Prieš traukdami užtikrinkite arba kurkite atsargines vietinių darbų kopijas.
- Pirmiausia prisijunkite naudodami
pac auth create.
pac copilot push
Įstumkite vietinės darbo srities pakeitimus į Copilot Studio.
pac copilot push siunčia keitimus vietinėje darbo srityje atgal "Dataverse" agentui. Ji palygina jūsų failus su paskutine žinoma serverio būsena, nusiunčia tik tai, kas pasikeitė, įskaitant žinių failus, debesies srautus ir ryšio nuorodas, ir praneša, kas buvo perkelta.
Pavyzdžiui
Paleiskite jį iš darbo srities aplanko:
pac copilot push
Arba nukreipkite jį į darbo sritį kitoje disko vietoje:
pac copilot push --project-dir contoso-support
Pasirinktiniai parametrai, skirti copilot push
--project-dir
-pd
Kelias į projekto katalogą. Numatytoji dabartinio darbinio katalogo reikšmė.
Pastabos
- Paleiskite ją sinchronizavimo darbo srityje. Patinka
pull,pushveikia tik aplanke, kurįpac copilot clonesukūrė arbapac copilot init. Ji nuskaito tikslinę aplinką iš darbo srities sinchronizavimo metaduomenų. Argumento nėra--environment. - Pirmiausia patraukite, jei yra konfliktas. Jei tas pats elementas pasikeitė ir vietoje, ir serveryje, prieš bandydami dar kartą, paspauskite stabdo ir prašo paleisti
pac copilot pull. Šis procesas neleidžia tyliai perrašyti nematyto serverio keitimo. - Vietinių pakeitimų nėra no-op. Jei "push" nieko neranda siųsti, ji praneša apie tai ir išeina neliečiant aplinkos.
- Sėkmingas paspaudimas nutildys tiesioginį agentą tikslinėje aplinkoje.
- Pirmiausia prisijunkite naudodami
pac auth create.
pac copilot quarantine
Antrojo piloto agento karantino statusas.
Būtini parametrai copilot quarantine
--bot-id
-id
Antrojo piloto, į kurį reikia karantinuotis/atšaukti karantiną, ID.
Pasirinktiniai parametrai, skirti copilot quarantine
--environment
-env
Aplinka (ID, organizacijos ID, URL, unikalus pavadinimas arba dalinis pavadinimas).
--status
-s
Sulaikymo būsenos reikšmė. true = karantinas, false = atšaukti karantiną. Numatytoji reikšmė yra teisinga.
Šiam parametrui nereikia reikšmės. Tai jungiklis.
pac copilot status
Apklausti nurodytos kopijos diegimo būseną dabartinėje arba tikslinėje "Dataverse" aplinkoje.
Pavyzdžiui
Ši komanda apklausė nurodyto nukopijuoto turinio diegimo būseną dabartinėje arba tikslinėje "Dataverse" aplinkoje.
pac copilot status `
--environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
--bot-id 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e
Komanda pateikia išvestį, pvz.:
Connected as user@contoso.org
Connected to... Contoso Organization
Virtual Agent New Bot German with ID 9ee3f7aa-ab79-4cf6-a726-d85c8c18cc3e has been provisioned.
Būtini parametrai copilot status
--bot-id
-id
Nukopijuoto egzemplioriaus ID ("Chatbot").
Pasirinktiniai parametrai, skirti copilot status
--environment
-env
Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.
Sinchronizavimo komandų autentifikavimas ir aplinka
Komandos clone, pull, pushir init --environment visos komandos kalbasi su "Dataverse" aplinka, todėl joms reikia autentifikavimo profilio. Pirmiausia prisijunkite naudodami pac auth create.
-
clone,pullirpushreikia aktyvaus profilio.pac copilot initreikia tik vieną, kai pereisite--environment; be jo,initpastolius failus vietoje ir nereikia prisijungti. -
pullirpushskaitykite tikslinę aplinką iš darbo srities sinchronizavimo metaduomenų, kad jie neimtų argumento--environment.cloneirinitdarykite. -
pac copilot packyra tik vietinė. Jis skaito ir rašo tik failus, todėl jam nereikia autentifikavimo ir aplinkos.
pull ir push dirbti tik darbo srityje, kurią clone sukūrė arba init. Sukūrus darbo sritį parašyti sinchronizavimo metaduomenys nurodo, su kuriuo agentu ir aplinka kalbėtis, todėl paleisti juos bet kur kitur nepavyksta greitai ir pateikiama klaida "darbo sritis nerasta".
Taip pat žr.
Microsoft Power Platform CLI komandų grupės
Microsoft Power Platform CLI apžvalga