pac copilot

Copiloti haldamise tööriistad ja utiliidid.

initKäskude , clone, pull, pushja pack abil saate hoida Copilot Studio agenti kettal olevate failide komplektina, redigeerida seda kohalikult ja sünkroonida seda Dataverse'i keskkonnaga.

Tavaline tsükkel näeb välja selline:

  1. Tööruumi käivitamine. Saate uue agendi scaffoldida või laadida alla olemasoleva agendi pac copilot initoperatsioonisüsteemiga pac copilot clone. Mõlemal juhul saate kohaliku tööruumi, mis kannab sünkroonimis metaandmeid, millest teised käsud sõltuvad.
  2. Enne redigeerimist tõmmake. pac copilot pull toob kaugmuudatused alla ja ühendab need teie kohalikesse failidesse, nii et alustate praegusest serveriolekust.
  3. Lükake, kui olete lõpetanud. pac copilot push saadab teie kohalikud muudatused tagasi. Kui serveris on vahepeal sama üksust muudetud, lükatakse peatused ja palutakse teil esmalt tõmmata.
  4. Juurutamise pakett. pac copilot pack muudab tööruumi lahenduseks .zip , mida saate i abil pac solution importjuurutada.

Kui te ei soovi ühes etapis midagi reaalajas agendile saata, pac copilot init --environment ühendatakse tellingud, paketid, imporditakse ja ühendatakse tööruum teie eest. Üksikute käskude abil saate ise iga tsükliosa juhtida.

Käsud

Käsk Kirjeldus
pac copilot clone Kloonige Copilot Studio agent kohalikku tööruumikataloogi.
pac copilot create Loob uue kaasautori, kasutades viitena olemasolevat mallifaili.
pac copilot delete Kohandatud Copilot kustutamine.
pac copilot extract-template Ekstraktib mallifaili keskkonna olemasolevast kaaspilotist.
pac copilot extract-translation Ekstraktib faili, mis sisaldab ühe või mitme roboti lokaliseeritud sisu.
pac copilot init Saate malli põhjal luua uue Copilot Studio agendi tööruumi.
pac copilot list Praeguses või siht-Dataverse'i keskkonnas olevate kolpiltide loend.
pac copilot mcp Teave kohaliku MCP-serveri (Model Context Protocol) kohta.
pac copilot merge-translation Saate ühendada faile, mis sisaldavad ühe või mitme roboti lokaliseeritud sisu.
pac copilot model list AI Builderi mudelid praeguses keskkonnas.
pac copilot model predict Saadab teksti või viiba AI mudelile
pac copilot model prepare-fetch Võtab AI suure keelemudeli (LLM) faili FetchXML ja valmistab selle ette praeguse keskkonnaga täitmiseks.
pac copilot pack Pakkige Copilot Studio agendi tööruum lahenduse ZIP-faili.
pac copilot publish Kohandatud kopiloti avaldamine
pac copilot pull Tõmmake Copilot Studio kaugmuudatused ja ühendage need kohaliku tööruumiga.
pac copilot push Saate kohaliku tööruumi muudatused Copilot Studio.
pac copilot quarantine Kaaspiloodi agendi karantiinistaatus.
pac copilot status Küsitlus määratud copilot-i juurutuse oleku üle praeguses või sihtandmekeskkonnas.

pac copilot clone

Kloonige Copilot Studio agent kohalikku tööruumikataloogi.

pac copilot clonelaadib olemasoleva Copilot Studio agendi alla kohalikku tööruumikataloogi koos sünkroonimis metaandmetega, millele pac copilot pullpac copilot push toetute. Agendi failid kirjutatakse alamkausta, mille nimeks on kuvatav nimi.

Näide

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

Nõutavad parameetrid: copilot clone

--bot -id

Copiloti ID või skeemi nimi (kordumatu nimi boti üksikasjades või failinimi lahenduse exploreris).

Valikulised parameetrid: copilot clone

--component-collection -cc

Kloonitava komponendikogumi ID. Korrake seda mitu korda.

--display-name -dn

Agendi kuvatav nimi (kasutatakse kaustanimede jaoks).

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--output-dir -od

Klooniväljundi juurkaust. Vaikimisi on valitud praegune kaust.

