pac copilot

Alati i uslužni programi za upravljanje kopilotom.

Naredbe init, clone, pull, i pushpack omogućuju vam zadržavanje agenta Copilot Studio kao skupa datoteka na disku, uređivanje lokalno i sinkroniziranje s okruženjem Dataverse.

Uobičajena petlja izgleda ovako:

  1. Pokrenite radni prostor. Scaffold je potpuno novi agent s , pac copilot initili preuzmite postojeću sa pac copilot clone. U oba se načina dohvaća lokalni radni prostor koji sadrži metapodatke za sinkronizaciju o kojem ovise druge naredbe.
  2. Povucite prije uređivanja. pac copilot pull donosi udaljene promjene dolje i spaja ih u lokalne datoteke, tako da počinjete od trenutnog stanja poslužitelja.
  3. Gurni kad završite. pac copilot push vraća lokalne promjene. Ako se ista stavka u međuvremenu promijeni na poslužitelju, pritisnite zaustavljanja i zatražite da je najprije povučete.
  4. Paket za implementaciju. pac copilot pack pretvara radni prostor u rješenje koje možete .zip implementirati pomoću programa pac solution import.

Da biste od ničega prešli na agenta uživo u jednom koraku, pac copilot init --environment skele, paketi, uvozi i povezuje radni prostor umjesto vas. Pojedinačne naredbe omogućuju vam da sami pokrenete svaki dio petlje.

Naredbe

Command Opis
pac copilot clone Kloniranje agenta Copilot Studio u lokalni direktorij radnog prostora.
pac copilot create Stvara novog kopilota koji kao referencu koristi postojeću datoteku predloška.
pac copilot delete Brisanje prilagođene Copilot.
pac copilot extract-template Izdvaja datoteku predloška iz postojećeg kopilota u okruženju.
pac copilot extract-translation Izdvaja datoteku koja sadrži lokalizirani sadržaj za jednog ili više botova.
pac copilot init Stvorite novi radni Copilot Studio agenta iz predloška.
pac copilot list Popis kopilota u trenutnom ili ciljnom okruženju Dataverse.
pac copilot mcp Informacije o lokalnom MCP poslužitelju (protokolu konteksta modela).
pac copilot merge-translation Spojite datoteke koje sadrže lokalizirani sadržaj za jednog ili više botova.
pac copilot model list Modeli AI Builder u trenutnom okruženju.
pac copilot model predict Šalje tekst ili upit AI modelu
pac copilot model prepare-fetch Uzima FetchXML datoteku iz AI Velikog jezičnog modela (LLM) i priprema je za izvođenje u odnosu na trenutno okruženje.
pac copilot pack Zapakirati Copilot Studio radnog prostora agenta u zip datoteku rješenja.
pac copilot publish Objavljivanje prilagođenog kopilota
pac copilot pull Povucite udaljene promjene iz Copilot Studio i spojite se s lokalnim radnim prostorom.
pac copilot push Proslijedite promjene lokalnog radnog prostora u Copilot Studio.
pac copilot quarantine Status karantene kopilota.
pac copilot status Provjerite status implementacije navedenog kopilota u trenutnom ili ciljnom okruženju Dataverse.

pac copilot clone

Kloniranje agenta Copilot Studio u lokalni direktorij radnog prostora.

pac copilot clonepreuzima postojećeg agenta Copilot Studio u lokalni direktorij radnog prostora, zajedno s metapodacima za sinkronizaciju pac copilot pull koji se pac copilot push i imajte na umu. Datoteke agenta pišu se u podmapu nazvanu po zaslonsko ime.

Primjer

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

Obavezni parametri za copilot clone

--bot -id

ID kopilota ili naziv sheme (jedinstveni naziv pronađen u detaljima bota ili naziv datoteke u eksploreru rješenja).

Neobavezni parametri za copilot clone

--component-collection -cc

ID zbirke komponenti za kloniranje. Ponovite postupak za višekratnik.

--display-name -dn

Zaslonski naziv agenta (koristi se za imenovanje mapa).

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

--output-dir -od

Korijenska mapa za kloniranje izlaza. Zadano za trenutni direktorij.

