pac copilot

Værktøjer og hjælpeprogrammer til administration af andenpiloter.

Med initkommandoerne , clonepull, pushog pack kan du beholde en Copilot Studio agent som et sæt filer på disken, redigere den lokalt og synkronisere den med et Dataverse-miljø.

En typisk løkke ser sådan ud:

1. Start et arbejdsområde. Stillads en helt ny agent med pac copilot init, eller download en eksisterende med pac copilot clone. Uanset hvad du får et lokalt arbejdsområde, der bærer synkroniseringsmetadata, afhænger de andre kommandoer af.
2. Træk, før du redigerer. pac copilot pull fjerner ændringer og fletter dem til dine lokale filer, så du starter fra den aktuelle servertilstand.
3. Tryk, når du er færdig. pac copilot push sender dine lokale ændringer tilbage. Hvis det samme element er ændret på serveren i mellemtiden, push stopper og beder dig om at trække først.
4. Pakke til installation. pac copilot pack omdanner et arbejdsområde til en løsning .zip , du kan installere med pac solution import.

Hvis du vil gå fra ingenting til en liveagent i et enkelt trin, pac copilot init --environment skal du oprette stilladser, pakker, importerer og forbinder arbejdsområdet for dig. Med de enkelte kommandoer kan du køre hver del af løkken på egen hånd.

Kommandoer

pac copilot clone

Klon en Copilot Studio agent til en lokal arbejdsområdemappe.

pac copilot clonedownloader en eksisterende Copilot Studio agent til en lokal arbejdsområdemappe sammen med de synkroniseringsmetadata, der pac copilot pull er pac copilot push afhængige af. Agentens filer skrives til en undermappe, der er navngivet efter dens viste navn.

Eksempel

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

Obligatoriske parametre for copilot clone

--bot -id

Copilot-id'et eller skemanavnet (entydigt navn, der findes i Bot Details eller filnavnet i Løsningsoversigt).

Valgfrie parametre for copilot clone

--component-collection -cc

Komponentsamlings-id, der skal klones. Gentag for flere.

--display-name -dn

Vist navn på agenten (bruges til navngivning af mapper).

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

--output-dir -od

Rodmappe til klonoutput. Som standard den aktuelle mappe.

Remarks

• --botaccepterer et Copilot id eller skemanavn. Overfør enten Copilot-id'et (et GUID) eller agentens skemanavn. Kommandoen fortolker et skemanavn i forhold til destinationsmiljøet.
• Destinationsundermappen skal være tom. Klon skriver til en mappe med navnet efter agentens (rensede) viste navn under --output-dir. Hvis mappen allerede indeholder filer, stopper klonen i stedet for at overskrive dem. Bruges --display-name til at vælge et andet mappenavn.
• Kloning af komponentsamlinger. Hvis du vil fjerne komponentsamlinger sammen med agenten, skal du overføre et eller flere samlings-id'er med --component-collectionadskilt af semikolon.
• Klon kræver en godkendt profil (pac auth create) og løser miljøet fra --environmenteller fra den aktive profils organisation, når du udelader den.

pac copilot create

Opretter en ny andenpilot ved hjælp af en eksisterende skabelonfil som reference.

Obligatoriske parametre for copilot create

--displayName

Det viste navn på den nye copilot

--schemaName

Skemanavnet (entydigt navn) på den nye copilot.

--solution -s

Navnet på løsningen.

--templateFileName

Kilde yaml-fil, der indeholder den copilotskabelon, der blev udpakket ved hjælp af kommandoen extract-template.

Valgfrie parametre for copilot create

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

pac copilot delete

Slet en brugerdefineret Copilot.

Obligatoriske parametre for copilot delete

--bot -id

Copilot-id'et eller skemanavnet (entydigt navn, der findes i Bot Details eller filnavnet i Løsningsoversigt).

Valgfrie parametre for copilot delete

--confirm -y

Påkrævet for at bekræfte sletning af andenpiloten.

Denne parameter kræver ingen værdi. Det er en kontakt.

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