Märkused

  • --botaktsepteerib Copilot ID või skeemi nime. Edastage Copilot ID (GUID) või agendi skeemi nimi. Käsk lahendab skeemi nime sihtkeskkonna suhtes.
  • Siht-alamkaust peab olema tühi. Kloon kirjutab kausta, mis on nimega agendi (desinfitseeritud) kuvatava nime all --output-dir. Kui see kaust juba sisaldab faile, lõpetab kloon nende ülekirjutamise asemel. Kasutage --display-name seda mõne muu kaustanime valimiseks.
  • Komponendikogumite kloonimine. Komponendikogumite agendi kõrvale toomiseks edastage üks või mitu kogumi ID-d semikoolonitega --component-collectioneraldatuna.
  • Kloon nõuab autenditud profiili (pac auth create) ja lahendab keskkonna aktiivse profiili organisatsioonist --environmentvõi selle ärajätmisel.

pac copilot create

Loob uue kaasautori, kasutades viitena olemasolevat mallifaili.

Nõutavad parameetrid: copilot create

--displayName

Uue kaaspiloti kuvatav nimi

--schemaName

Uue copiloti skeeminimi (kordumatu nimi).

--solution -s

Lahenduse nimi.

--templateFileName

Source yaml file containing the copilot template that was extract-template command.

Valikulised parameetrid: copilot create

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac copilot delete

Kohandatud Copilot kustutamine.

Nõutavad parameetrid: copilot delete

--bot -id

Copiloti ID või skeemi nimi (kordumatu nimi boti üksikasjades või failinimi lahenduse exploreris).

Valikulised parameetrid: copilot delete

--confirm -y

Nõutav, et kinnitada kopiloti kustutamine.

See parameeter ei vaja väärtust. See on lüliti.

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac copilot extract-template

Ekstraktib mallifaili keskkonna olemasolevast kaaspilotist.

Näide

See käsk ekstraktib mallifaili mõnes keskkonnas olemasolevast kaaspilotist.

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

Käsk tagastab copilot-väljundi, mis kasutab inglise ja saksa keelt.

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

Nõutavad parameetrid: copilot extract-template

--bot -id

Copiloti ID või skeemi nimi (kordumatu nimi boti üksikasjades või failinimi lahenduse exploreris).

--templateFileName

Yaml-faili asukoht, kuhu copilot-mall kirjutada.

Valikulised parameetrid: copilot extract-template

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--overwrite -o

Saate lubada väljundandmefaili ülekirjutamise, kui see on juba olemas.

See parameeter ei vaja väärtust. See on lüliti.

--templateName

Malli nimi või "kickStartTemplate", kui nime pole määratud.

--templateVersion

Malli versioon X.X.X-vormingus või 1.0.0, kui versiooni pole määratud.

pac copilot extract-translation

Ekstraktib faili, mis sisaldab ühe või mitme roboti lokaliseeritud sisu.

Näide

See käsk ekstraktib faili, mis sisaldab ühe või mitme kolpiloti lokaliseeritud sisu.

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

Käsk tagastab väljundi järgmiselt.

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

Valikulised parameetrid: copilot extract-translation

--all -a

Saate kirjutada lokaliseerimisfaile kõigi toetatud keelte jaoks. Vaikimisi kirjutatakse ainult esmane keel.

See parameeter ei vaja väärtust. See on lüliti.

--bot -id

Copiloti ID või skeemi nimi (kordumatu nimi boti üksikasjades või failinimi lahenduse exploreris).

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--format

Lokaliseeritud failide (resx või json) kirjutamise failivorming. Vaikeväärtus on "resx".

--outdir

Väljundkaust, millesse kirjutada.

--overwrite -o

Saate lubada väljundandmefaili ülekirjutamise, kui see on juba olemas.

See parameeter ei vaja väärtust. See on lüliti.

--sourcedir -src

Lähtelahenduste kataloog. Kui see on määratud, ignoreerib bottide otsimisel ühendatud keskkonda ja otsib selle asemel lahendusekaustast sisu.

pac copilot init

Saate malli põhjal luua uue Copilot Studio agendi tööruumi.

pac copilot initavab mallist uue Copilot Studio agendi tööruumi. See töötab ühes kahest režiimist --environment ja selle olemasolu otsustab, millist režiimi kasutada:

  • Kohalik telling – ei --environment. Kirjutab mallifailid projektikataloogi ja peatub. Käsk ei loo Dataverse'is midagi ega nõua sisselogimist. Kasutage seda režiimi, kui soovite luua kohalikult sisu ja luua hiljem ühenduse mõne keskkonnaga.
  • Bootstrap--environment tarnitud. Scaffolds the files, packages them into a solution, import that solution into the environment, and connects the workspace to the newly created agent. See režiim on üheetapiline tee mitte millegilt otseedastuseks, sünkroonimiseks valmis agendini ja see nõuab autenditud profiili.

