pac copilot

Verktøy og verktøy for copilot-administrasjon.

Med initkommandoene , clone, pull, pushog pack kan du beholde en Copilot Studio agent som et sett med filer på disken, redigere den lokalt og synkronisere den med et dataverst miljø.

En vanlig løkke ser slik ut:

1. Start et arbeidsområde. Stillas til en helt ny agent med pac copilot init, eller last ned en eksisterende agent med pac copilot clone. Uansett får du et lokalt arbeidsområde som bærer synkroniseringsmetadataene de andre kommandoene avhenger av.
2. Dra før du redigerer. pac copilot pull bringer eksterne endringer ned og fletter dem inn i lokale filer, slik at du starter fra gjeldende servertilstand.
3. Trykk når du er ferdig. pac copilot push sender de lokale endringene tilbake. Hvis det samme elementet ble endret på serveren i mellomtiden, stopper push og ber deg om å trekke først.
4. Pakke for distribusjon. pac copilot pack gjør et arbeidsområde om til en løsning .zip du kan distribuere med pac solution import.

Hvis du vil gå fra ingenting til en live agent i ett trinn, pac copilot init --environment stillas, pakker, importer og kobler arbeidsområdet for deg. Med de individuelle kommandoene kan du kjøre hver del av løkken på egen hånd.

Kommandoer

pac copilot clone

Klon en Copilot Studio agent til en lokal arbeidsområdekatalog.

pac copilot clonelaster ned en eksisterende Copilot Studio agent i en lokal arbeidsområdekatalog, sammen med synkroniseringsmetadataene som pac copilot pull og pac copilot push er avhengige av. Agentens filer er skrevet til en undermappe oppkalt etter visningsnavnet.

Eksempel

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

Obligatoriske parametere for copilot clone

--bot -id

Copilot-ID- eller skjemanavnet (unikt navn som finnes i botdetaljer eller filnavn i løsningsutforsker).

Valgfrie parametere for copilot clone

--component-collection -cc

Komponentsamlings-ID som skal klones. Gjenta for flere.

--display-name -dn

Visningsnavnet til agenten (brukes til mappenavning).

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--output-dir -od

Rotmappe for kloneutdata. Standarder for gjeldende katalog.

Merknader

• --botgodtar et Copilot-ID- eller skjemanavn. Send enten Copilot-ID (en GUID) eller agentens skjemanavn. Kommandoen løser et skjemanavn mot målmiljøet.
• Målundermappen må være tom. Klone skriver inn i en mappe oppkalt etter agentens (sanitiserte) visningsnavn under --output-dir. Hvis mappen allerede inneholder filer, stopper klone i stedet for å overskrive dem. Brukes --display-name til å velge et annet mappenavn.
• Kloning av komponentsamlinger. Hvis du vil hente komponentsamlinger ned sammen med agenten, sender du én eller flere samlings-ID-er med , atskilt med --component-collectionsemikolon.
• Klone krever en godkjent profil (pac auth create) og løser miljøet fra --environment, eller fra den aktive profilens organisasjon når du utelater det.

pac copilot create

Oppretter en ny copilot ved hjelp av en eksisterende malfil som referanse.

Obligatoriske parametere for copilot create

--displayName

Visningsnavnet til den nye copiloten

--schemaName

Skjemanavnet (unikt navn) for den nye copiloten.

--solution -s

Navnet på løsningen.

--templateFileName

Kilde-yaml-fil som inneholder copilot-malen som ble trukket ut ved hjelp av uttrekkingsmalkommandoen.

Valgfrie parametere for copilot create

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac copilot delete

Slett en egendefinert Copilot.

Obligatoriske parametere for copilot delete

--bot -id

Copilot-ID- eller skjemanavnet (unikt navn som finnes i botdetaljer eller filnavn i løsningsutforsker).

Valgfrie parametere for copilot delete

--confirm -y

Kreves for å bekrefte sletting av copiloten.

Denne parameteren krever ingen verdi. Det er en bryter.

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac copilot extract-template