Napomene

  • --botprihvaća Copilot ID ili shemu. Proslijedite id Copilot (GUID) ili naziv sheme agenta. Naredbom se razrješavanje naziva sheme u odnosu na ciljno okruženje.
  • Odredišna podmapa mora biti prazna. Klon zapisuje u mapu nazvanu po prikazanom imenu agenta (sanitizirano) u odjeljku --output-dir. Ako ta mapa već sadrži datoteke, klon se zaustavlja umjesto da ih prebriše. Koristi --display-name se za odabir drugog naziva mape.
  • Zbirke komponenti kloniranja. Da biste zbirke komponenti uveli zajedno s agentom, proslijedite jedan ILI više ID-ova zbirke s razmacima --component-collectionodijeljenim točkama sa zarezom.
  • Klon zahtijeva provjereni profil (pac auth create) i rješava --environmentokruženje iz ili iz organizacije aktivnog profila kada ga izostavite.

pac copilot create

Stvara novog kopilota koji kao referencu koristi postojeću datoteku predloška.

Obavezni parametri za copilot create

--displayName

Zaslonski naziv novog kopilota

--schemaName

Naziv sheme (jedinstveni naziv) novog kopilota.

--solution -s

Naziv rješenja.

--templateFileName

Izvorna datoteka yaml koja sadrži predložak kopilota izdvojen pomoću naredbe za izdvajanje predloška.

Neobavezni parametri za copilot create

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

pac copilot delete

Brisanje prilagođene Copilot.

Obavezni parametri za copilot delete

--bot -id

ID kopilota ili naziv sheme (jedinstveni naziv pronađen u detaljima bota ili naziv datoteke u eksploreru rješenja).

Neobavezni parametri za copilot delete

--confirm -y

Potrebno za potvrdu brisanja kopilota.

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

pac copilot extract-template

Izdvaja datoteku predloška iz postojećeg kopilota u okruženju.

Primjer

Ova naredba izdvaja datoteku predloška iz postojećeg kopilota u okruženju.

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

Naredba vraća izlaz na sljedeći način za kopilota na engleskom i njemačkom jeziku:

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

Obavezni parametri za copilot extract-template

--bot -id

ID kopilota ili naziv sheme (jedinstveni naziv pronađen u detaljima bota ili naziv datoteke u eksploreru rješenja).

--templateFileName

Mjesto yaml datoteke na koju treba pisati predložak kopilota.

Neobavezni parametri za copilot extract-template

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

--overwrite -o

Dopustite pisanje preko izlazne podatkovne datoteke ako ona već postoji.

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

--templateName

Naziv predloška ili 'kickStartTemplate' ako naziv nije naveden.

--templateVersion

Verzija predloška u obliku X.X.X ili 1.0.0 ako verzija nije navedena.

pac copilot extract-translation

Izdvaja datoteku koja sadrži lokalizirani sadržaj za jednog ili više botova.

Primjer

Ova naredba izdvaja datoteku koja sadrži lokalizirani sadržaj za jedno ili više kopilota.

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

Naredba vraća izlaz na sljedeći način:

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

Neobavezni parametri za copilot extract-translation

--all -a

Napišite lokalizacijske datoteke za sve podržane jezike. Po zadanom je napisan samo primarni jezik.

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

--bot -id

ID kopilota ili naziv sheme (jedinstveni naziv pronađen u detaljima bota ili naziv datoteke u eksploreru rješenja).

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

--format

Oblik datoteke u kojem se pišu lokalizirane datoteke, "resx" ili "json". Zadana je postavka "resx".

--outdir

Izlazni direktorij u koji treba pisati.

--overwrite -o

Dopustite pisanje preko izlazne podatkovne datoteke ako ona već postoji.

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

--sourcedir -src

Direktorij izvorišnog rješenja. Kada je navedeno, zanemarit će povezano okruženje prilikom pretraživanja botova i umjesto toga potražiti sadržaj u mapi rješenja.

pac copilot init

Stvorite novi radni Copilot Studio agenta iz predloška.

pac copilot initscaffolds a new Copilot Studio agent workspace from a template. Pokreće se u jednom od dva načina rada, a prisutnost odlučuje --environment koji način rada koristiti:

  • Lokalna skela – ne --environment. Zapisuje datoteke predložaka u direktorij projekta i zaustavlja se. Naredba ne stvara ništa u alatu Dataverse i ne zahtijeva prijavu. Taj način rada koristite kada želite stvoriti lokalno i povezati se s okruženjem kasnije.
  • Bootstrap – --environment priložen. Scaffolds datoteke, pakira ih u rješenje, uvozi to rješenje u okruženje i povezuje radni prostor s novostvorenim agentom. Taj je način rada put od jednog koraka od ničega do agenta spremnog za sinkronizaciju i potreban je profil provjerene autentičnosti.

Primjeri

Lokalno skele s radnim prostorom:

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