pac copilot extract-template

Udtrækker en skabelonfil fra en eksisterende copilot i et miljø.

Eksempel

Denne kommando udtrækker en skabelonfil 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 output som følgende for en copilot ved hjælp af de engelske og tyske sprog:

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 parametre for copilot extract-template

--bot -id

Copilot-id'et eller skemanavnet (entydigt navn, der findes i Bot Details eller filnavnet i Løsningsoversigt).

--templateFileName

Placering af yaml-filen, som copilotskabelonen skal skrives til.

Valgfrie parametre for copilot extract-template

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

--overwrite -o

Tillad overskrivning af outputdatafilen, hvis den allerede findes.

Denne parameter kræver ingen værdi. Det er en kontakt.

--templateName

Skabelonnavn eller 'kickStartTemplate', hvis navnet ikke er angivet.

--templateVersion

Skabelonversion i X.X.X-format eller 1.0.0, hvis version ikke er angivet.

pac copilot extract-translation

Udtrækker fil, der indeholder lokaliseret indhold til en eller flere robotter.

Eksempel

Denne kommando udtrækker en fil, der indeholder lokaliseret indhold til en eller flere copiloter.

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

Kommandoen returnerer output på følgende måde:

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 parametre for copilot extract-translation

--all -a

Skriv lokaliseringsfiler til alle understøttede sprog. Som standard er det kun det primære sprog, der skrives.

Denne parameter kræver ingen værdi. Det er en kontakt.

--bot -id

Copilot-id'et eller skemanavnet (entydigt navn, der findes i Bot Details eller filnavnet i Løsningsoversigt).

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

--format

Det filformat, som oversatte filer skal skrives i, enten 'resx' eller 'json'. Standarden er 'resx'.

--outdir

Den outputmappe, der skal skrives til.

--overwrite -o

Tillad overskrivning af outputdatafilen, hvis den allerede findes.

Denne parameter kræver ingen værdi. Det er en kontakt.

--sourcedir -src

Kildeløsningsmappe. Når det er angivet, ignoreres det forbundne miljø, når der søges efter robotter, og søger i stedet efter indhold i løsningsmappen.

pac copilot init

Opret et nyt Copilot Studio agentarbejdsområde ud fra en skabelon.

pac copilot initstilladser et nyt Copilot Studio agentarbejdsområde fra en skabelon. Den kører i en af to tilstande, og tilstedeværelsen af --environment beslutter, hvilken tilstand der skal bruges:

• Lokalt stillads – nej --environment. Skriver skabelonfilerne til projektmappen og stopper. Kommandoen opretter ikke noget i Dataverse og kræver ikke logon. Brug denne tilstand, når du vil oprette lokalt og oprette forbindelse til et miljø senere.
• Bootstrap – --environment angivet. Stilladser filerne, pakker dem til en løsning, importerer denne løsning i miljøet og opretter forbindelse mellem arbejdsområdet og den nyoprettede agent. Denne tilstand er ettrinsstien fra intet til en live agent, der er klar til synkronisering, og den kræver en godkendt profil.

Eksempler

Stillads for et lokalt arbejdsområde:

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

Stillads og bootstrap en live agent i et miljø i et enkelt trin:

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

Stillads en CLI-forfattet agent (CliCopilot) til en bestemt mappe:

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

Obligatoriske parametre for copilot init

--name -n

Agentens viste navn.

--publisher-prefix -pp

Publisher tilpasningspræfiks for løsningen.

Valgfrie parametre for copilot init

--authoring-mode -am

Agenten opretter figuren til et stillads (standard: 'klassisk'). Brug 'cli-copilot' til at stilladse en CLI-forfattet CliCopilot-agent.

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

--instructions -ins

Agentsysteminstruktioner.

--project-dir -pd

Destinationsmappen for agentarbejdsområdet. Som standard den aktuelle mappe.

--schema-name -sn

Navn på full agent-skema. Tilsidesætter standardafledning ({publisher-præfiks}_{sanitized-name}). Bruges as-is uden ændring.