Trekker ut en malfil fra en eksisterende copilot i et miljø.

Eksempel

Denne kommandoen trekker ut en malfil fra en eksisterende copilot i et miljø.

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

Kommandoen returnerer utdata som følgende for en copilot som bruker de engelske og tyske språkene:

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

Obligatoriske parametere for copilot extract-template

--bot -id

Copilot-ID- eller skjemanavnet (unikt navn som finnes i botdetaljer eller filnavn i løsningsutforsker).

--templateFileName

Plasseringen til yaml-filen som copilotmalen skal skrives til.

Valgfrie parametere for copilot extract-template

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--overwrite -o

Tillat overskriving av utdatafilen hvis den allerede finnes.

Denne parameteren krever ingen verdi. Det er en bryter.

--templateName

Malnavn eller kickStartTemplate hvis navnet ikke er angitt.

--templateVersion

Malversjon i X.X.X-format eller 1.0.0 hvis versjon ikke er angitt.

pac copilot extract-translation

Pakker ut filen som inneholder lokalisert innhold for én eller flere roboter.

Eksempel

Denne kommandoen trekker ut en fil som inneholder lokalisert innhold for én eller flere kopiloter.

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

Kommandoen returnerer utdata som følgende:

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

Valgfrie parametere for copilot extract-translation

--all -a

Skriv lokaliseringsfiler for alle støttede språk. Som standard er bare det primære språket skrevet.

Denne parameteren krever ingen verdi. Det er en bryter.

--bot -id

Copilot-ID- eller skjemanavnet (unikt navn som finnes i botdetaljer eller filnavn i løsningsutforsker).

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--format

Filformatet der du skriver lokaliserte filer, enten «resx» eller «json». Standardverdien er resx.

--outdir

Utdatakatalogen du vil skrive til.

--overwrite -o

Tillat overskriving av utdatafilen hvis den allerede finnes.

Denne parameteren krever ingen verdi. Det er en bryter.

--sourcedir -src

Kildeløsningskatalog. Når det er angitt, ignoreres det tilkoblede miljøet når du leter etter roboter og i stedet ser etter innhold i løsningsmappen.

pac copilot init

Opprett et nytt Copilot Studio agentarbeidsområde fra en mal.

pac copilot initstillaser et nytt Copilot Studio agentarbeidsområde fra en mal. Den kjører i én av to moduser, og tilstedeværelsen av --environment bestemmer hvilken modus som skal brukes:

• Lokalt stillas – nei --environment. Skriver malfilene i prosjektkatalogen og stopper. Kommandoen oppretter ikke noe i Dataverse og krever ikke pålogging. Bruk denne modusen når du vil redigere lokalt og koble til et miljø senere.
• Bootstrap – --environment levert. Stillaser filene, pakker dem inn i en løsning, importerer løsningen til miljøet og kobler arbeidsområdet til den nyopprettede agenten. Denne modusen er etttrinnsbanen fra ingenting til en live, synkroniseringsklar agent, og den krever en godkjent profil.

Eksempler

Stillas et arbeidsområde lokalt:

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

Stillas og bootstrap en live agent i et miljø i ett trinn:

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

Stillas en CLI-forfattet (CliCopilot) agent i en bestemt mappe:

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

Obligatoriske parametere for copilot init

--name -n

Agentens visningsnavn.

--publisher-prefix -pp

Publisher tilpassingsprefiks for løsningen.

Valgfrie parametere for copilot init

--authoring-mode -am