Näited

Tööruumi kohalikult tellingumiseks tehke järgmist.

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

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

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

Scaffold a CLI-authored (CliCopilot) agent konkreetsesse kausta:

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

Nõutavad parameetrid: copilot init

--name -n

Agendi kuvatav nimi.

--publisher-prefix -pp

Publisher lahenduse kohandamise eesliidet.

Valikulised parameetrid: copilot init

--authoring-mode -am

The agent authoring shape to scaffold (vaikesäte: 'klassikaline'). Kasutage CLI-autoriga CliCopiloti agendi tellinguks 'cli-copilot'.

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--instructions -ins

Agendisüsteemi juhised.

--project-dir -pd

Agendi tööruumi sihtkataloog. Vaikimisi on valitud praegune kaust.

--schema-name -sn

Agendi skeemi täielik nimi. Alistab vaikeväljundi ({publisher-prefix}_{sanitized-name}). Kasutatakse as-is ilma muudatusteta.

--template -t

Malli profiili nimi (vaikeväärtus, minimaalne). Vaikeväärtus on "vaikeväärtus".

Märkused

  • Projektikataloog peab olema tühi. init ei libista olemasolevate failide kohale, seega osutage --project-dir uuele või tühjale kaustale.
  • Skeeminime tuletamine. Kui te seda ei lisa --schema-name, on agendi skeemi nimi koostatud kui {publisher-prefix}_{sanitized-name}. Edastage --schema-name see selgesõnaliselt; väärtust kasutatakse as-is.
  • Bootstrap töötab mõlemas loomerežiimis. init --environment bootstraps live agent in one step for the default classic mode and for --authoring-mode cli-copilot. CliCopiloti agendi alternatiivina saate tellingu luua kohalikult (ei --environment), seejärel käivitada pac copilot packpac solution import selle ise juurutamiseks.
  • Bootstrap loob serveripoolseid objekte. Algkäivituse režiimis init impordib lahenduse ja loob agendi sihtkeskkonnas. Kui sama skeeminimega agent on juba olemas, init peatab ja suunab teid pac copilot clone looma ühenduse olemasoleva agendiga.
  • Täiesti uus keskkond võib esimese impordi aktsepteerimist aeglustada. Värskelt loodud keskkonna soojenemiseks võib kuluda mõni minut. Varajane algkäivituse käivitamine võib nurjuda, kui kuvatakse teade "Asünkroonsed toimingud on selle organisatsiooni jaoks praegu keelatud". Oodake veidi ja käivitage see uuesti.
  • --template (default või minimal) kehtib ainult klassikalise loomerežiimi kohta.

pac copilot list

Praeguses või siht-Dataverse'i keskkonnas olevate kolpiltide loend.

Näide

Selle käsuga loetletakse kõik praeguses või sihtandmekeskkonnas leiduvad kopiloodid.

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

Käsk tagastab väljundi järgmiselt.

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

Valikulised parameetrid: copilot list

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac copilot mcp

Teave kohaliku MCP-serveri (Model Context Protocol) kohta.

Näide

pac copilot mcp --run

Valikulised parameetrid: copilot mcp

--run -r

Käivitage kohalik MCP-server (Model Context Protocol).

See parameeter ei vaja väärtust. See on lüliti.

Märkused

Siit saate teada, kuidas kasutada Power Platform CLI-t sisseehitatud MCP-serveriga

pac copilot merge-translation

Saate ühendada faile, mis sisaldavad ühe või mitme roboti lokaliseeritud sisu.

Näide

See käsk ühendab failid, mis sisaldavad ühe või mitme kopiloti lokaliseeritud sisu.

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

Käsk tagastab saksa keele värskendamisel väljundi järgmiselt:

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.

Teave ühendamistõlke käsu tõrgete haldamise kohta

Valikulised parameetrid: copilot merge-translation

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--file -f

Tõlkeid sisaldavate failide loend. Gloob-mustrid on toetatud.

--solution -s

Lahenduse nimi.

--sourcedir -src

Lähtelahenduste kataloog. Kui see on määratud, ignoreerib bottide otsimisel ühendatud keskkonda ja otsib selle asemel lahendusekaustast sisu.

--verbose

Saada andmete importimisel/eksportimisel rohkem diagnostikateavet

See parameeter ei vaja väärtust. See on lüliti.

--whatif

Ei käivita käsku, kuid väljastab juhtuva üksikasjad.

See parameeter ei vaja väärtust. See on lüliti.

merge-translation errors