--template -t

Skabelonprofilnavn (standard, minimal). Standard er som standard.

Remarks

• Projektmappen skal være tom. init ændrer ikke eksisterende filer, så peg på --project-dir en ny eller tom mappe.
• Afledning af skemanavn. Når du udelader --schema-name, oprettes agentskemanavnet som {publisher-prefix}_{sanitized-name}. Send --schema-name for at angive den eksplicit. Værdien bruges as-is.
• Bootstrap fungerer for begge oprettelsestilstande. init --environment bootstraps en live agent i ét trin for standardklassikertilstanden og for --authoring-mode cli-copilot. Som et alternativ til en CliCopilot-agent kan du stilladset lokalt (nej --environment) og derefter køre pac copilot pack efterfulgt af pac solution import for selv at udrulle det.
• Bootstrap opretter objekter på serversiden. I bootstrap-tilstand init importerer du en løsning og opretter agenten i destinationsmiljøet. Hvis der allerede findes en agent med det samme skemanavn, init stopper og peger du i stedet på at pac copilot clone oprette forbindelse til den eksisterende agent.
• Et helt nyt miljø kan være langsomt at acceptere den første import. Et nyoprettet miljø kan tage et minut eller to at varme op. En tidlig bootstrap kan mislykkes med "Asynkrone handlinger er i øjeblikket deaktiveret for denne organisation." Vent et øjeblik, og kør det igen.
• --template (default eller minimal) gælder kun for den klassiske oprettelsestilstand.

pac copilot list

Liste over medpiloter i det aktuelle dataverse-miljø eller målmiljøet.

Eksempel

Denne kommando viser alle copiloter i det aktuelle dataverse- eller destinationsmiljø.

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

Kommandoen returnerer output på følgende måde:

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 parametre for copilot list

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

pac copilot mcp

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

Eksempel

pac copilot mcp --run

Valgfrie parametre for copilot mcp

--run -r

Kør den lokale MCP-server (Model Context Protocol).

Denne parameter kræver ingen værdi. Det er en kontakt.

Remarks

Få mere at vide om, hvordan du bruger kommandolinjegrænsefladen i Power Platform med en indbygget MCP-server

pac copilot merge-translation

Flet filer, der indeholder lokaliseret indhold for en eller flere robotter.

Eksempel

Denne kommando fletter filer, der indeholder lokaliseret indhold for en eller flere medpiloter.

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

Kommandoen returnerer output på følgende måde, når det tyske sprog opdateres:

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.

Få mere at vide om, hvordan du administrerer fejl fra kommandoen fletoversættelse

Valgfrie parametre for copilot merge-translation

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

--file -f

Listen over filer, der indeholder oversættelser. Globmønstre understøttes.

--solution -s

Navnet på løsningen.

--sourcedir -src

Kildeløsningsmappe. Når det er angivet, ignoreres det forbundne miljø, når der søges efter robotter, og søger i stedet efter indhold i løsningsmappen.

--verbose

Skriv flere diagnosticeringsoplysninger under import/eksport af data

Denne parameter kræver ingen værdi. Det er en kontakt.

--whatif

Udfører ikke kommandoen, men skriver detaljerne om, hvad der ville ske.

Denne parameter kræver ingen værdi. Det er en kontakt.

fejl i fletoversættelse

Hvis der findes en fejl i den fil, der bruges til at opdatere copiloten, ser outputtet ud på baggrund af ovenstående eksempel:

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.

Flaget --verbose tilføjer oplysninger om fejlen:

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 det aktuelle miljø.

Eksempel

Denne kommando viser alle AI Builder-modeller.

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

Kommandoen returnerer output på følgende måde:

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 parametre for copilot model list

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

pac copilot model predict

Sender tekst eller prompt til AI-model

Valgfrie parametre for copilot model predict

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

--model-id -id

AI Builder-model-id

--model-name -n

Navn på fuld eller delvis AI-model

--prompt -p

Spørg, om der skal sendes til AI-model

--text -t

Tekst, der skal sendes til AI-model