Agentens redigeringsfigur til stillas (standard: «klassisk». Bruk "cli-copilot" til stillas en CLI-forfattet CliCopilot agent.

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--instructions -ins

Agentsysteminstruksjoner.

--project-dir -pd

Målkatalog for agentarbeidsområdet. Standarder for gjeldende katalog.

--schema-name -sn

Fullt agentskjemanavn. Overstyrer standardavledningen ({publisher-prefix}_{sanitized-name}). Brukes as-is uten endring.

--template -t

Malprofilnavn (standard, minimal). Standard er standard.

Merknader

• Prosjektkatalogen må være tom. init stillaser ikke over eksisterende filer, så pek --project-dir på en ny eller tom mappe.
• Skjemanavnavledning. Når du utelater --schema-name, bygges agentskjemanavnet som {publisher-prefix}_{sanitized-name}. Send --schema-name for å angi den eksplisitt. Verdien brukes as-is.
• Bootstrap fungerer for begge redigeringsmodusene. init --environment bootstraps en live agent i ett trinn for standard klassisk modus og for --authoring-mode cli-copilot. Som et alternativ for en CliCopilot-agent, kan du stillas lokalt (nei --environment), og deretter kjøre pac copilot pack etterfulgt av pac solution import å distribuere den selv.
• Bootstrap oppretter objekter på serversiden. I bootstrap-modus init importerer du en løsning og oppretter agenten i målmiljøet. Hvis en agent med samme skjemanavn allerede finnes, init stopper og peker du til å pac copilot clone koble til den eksisterende agenten i stedet.
• Et helt nytt miljø kan være tregt å godta den første importen. Et nyopprettet miljø kan ta et minutt eller to å varme opp. En tidlig bootstrap kan mislykkes med «Async-operasjoner er deaktivert for denne organisasjonen». Vent litt og kjør det igjen.
• --template (default eller minimal) gjelder bare for den klassiske redigeringsmodusen.

pac copilot list

Liste over copiloter i gjeldende eller måldataverse miljø.

Eksempel

Denne kommandoen viser alle copiloter i gjeldende eller måldataverse miljø.

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

Kommandoen returnerer utdata som følgende:

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

Valgfrie parametere for copilot list

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac copilot mcp

Informasjon om lokal MCP-server (Model Context Protocol).

Eksempel

pac copilot mcp --run

Valgfrie parametere for copilot mcp

--run -r

Kjør den lokale MCP-serveren (Model Context Protocol).

Denne parameteren krever ingen verdi. Det er en bryter.

Merknader

Lær hvordan du bruker Power Platform CLI med innebygd MCP-server

pac copilot merge-translation

Slå sammen filer som inneholder lokalisert innhold for én eller flere roboter.

Eksempel

Denne kommandoen slår sammen filer som inneholder lokalisert innhold for én eller flere copiloter.

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

Kommandoen returnerer utdata som følger når du oppdaterer det tyske språket:

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.

Finn ut mer om hvordan du administrerer feil fra kommandoen for fletteoversettelse

Valgfrie parametere for copilot merge-translation

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--file -f

Listen over filer som inneholder oversettelser. Glob-mønstre støttes.

--solution -s

Navnet på løsningen.

--sourcedir -src

Kildeløsningskatalog. Når det er angitt, ignoreres det tilkoblede miljøet når du leter etter roboter og i stedet ser etter innhold i løsningsmappen.

--verbose

Utdata for mer diagnosedata under dataimport/eksport

Denne parameteren krever ingen verdi. Det er en bryter.

--whatif

Utfører ikke kommandoen, men sender ut detaljene for hva som ville skje.

Denne parameteren krever ingen verdi. Det er en bryter.

fletteoversettelsesfeil

Basert på eksemplet ovenfor, hvis det finnes én feil i filen som brukes til å oppdatere copiloten, ser utdataene slik ut:

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.

Flagget --verbose legger til detaljer om feilen:

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-modeller i gjeldende miljø.

Eksempel

Denne kommandoen viser alle AI Builder-modeller.

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

Kommandoen returnerer utdata som følgende:

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

Valgfrie parametere for copilot model list

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac copilot model predict

Sender tekst eller spør til AI-modell

Valgfrie parametere for copilot model predict

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

--model-id -id

AI Builder-modell-ID

--model-name -n

Fullstendig eller delvis ai-modellnavn

--prompt -p

Be om å sende til AI-modell

--text -t

Tekst som skal sendes til AI-modell

pac copilot model prepare-fetch

Tar FetchXML-filen fra AI Large Language Model (LLM) og klargjør den for kjøring mot gjeldende miljø.

Obligatoriske parametere for copilot model prepare-fetch

--inputFile -i

Skriv inn FetchXML-fil som vanligvis kommer fra AI LLM.

--outputFile -o

Utdata-FetchXML-fil som er klar til å kjøre mot gjeldende miljø.

Valgfrie parametere for copilot model prepare-fetch

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac copilot pack

Pakk et arbeidsområde for Copilot Studio agent i en zip-fil for løsning.

pac copilot pack pakker et agentarbeidsområde inn i en Dataverse-løsning .zip som du kan distribuere med pac solution import. Det er den frittstående formen for pakketrinnet som kjører for deg, slik at pac copilot init --environment du kan produsere den distribuerbare løsningen som et eget trinn – for eksempel i et samlebånd for bygg. Det fungerer for både klassiske og CLI-forfattet (CliCopilot) agent arbeidsområder.

Eksempel

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

Obligatoriske parametere for copilot pack

--publisher-prefix -pp

Publisher tilpassingsprefiks for løsningen.

Valgfrie parametere for copilot pack

--output-path -op

Utdatabane for zip-filen for løsningen. Standarder for gjeldende katalog.

--project-dir -pd

Katalog for agentarbeidsområde som skal pakkes. Standarder for gjeldende katalog.

--solution-name -sn

Unikt løsningsnavn. Hvis utelatt, avledet fra agentskjemanavnet.

Merknader

• Det er en lokal operasjon. Pakken leser arbeidsområdet og skriver en løsning .zip. Det trenger ingen godkjenning og ikke noe miljø, så det er trygt å kjøre i et byggsamlebånd.
• Utgiverprefikset må være gyldig. --publisher-prefix må være et velformet tilpassingsprefiks, eller pakkestopp før du skriver noe.
• Løsningsnavn og utdata. Hvis du utelater --solution-name, hentes løsningens unike navn fra agentskjemanavnet. Skrives .zip til gjeldende katalog med mindre du angir --output-path.
• Pakken distribueres ikke. Den produserer løsningen, men importerer den ikke. Følg den med pac solution import for å distribuere agenten, og pac copilot clone hvis du vil ha et synkroniseringstilkoblet arbeidsområde for det.

pac copilot publish

Publiser en egendefinert copilot

Obligatoriske parametere for copilot publish

--bot -id

Copilot-ID- eller skjemanavnet (unikt navn som finnes i botdetaljer eller filnavn i løsningsutforsker).

Valgfrie parametere for copilot publish

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

pac copilot pull

Dra eksterne endringer fra Copilot Studio og flett med lokalt arbeidsområde.

Kommandoen pac copilot pull henter den gjeldende servertilstanden til agenten og fletter den inn i det lokale arbeidsområdet ved hjelp av en treveis fletting. Denne prosessen sikrer at redigeringer på serversiden og de uberørte lokale filene forblir intakte. Kjør den før du begynner å redigere, og kjør den på nytt før du skyver endringene.

Eksempel

Kjør kommandoen fra innsiden av arbeidsområdemappen:

pac copilot pull

Eller pek den på et arbeidsområde et annet sted på disken:

pac copilot pull --project-dir contoso-support

Valgfrie parametere for copilot pull

--project-dir -pd

Bane til prosjektkatalogen. Standarder for gjeldende arbeidsmappe.

Merknader

• Kjør den inne i et synkroniseringsområde. Kommandoen pull fungerer bare i en mappe som er opprettet av pac copilot clone eller pac copilot init. Den leser målmiljøet og agenten fra arbeidsområdets synkroniseringsmetadata, og derfor finnes det ikke noe --environment argument. Hvis du kjører det et annet sted, mislykkes det med en feilmelding om at arbeidsområdet ikke ble funnet.
• Den skriver til de lokale filene dine. Trekker sammen eksterne endringer i arbeidsområdet og laster ned kunnskapsfiler. Utfør eller sikkerhetskopiere lokalt arbeid du bryr deg om før du drar.
• Logg på først med pac auth create.

pac copilot push

Send endringer i det lokale arbeidsområdet til Copilot Studio.

pac copilot push sender endringene i det lokale arbeidsområdet tilbake til agenten i Dataverse. Den sammenligner filene dine med den siste kjente servertilstanden, laster opp bare det som er endret – inkludert kunnskapsfiler, skyflyter og tilkoblingsreferanser – og rapporterer hva den presset.

Eksempel

Kjør den fra innsiden av arbeidsområdemappen:

pac copilot push

Eller pek den på et arbeidsområde et annet sted på disken:

pac copilot push --project-dir contoso-support

Valgfrie parametere for copilot push

--project-dir -pd

Bane til prosjektkatalogen. Standarder for gjeldende arbeidsmappe.

Merknader

• Kjør den inne i et synkroniseringsområde. Like pullfungerer push bare i en mappe som er opprettet av pac copilot clone eller pac copilot init. Den leser målmiljøet fra arbeidsområdets synkroniseringsmetadata. Det er ikke noe --environment argument.
• Dra først hvis det er en konflikt. Hvis det samme elementet endret seg både lokalt og på serveren, stopper push og ber deg om å kjøre pac copilot pull før du prøver på nytt. Denne prosessen holder et trykk fra stille overskriving av en endring på serversiden du ikke så.
• Ingen lokale endringer er en no-op. Hvis push ikke finner noe å sende, rapporterer det og avslutter uten å berøre miljøet.
• En vellykket push muterer live-agenten i målmiljøet.
• Logg på først med pac auth create.

pac copilot quarantine

Karantenestatus for copilot-agent.

Obligatoriske parametere for copilot quarantine

--bot-id -id

ID-en til andrepiloten for karantene/oppheving.

Valgfrie parametere for copilot quarantine

--environment -env

Miljø (ID, organisasjons-ID, nettadresse, unikt navn eller delvis navn).

--status -s

Karantenestatusverdi. sant = karantene, falsk = ikke-karantene. Standardinnstillingen er true.

Denne parameteren krever ingen verdi. Det er en bryter.

pac copilot status

Avspørr distribusjonsstatusen for en angitt copilot i gjeldende eller måldataverse miljø.

Eksempel

Denne kommandoen avspørrer distribusjonsstatusen for en angitt copilot i gjeldende eller måldataverse miljø.

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

Kommandoen returnerer utdata som følgende:

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

Obligatoriske parametere for copilot status

--bot-id -id

ID-en til en copilot (Chatbot).

Valgfrie parametere for copilot status

--environment -env

Angir måldataverset. Verdien kan være en GUID- eller absolutt URL-adresse for https. Når det ikke er angitt, brukes den aktive organisasjonen som er valgt for gjeldende godkjenningsprofil.

Godkjenning og miljø for synkroniseringskommandoene

Kommandoene clone, pull, pushog init --environment alle snakker med et dataversmiljø, slik at de trenger en godkjenningsprofil. Logg på først med pac auth create.

• clone, pullog push krever en aktiv profil. pac copilot init trenger bare én når du passerer --environment, uten den, init stillasfiler lokalt og trenger ingen pålogging.
• pull og push les målmiljøet fra arbeidsområdets synkroniseringsmetadata, slik at de ikke tar et --environment argument. clone og init gjør det.
• pac copilot pack er rent lokalt. Den leser og skriver bare filer, så den trenger ingen godkjenning og ikke noe miljø.

pull og push arbeider bare i et arbeidsområde som er opprettet av clone eller init. Synkroniseringsmetadataene som skrives når arbeidsområdet opprettes, er det som forteller dem hvilken agent og miljø de skal snakke med, så det å kjøre dem andre steder mislykkes raskt med en feilmelding om at arbeidsområdet ikke blir funnet.

Se også

Microsoft Power Platform CLI-kommandogrupper
Microsoft Power Platform CLI-oversikt