Scaffold i bootstrap live agent u okruženju u jednom koraku:

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

Skela agent cli-authored (CliCopilot) u određenu mapu:

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

Obavezni parametri za copilot init

--name -n

Zaslonsko ime agenta.

--publisher-prefix -pp

Publisher prefiks prilagodbe rješenja.

Neobavezni parametri za copilot init

--authoring-mode -am

Agent authoring shape to scaffold (default: 'classic'). Upotrijebite "cli-copilot" za skelovanje agenta CliCopilota koji je autor CLI-ja.

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

--instructions -ins

Upute za sustav agenta.

--project-dir -pd

Ciljni direktorij za radni prostor agenta. Zadano za trenutni direktorij.

--schema-name -sn

Puni naziv sheme agenta. Nadjačava zadanu izvedenost ({publisher-prefix}_{sanitized-name}). Koristi se as-is bez izmjena.

--template -t

Naziv profila predloška (zadano, minimalno). Zadano na "zadano".

Napomene

  • Direktorij projekta mora biti prazan. init ne nad postojećim datotekama, pa pokažite --project-dir na novu ili praznu mapu.
  • Izvedenje naziva sheme. Kada izostavite , --schema-namenaziv sheme agenta izgrađen je kao {publisher-prefix}_{sanitized-name}. Proslijedi --schema-name da biste je izričito postavili; vrijednost se koristi as-is.
  • Bootstrap radi za oba načina rada za stvaranje. init --environment bootstraps agent uživo u jednom koraku za zadani klasični način rada i za --authoring-mode cli-copilot. Umjesto agenta cliCopilota možete lokalno podmapeti ( --environmentne), pac copilot packpac solution import a zatim je pokrenuti da biste je sami implementirati.
  • Bootstrap stvara objekte na strani poslužitelja. U načinu rada bootstrap init uvozi rješenje i stvara agenta u ciljnom okruženju. Ako agent s istim nazivom sheme već postoji, zaustavlja init se i upućuje na povezivanje pac copilot clone s postojećim agentom.
  • Potpuno novo okruženje može sporo prihvaćati prvi uvoz. Svježe stvoreno okruženje može potrajati minutu ili dvije za zagrijavanje. Rano pokretanje zamke može ne uspjeti uz poruku "Asinkrone operacije trenutno su onemogućene za ovu tvrtku ili ustanovu." Pričekajte trenutak pa ga ponovno pokrenite.
  • --template (default ili minimal) odnosi se samo na klasični način rada za stvaranje.

pac copilot list

Popis kopilota u trenutnom ili ciljnom okruženju Dataverse.

Primjer

Ova naredba sadrži popis svih kopilota u trenutnom ili ciljnom okruženju Dataverse.

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

Naredba vraća izlaz na sljedeći način:

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

Neobavezni parametri za copilot list

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

pac copilot mcp

Informacije o lokalnom MCP poslužitelju (protokolu konteksta modela).

Primjer

pac copilot mcp --run

Neobavezni parametri za copilot mcp

--run -r

Pokrenite lokalni MCP (protokol kontekstnog modela) poslužitelja.

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

Napomene

Saznajte kako koristiti POWER Platform CLI s ugrađenim MCP poslužiteljem

pac copilot merge-translation

Spojite datoteke koje sadrže lokalizirani sadržaj za jednog ili više botova.

Primjer

Ova naredba spaja datoteke koje sadrže lokalizirani sadržaj za jedno ili više kopilota.

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

Naredba vraća izlaz na sljedeći način prilikom ažuriranja njemačkog jezika:

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.

Saznajte kako upravljati pogreškama iz naredbe za spajanje prijevoda

Neobavezni parametri za copilot merge-translation

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

--file -f

Popis datoteka koje sadrže prijevode. Podržani su glob uzorci.

--solution -s

Naziv rješenja.

--sourcedir -src

Direktorij izvorišnog rješenja. Kada je navedeno, zanemarit će povezano okruženje prilikom pretraživanja botova i umjesto toga potražiti sadržaj u mapi rješenja.

--verbose

Izlazni dodatni dijagnostički podaci tijekom uvoza/izvoza podataka

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

--whatif

Ne izvršava naredbu, već daje detalje o tome što će se dogoditi.

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

pogreške spajanja i prijevoda

Na temelju gore navedenog primjera, ako u datoteci koja se koristi za ažuriranje kopilota postoji jedna pogreška, rezultat izgleda ovako:

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.

Zastavica --verbose dodaje pojedinosti o pogrešci:

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

Modeli AI Builder u trenutnom okruženju.