pac copilot model prepare-fetch

Henter FetchXML-filen fra LLM (AI Large Language Model) og forbereder den til udførelse i forhold til det aktuelle miljø.

Obligatoriske parametre for copilot model prepare-fetch

--inputFile -i

Input-FetchXML-fil, der normalt kommer fra AI LLM.

--outputFile -o

Output FetchXML-fil, der er klar til at blive udført i det aktuelle miljø.

Valgfrie parametre for copilot model prepare-fetch

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

pac copilot pack

Pak et Copilot Studio agentarbejdsområde til en zip-fil til en løsning.

pac copilot pack pakker et agentarbejdsområde i en Dataverse-løsning .zip , som du kan installere med pac solution import. Det er den separate form for pakningstrinnet, der pac copilot init --environment kører for dig, så du kan oprette den udrullelige løsning som et separat trin – f.eks. i en buildpipeline. Det fungerer for både klassiske og CLI-oprettede (CliCopilot) agentarbejdsområder.

Eksempel

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

Obligatoriske parametre for copilot pack

--publisher-prefix -pp

Publisher tilpasningspræfiks for løsningen.

Valgfrie parametre for copilot pack

--output-path -op

Outputsti til zip-filen til løsningen. Som standard den aktuelle mappe.

--project-dir -pd

Agentarbejdsområdemappe, der skal pakkes. Som standard den aktuelle mappe.

--solution-name -sn

Løsningens entydige navn. Hvis udeladt, afledt af agentskemanavnet.

Remarks

• Det er en lokal operation. Pack læser arbejdsområdet og skriver en løsning .zip. Den kræver ingen godkendelse og intet miljø, så det er sikkert at køre i en buildpipeline.
• Udgiverpræfikset skal være gyldigt. --publisher-prefix skal være et korrekt tilpasningspræfiks, eller pakken stopper, før du skriver noget.
• Løsningsnavn og -output. Hvis du udelader --solution-name, afledes løsningens entydige navn fra agentskemanavnet. .zip skrives til den aktuelle mappe, medmindre du angiver --output-path.
• Pakken udrulles ikke. Den producerer løsningen, men importerer den ikke. Følg den med pac solution import for at udrulle agenten, og hvis du vil pac copilot clone have et arbejdsområde, der er forbundet med synkronisering, for det.

pac copilot publish

Udgiv en brugerdefineret copilot

Obligatoriske parametre for copilot publish

--bot -id

Copilot-id'et eller skemanavnet (entydigt navn, der findes i Bot Details eller filnavnet i Løsningsoversigt).

Valgfrie parametre for copilot publish

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

pac copilot pull

Træk fjernændringer fra Copilot Studio, og flet med lokalt arbejdsområde.

Kommandoen pac copilot pull henter agentens aktuelle servertilstand og fletter den til dit lokale arbejdsområde ved hjælp af en trevejsfletning. Denne proces sikrer, at redigeringer på serversiden og dine urørte lokale filer forbliver intakte. Kør den, før du begynder at redigere, og kør den igen, før du overfører dine ændringer.

Eksempel

Kør kommandoen inde fra arbejdsområdemappen:

pac copilot pull

Eller peg på et arbejdsområde et andet sted på disken:

pac copilot pull --project-dir contoso-support

Valgfrie parametre for copilot pull

--project-dir -pd

Sti til projektmappen. Som standard den aktuelle arbejdsmappe.

Remarks

• Kør den i et synkroniseringsarbejdsområde. Kommandoen pull fungerer kun i en mappe, der er oprettet af pac copilot clone eller pac copilot init. Den læser destinationsmiljøet og -agenten fra arbejdsområdets synkroniseringsmetadata, hvilket er grunden til, at der ikke er noget --environment argument. Hvis du kører den andre steder, mislykkes den med fejlen "Arbejdsområde blev ikke fundet".
• Den skriver til dine lokale filer. Pull fletter fjernændringer i arbejdsområdet og downloader videnfiler. Bekræft eller sikkerhedskopiér lokalt arbejde, du holder af, før du trækker.
• Log på først med pac auth create.