Ülaltoodud näite põhjal näeb väljund välja järgmine, kui kopileti värskendamiseks kasutatavas failis on üks tõrge.

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.

Lipp --verbose lisab tõrke üksikasjad.

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 Builderi mudelid praeguses keskkonnas.

Näide

Selles käsus on loetletud kõik tehisintellektikoosturi mudelid.

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

Käsk tagastab väljundi järgmiselt.

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

Valikulised parameetrid: copilot model list

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac copilot model predict

Saadab teksti või viiba AI mudelile

Valikulised parameetrid: copilot model predict

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

--model-id -id

AI Builderi mudeli ID

--model-name -n

AI mudeli täielik või osaline nimi

--prompt -p

Küsi teibaidi mudelisse saatmise kohta

--text -t

AI mudelisse saadetav tekst

pac copilot model prepare-fetch

Võtab AI suure keelemudeli (LLM) faili FetchXML ja valmistab selle ette praeguse keskkonnaga täitmiseks.

Nõutavad parameetrid: copilot model prepare-fetch

--inputFile -i

Input FetchXML-fail, mis tavaliselt pärineb tehisintellekti LLM-ist.

--outputFile -o

Output FetchXML-fail, mis on valmis praeguses keskkonnas käivitama.

Valikulised parameetrid: copilot model prepare-fetch

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac copilot pack

Pakkige Copilot Studio agendi tööruum lahenduse ZIP-faili.

pac copilot pack koondab agendi tööruumi Dataverse'i lahendusse .zip , mida saate juurutada teenusega pac solution import. See on teie jaoks käivitatava pakendamisetapi autonoomne vorm, et pac copilot init --environment saaksite juurutatava lahenduse luua eraldi etapina , näiteks järgu konveieris. See töötab nii klassikalise kui ka CLI-autoriga (CliCopilot) agendi tööruumides.

Näide

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

Nõutavad parameetrid: copilot pack

--publisher-prefix -pp

Publisher lahenduse kohandamise eesliidet.

Valikulised parameetrid: copilot pack

--output-path -op

Lahenduse ZIP-faili väljundtee. Vaikimisi on valitud praegune kaust.

--project-dir -pd

Agenti tööruumi kataloog paketti koondamiseks. Vaikimisi on valitud praegune kaust.

--solution-name -sn

Lahenduse kordumatu nimi. Kui see puudub, tuletatakse agendi skeemi nimest.

Märkused

  • See on kohalik operatsioon. Pack loeb tööruumi ette ja kirjutab lahenduse .zip. See ei vaja autentimist ega keskkonda, seega on järgu konveieris töötamine ohutu.
  • Väljaandja eesliide peab olema kehtiv. --publisher-prefix peab olema regulaarne kohandusprefiks või pakkimise peatub enne kirjutamist.
  • Lahenduse nimi ja väljund. Kui see puudub --solution-name, tuletatakse lahenduse kordumatu nimi agendi skeemi nimest. Kirjutatakse .zip praegusse kataloogi, kui te pole määranud .--output-path
  • Paketti ei juurutata. See toodab lahenduse, kuid ei impordi seda. Agendi juurutamiseks järgige seda pac solution import ja kui pac copilot clone soovite selle jaoks sünkroonitud tööruumi.

pac copilot publish

Kohandatud kopiloti avaldamine

Nõutavad parameetrid: copilot publish

--bot -id

Copiloti ID või skeemi nimi (kordumatu nimi boti üksikasjades või failinimi lahenduse exploreris).

Valikulised parameetrid: copilot publish

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

pac copilot pull

Tõmmake Copilot Studio kaugmuudatused ja ühendage need kohaliku tööruumiga.

Käsk pac copilot pull toob agendi praeguse serverioleku ja ühendab selle teie kohalikku tööruumi kolmesuunalise ühendamise abil. See toiming tagab, et serveripoolsed muudatused ja teie puutumata kohalikud failid jäävad alles. Käivitage see enne redigeerimist ja käivitage see enne muudatuste tõukamist uuesti.

Näide

Käivitage käsk tööruumikaustast:

pac copilot pull

Või suunake see tööruumi mujale kettale.

pac copilot pull --project-dir contoso-support

Valikulised parameetrid: copilot pull

--project-dir -pd

Projektikataloogi tee. Vaikimisi on valitud praegune töökaust.