Primjer

Ova naredba sadrži popis svih modela AI Builder.

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

Naredba vraća izlaz na sljedeći način:

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

Neobavezni parametri za copilot model list

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

pac copilot model predict

Šalje tekst ili upit AI modelu

Neobavezni parametri za copilot model predict

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

--model-id -id

ID modela AI Builder

--model-name -n

Puni ili djelomični naziv modela AI

--prompt -p

Upit za slanje UI modelu

--text -t

Tekst za slanje UI modelu

pac copilot model prepare-fetch

Uzima FetchXML datoteku iz AI Velikog jezičnog modela (LLM) i priprema je za izvođenje u odnosu na trenutno okruženje.

Obavezni parametri za copilot model prepare-fetch

--inputFile -i

Ulazna FetchXML datoteka koja obično dolazi iz AI LLM-a.

--outputFile -o

Izlazna FetchXML datoteka koja je spremna za izvršavanje u odnosu na trenutno okruženje.

Neobavezni parametri za copilot model prepare-fetch

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

pac copilot pack

Zapakirati Copilot Studio radnog prostora agenta u zip datoteku rješenja.

pac copilot pack pakira radni prostor agenta u rješenje Dataverse koje .zip možete implementirati pomoću servisa pac solution import. To je pac copilot init --environment samostalni oblik koraka pakiranja koji se pokreće za vas, pa rješenje koje se može implementirati možete stvoriti kao zaseban korak – na primjer, u kanalu međuverzije. Funkcionira i za klasične radne prostore agenta i za agente clicopilota.

Primjer

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

Obavezni parametri za copilot pack

--publisher-prefix -pp

Publisher prefiks prilagodbe rješenja.

Neobavezni parametri za copilot pack

--output-path -op

Izlazni put za zip datoteku rješenja. Zadano za trenutni direktorij.

--project-dir -pd

Direktorij radnog prostora agenta za pakiranje. Zadano za trenutni direktorij.

--solution-name -sn

Jedinstveni naziv rješenja. Ako se izostavi, proizlazi iz naziva sheme agenta.

Napomene

  • To je lokalna operacija. Paket čita radni prostor i napiše rješenje .zip. Nije potrebna provjera autentičnosti ni okruženje, pa je sigurno pokrenuti u međuverziji kanala.
  • Prefiks izdavača mora biti valjan. --publisher-prefix mora biti pravilno oblikovan prefiks prilagodbe ili paket prestaje prije nego što nešto zapišete.
  • Naziv i izlaz rješenja. Ako izostavite --solution-name, jedinstveni naziv rješenja proizlazi iz naziva sheme agenta. Zapisan .zip je u trenutni direktorij, osim ako ne postavite --output-path.
  • Paket se ne implementira. Ono stvara rješenje, ali ga ne uvozi. Slijedite ga s pac solution import da biste implementirati agenta, pac copilot clone a zatim ako želite za njega povezani radni prostor povezan sa sinkronizacijom.

pac copilot publish

Objavljivanje prilagođenog kopilota

Obavezni parametri za copilot publish

--bot -id

ID kopilota ili naziv sheme (jedinstveni naziv pronađen u detaljima bota ili naziv datoteke u eksploreru rješenja).

Neobavezni parametri za copilot publish

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

pac copilot pull

Povucite udaljene promjene iz Copilot Studio i spojite se s lokalnim radnim prostorom.

Naredba pac copilot pull dohvaća trenutno stanje poslužitelja agenta i spaja ga u lokalni radni prostor pomoću trosmjernog spajanja. Tim se postupkom jamči da će izmjene na strani poslužitelja i vaše netaknute lokalne datoteke ostati netaknute. Pokrenite je prije nego što počnete uređivati, a zatim ga ponovno pokrenite prije nego što unesite promjene.

Primjer

Pokrenite naredbu iz mape radnog prostora:

pac copilot pull

Ili ga usmjerite na radni prostor negdje drugdje na disku:

pac copilot pull --project-dir contoso-support

Neobavezni parametri za copilot pull

--project-dir -pd

Put do direktorija projekta. Zadano u trenutnom radnom direktoriju.

Napomene

  • Pokrenite ga unutar radnog prostora za sinkronizaciju. Naredba pull funkcionira samo u mapi koju je stvorio ili pac copilot initpac copilot clone . Čita ciljno okruženje i agent iz metapodataka sinkronizacije radnog prostora, zbog čega nema --environment argumenta. Ako ga pokrenete bilo gdje drugdje, ne uspijeva uz pogrešku "radni prostor nije pronađen".
  • Piše u lokalne datoteke. Povlačenjem spajaju se udaljene promjene u radni prostor i preuzimaju se datoteke znanja. Obavite ili sigurnosno kopirajte lokalni posao do kojeg vam je stalo prije povlačenjem.
  • Najprije se prijavite pomoću servisa pac auth create.