pac copilot push

Send ændringer af lokalt arbejdsområde til Copilot Studio.

pac copilot push sender ændringerne i dit lokale arbejdsområde tilbage til agenten i Dataverse. Den sammenligner dine filer med den sidst kendte servertilstand, uploader kun det, der er ændret – herunder videnfiler, cloudflows og forbindelsesreferencer – og rapporterer, hvad det har pushet.

Eksempel

Kør den inde fra arbejdsområdemappen:

pac copilot push

Eller peg på et arbejdsområde et andet sted på disken:

pac copilot push --project-dir contoso-support

Valgfrie parametre for copilot push

--project-dir -pd

Sti til projektmappen. Som standard den aktuelle arbejdsmappe.

Remarks

• Kør den i et synkroniseringsarbejdsområde. push Ligesom pullfungerer kun i en mappe, der er oprettet af pac copilot clone eller pac copilot init. Det læser destinationsmiljøet fra arbejdsområdets synkroniseringsmetadata. Der er intet --environment argument.
• Træk først, hvis der er en konflikt. Hvis det samme element er ændret både lokalt og på serveren, stopper pushen, og du bliver bedt om at køre pac copilot pull , før du prøver igen. Denne proces afholder et push fra uovervåget at overskrive en ændring på serversiden, som du ikke kunne se.
• Ingen lokale ændringer er en no-op. Hvis push ikke finder noget at sende, rapporterer den, at og afsluttes uden at røre miljøet.
• En vellykket push-muterer liveagenten i destinationsmiljøet.
• Log på først med pac auth create.

pac copilot quarantine

Karantænestatus for co-pilot-agent.

Obligatoriske parametre for copilot quarantine

--bot-id -id

ID'et på co-piloten til karantæne/ud-karantæne.

Valgfrie parametre for copilot quarantine

--environment -env

Miljø (id, organisations-id, URL-adresse, entydigt navn eller delvist navn).

--status -s

Karantænestatusværdi. sandt = karantæne, falsk = ikke-karantæne. Som standard er sand.

Denne parameter kræver ingen værdi. Det er en kontakt.

pac copilot status

Polling udrulningsstatus for en angivet copilot i det aktuelle Dataverse-miljø eller målmiljøet.

Eksempel

Denne kommando forespørger installationsstatussen for en angivet copilot i det aktuelle Dataverse-miljø eller target-miljø.

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

Kommandoen returnerer output på følgende måde:

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 parametre for copilot status

--bot-id -id

Id'et for en copilot (Chatbot).

Valgfrie parametre for copilot status

--environment -env

Angiver måldataversen. Værdien kan være et GUID eller en absolut HTTPS URL-adresse. Når den ikke er angivet, bruges den aktive organisation, der er valgt til den aktuelle godkendelsesprofil.

Godkendelse og miljø for synkroniseringskommandoerne

Kommandoerne clone, pull, pushog init --environment taler alle med et Dataverse-miljø, så de har brug for en godkendelsesprofil. Log på først med pac auth create.

• clone, pullog push kræver en aktiv profil. pac copilot init skal kun bruge én, når du sender --environment, uden at det, init stilladsfiler lokalt og behøver ingen logon.
• pull og push læse målmiljøet fra arbejdsområdets synkroniseringsmetadata, så de ikke tager et --environment argument. clone og init gøre.
• pac copilot pack er udelukkende lokal. Den læser og skriver kun filer, så den behøver ingen godkendelse og intet miljø.

pull og push fungerer kun i et arbejdsområde, der er oprettet af clone eller init. De synkroniseringsmetadata, der skrives, når arbejdsområdet oprettes, fortæller dem, hvilken agent og hvilket miljø de skal tale med, så det mislykkes hurtigt at køre dem andre steder med fejlen "arbejdsområdet blev ikke fundet".

Se også

Microsoft Power Platform CLI-kommandogrupper
Microsoft Power Platform oversigt over kommandolinjegrænsefladen