Märkused

  • Käivitage see sünkroonimisruumis. Käsk pull töötab ainult kaustas, mille on pac copilot clone loonud või pac copilot init. See loeb tööruumi sünkroonimis metaandmetest sihtkeskkonda ja agenti, mistõttu argumenti pole --environment . Kui käivitate selle mujal, nurjub see tõrkega "tööruumi ei leitud".
  • See kirjutab teie kohalikesse failidesse. Tõmme ühendab kaugmuudatused tööruumi ja laadib alla teabefailid. Kinnitage või varundage kohalik töö, millest te hoolite, enne tõmbamist.
  • Logige esmalt sisse i abil pac auth create.

pac copilot push

Saate kohaliku tööruumi muudatused Copilot Studio.

pac copilot push saadab teie kohalikus tööruumis tehtud muudatused Dataverse'i agendile tagasi. See võrdleb teie faile viimase teadaoleva serveriolekuga, laadib üles ainult selle, mis on muutunud (sh teabefailid, pilvevood ja ühenduseviited) ning annab teada, mida see avaldas.

Näide

Käivitage see tööruumikaustast:

pac copilot push

Või suunake see tööruumi mujale kettale.

pac copilot push --project-dir contoso-support

Valikulised parameetrid: copilot push

--project-dir -pd

Projektikataloogi tee. Vaikimisi on valitud praegune töökaust.

Märkused

  • Käivitage see sünkroonimisruumis. Like pull, töötab ainult kaustas, push mille on pac copilot clone loonud või pac copilot init. See loeb tööruumi sünkroonimis metaandmetest sihtkeskkonda. Pole argumenti --environment .
  • Tõmbuge esmalt, kui on konflikt. Kui sama üksust on muudetud nii kohalikult kui ka serveris, lükatakse peatused ja palutakse teil enne uuesti proovimist käivitada pac copilot pull . See protsess ei lase vaikselt üle kirjutada serveripoolset muudatust, mida te ei näinud.
  • Kohalikud muudatused pole no-op. Kui tõukamine ei leia midagi saata, teatab see ja väljub ilma keskkonda puudutamata.
  • Edukas tõukamine muteerub reaalajas agendi sihtkeskkonnas.
  • Logige esmalt sisse i abil pac auth create.

pac copilot quarantine

Kaaspiloodi agendi karantiinistaatus.

Nõutavad parameetrid: copilot quarantine

--bot-id -id

Kaaspiloodi ID karantiini/karantiini vabastamiseks.

Valikulised parameetrid: copilot quarantine

--environment -env

Keskkond (ID, organisatsiooni ID, URL, kordumatu nimi või osaline nimi).

--status -s

Karantiini staatuse väärtus. tõene = karantiin, vale = karantiinita mitte. Vaikimisi on tõene.

See parameeter ei vaja väärtust. See on lüliti.

pac copilot status

Küsitlus määratud copilot-i juurutuse oleku üle praeguses või sihtandmekeskkonnas.

Näide

See käsk küsitlustab määratud copilot-i juurutusolekut praeguses või sihtandmekeskkonnas.

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

Käsk tagastab väljundi järgmiselt.

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

Nõutavad parameetrid: copilot status

--bot-id -id

Kaaspiloti (Chatbot) ID.

Valikulised parameetrid: copilot status

--environment -env

Määrab sihtandmekanali. Väärtus võib olla GUID või absoluutne HTTPS-i URL. Kui seda pole määratud, kasutatakse praeguse autentimisprofiili jaoks valitud aktiivset organisatsiooni.

Sünkroonimiskäskude autentimine ja keskkond

cloneKõik käsud , pull, , pushja init --environment räägivad Dataverse'i keskkonnaga, seega vajavad nad autentimisprofiili. Logige esmalt sisse i abil pac auth create.

  • cloneja pullpush nõuab aktiivset profiili. pac copilot init Peate läbima --environmentainult ühe ; ilma selleta init , tellingud failid kohalikult ja ei vaja sisselogimist.
  • pull ja push lugege tööruumi sünkroonimis metaandmetest sihtkeskkonda, et nad ei võtaks enda peale argumenti --environment . clone ja init tehke seda.
  • pac copilot pack on puhtalt kohalik. See loeb ja kirjutab ainult faile, seega ei vaja see autentimist ega keskkonda.

pull ja push töötage ainult tööruumis, mille on clone loonud või init. Tööruumi loomisel kirjutatud sünkroonimis metaandmed annavad neile teada, millise agendi ja keskkonnaga rääkida, nii et nende käitamine mujal nurjub kiiresti tõrkega "tööruumi ei leitud".

Lisateave

Microsoft Power Platform CLI käsurühmad
Microsoft Power Platform CLI ülevaade