pac copilot push

Proslijedite promjene lokalnog radnog prostora u Copilot Studio.

pac copilot push šalje promjene u lokalnom radnom prostoru agentu u Dataverse. Uspoređuje datoteke s posljednjim poznatim stanjem poslužitelja, prenosi samo ono što se promijenilo, uključujući datoteke znanja, tijekove u oblaku i reference veze, te izvješćuje o tome što je gurnuo.

Primjer

Pokrenite je iz mape radnog prostora:

pac copilot push

Ili ga usmjerite na radni prostor na drugom mjestu na disku:

pac copilot push --project-dir contoso-support

Neobavezni parametri za copilot push

--project-dir -pd

Put do direktorija projekta. Zadano u trenutnom radnom direktoriju.

Napomene

  • Pokrenite ga unutar radnog prostora za sinkronizaciju. Sviđa mi pullse , push funkcionira samo u mapi koju je stvorio pac copilot clone ili pac copilot init. U njemu se čita ciljno okruženje iz metapodataka za sinkronizaciju radnog prostora. Nema argumenta --environment .
  • Prvo povucite ako postoji sukob. Ako se ista stavka promijenila i lokalno i na poslužitelju, automatska zaustavljanja i traži da pokrenete prije pac copilot pull ponovnog pokušaja. Tim se postupkom ne može u pozadini prebrisati promjena na strani poslužitelja koju niste vidjeli.
  • Nema lokalnih promjena je no-op. Ako push ne pronađe ništa za slanje, prijavljuje da i izlazi bez dodirivanja okruženja.
  • Uspješna automatska mutacija agenta uživo u ciljnom okruženju.
  • Najprije se prijavite pomoću servisa pac auth create.

pac copilot quarantine

Status karantene kopilota.

Obavezni parametri za copilot quarantine

--bot-id -id

Identifikacija kopilota za karantenu/dekarantenu.

Neobavezni parametri za copilot quarantine

--environment -env

Okruženje (ID, ID tvrtke ili ustanove, URL, jedinstveni naziv ili djelomični naziv).

--status -s

Vrijednost karantenskog statusa. True = karantena, false = nekarantena. Podrazumijevano je true.

Ovaj parametar ne zahtijeva vrijednost. To je prekidač.

pac copilot status

Provjerite status implementacije navedenog kopilota u trenutnom ili ciljnom okruženju Dataverse.

Primjer

Ova naredba ankete status implementacije navedenog kopilota u trenutnom ili ciljnom Dataverse okruženju.

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

Naredba vraća izlaz na sljedeći način:

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

Obavezni parametri za copilot status

--bot-id -id

ID kopilota (Chatbot).

Neobavezni parametri za copilot status

--environment -env

Određuje ciljni Dataverse. Vrijednost može biti GUID ili apsolutni https URL. Kada nije navedeno, koristit će se aktivna tvrtka ili ustanova odabrana za trenutni profil za auth.

Provjera autentičnosti i okruženje za naredbe sinkronizacije

, clone, pulli pushnaredbe sve init --environment razgovaraju s okruženjem Dataverse, pa im je potreban profil za provjeru autentičnosti. Najprije se prijavite pomoću servisa pac auth create.

  • clonei pullpotreban push vam je aktivan profil. pac copilot init samo ga treba kada prođete --environment; bez njega datoteke init scaffolds lokalno i ne treba prijavu.
  • pull i push pročitajte ciljno okruženje iz metapodataka sinkronizacije radnog prostora da ne bi došlo do --environment argumenta. clone i init učini to.
  • pac copilot pack je isključivo lokalno. Samo za čitanje i pisanje datoteka, pa joj nije potrebna provjera autentičnosti ni okruženje.

pull i push raditi samo unutar radnog prostora koji je stvorio clone ili init. Metapodaci sinkronizacije zapisani kada se stvori radni prostor ono su što im govori s kojim agentom i okruženjem treba razgovarati, pa njihovo pokretanje bilo gdje drugdje brzo ne uspijeva uz pogrešku "radni prostor nije pronađen".

Vidi također

Microsoft Power Platform CLI naredbene grupe
Pregled CLI-ja za Microsoft Power Platform

  • Last updated on