pac copilot

Verktyg och verktyg för copilot-hantering.

Med initkommandona , clone, pull, pushoch pack kan du behålla en Copilot Studio agent som en uppsättning filer på disken, redigera den lokalt och synkronisera den med en Dataverse-miljö.

En typisk loop ser ut så här:

1. Starta en arbetsyta. Skapa en helt ny agent med pac copilot initeller ladda ned en befintlig med pac copilot clone. Hur som helst får du en lokal arbetsyta som innehåller synkroniseringsmetadata som de andra kommandona är beroende av.
2. Hämta innan du redigerar. pac copilot pull tar ned fjärrändringar och sammanfogar dem i dina lokala filer, så att du börjar från det aktuella servertillståndet.
3. Push-överför när du är klar. pac copilot push skickar tillbaka dina lokala ändringar. Om samma objekt har ändrats på servern under tiden stoppas push-överföringen och du uppmanas att hämta först.
4. Paket för distribution. pac copilot pack omvandlar en arbetsyta till en lösning .zip som du kan distribuera med pac solution import.

Om du vill gå från ingenting till en live-agent i ett enda steg, pac copilot init --environment skapar du ställningar, paket, importerar och ansluter arbetsytan åt dig. Med de enskilda kommandona kan du köra varje del av loopen på egen hand.

Commands

pac copilot clone

Klona en Copilot Studio agent till en lokal arbetsytekatalog.

pac copilot cloneladdar ned en befintlig Copilot Studio agent till en lokal arbetsytekatalog, tillsammans med de synkroniseringsmetadata som pac copilot pull och pac copilot push förlitar sig på. Agentens filer skrivs till en undermapp med namnet efter dess visningsnamn.

Example

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

Obligatoriska parametrar för copilot clone

--bot -id

Copilot-ID eller schemanamn (unikt namn finns i Robotinformation eller filnamn i Solution Explorer).

Valfria parametrar för copilot clone

--component-collection -cc

Komponentsamlings-ID som ska klonas. Upprepa för flera.

--display-name -dn

Visningsnamn för agenten (används för mappnamngivning).

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--output-dir -od

Rotmapp för kloningsutdata. Standardvärdet är aktuell katalog.

Remarks

• --botaccepterar ett Copilot-ID eller schemanamn. Skicka antingen Copilot-ID (ett GUID) eller agentens schemanamn. Kommandot löser ett schemanamn mot målmiljön.
• Målundermappen måste vara tom. Klona skrivningar till en mapp med namnet efter agentens (sanerade) visningsnamn under --output-dir. Om mappen redan innehåller filer stoppas klonen i stället för att skriva över dem. Använd --display-name för att välja ett annat mappnamn.
• Kloning av komponentsamlingar. Om du vill ta ned komponentsamlingar tillsammans med agenten skickar du ett eller flera samlings-ID:n med , avgränsade med --component-collectionsemikolon.
• Klon kräver en autentiserad profil (pac auth create) och löser miljön från --environment, eller från den aktiva profilens organisation när du utelämnar den.

pac copilot create

Skapar en ny andrepilot med en befintlig mallfil som referens.

Obligatoriska parametrar för copilot create

--displayName

Visningsnamnet för den nya andrepiloten

--schemaName

Schemanamnet (unikt namn) för den nya andrepiloten.

--solution -s

Namnet på lösningen.

--templateFileName

Yaml-källfil som innehåller den copilot-mall som extraherades med kommandot extract-template.

Valfria parametrar för copilot create

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac copilot delete

Ta bort en anpassad Copilot.

Obligatoriska parametrar för copilot delete

--bot -id

Copilot-ID eller schemanamn (unikt namn finns i Robotinformation eller filnamn i Solution Explorer).

Valfria parametrar för copilot delete

--confirm -y

Krävs för att bekräfta borttagningen av andrepiloten.

Den här parametern kräver inget värde. Det är en växel.

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac copilot extract-template

Extraherar en mallfil från en befintlig andrepilot i en miljö.

Example

Det här kommandot extraherar en mallfil från en befintlig andrepilot i en miljö.

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

Kommandot returnerar utdata som följande för en andrepilot med hjälp av de engelska och tyska språken:

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

Obligatoriska parametrar för copilot extract-template

--bot -id

Copilot-ID eller schemanamn (unikt namn finns i Robotinformation eller filnamn i Solution Explorer).

--templateFileName

Plats för yaml-filen som du vill skriva copilot-mallen till.

Valfria parametrar för copilot extract-template

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--overwrite -o

Tillåt överskrivning av utdatafilen om den redan finns.

Den här parametern kräver inget värde. Det är en växel.

--templateName

Mallnamn eller "kickStartTemplate" om namnet inte har angetts.

--templateVersion

Mallversion i X.X.X-format eller 1.0.0 om versionen inte har angetts.

pac copilot extract-translation

Extraherar en fil som innehåller lokaliserat innehåll för en eller flera robotar.

Example

Det här kommandot extraherar en fil som innehåller lokaliserat innehåll för en eller flera andrepiloter.

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

Kommandot returnerar utdata som följande:

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

Valfria parametrar för copilot extract-translation

--all -a

Skriv lokaliseringsfiler för alla språk som stöds. Som standard skrivs endast det primära språket.

Den här parametern kräver inget värde. Det är en växel.

--bot -id

Copilot-ID eller schemanamn (unikt namn finns i Robotinformation eller filnamn i Solution Explorer).

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--format

Filformatet där lokaliserade filer ska skrivas, antingen "resx" eller "json". Standardvärdet är "resx".

--outdir

Utdatakatalogen som du vill skriva till.

--overwrite -o

Tillåt överskrivning av utdatafilen om den redan finns.

Den här parametern kräver inget värde. Det är en växel.

--sourcedir -src

Källlösningskatalog. När du anger det ignoreras den anslutna miljön när du letar efter robotar och letar i stället efter innehåll i lösningsmappen.

pac copilot init

Skapa en ny Copilot Studio agentarbetsyta från en mall.

pac copilot initskapar en ny Copilot Studio agentarbetsyta från en mall. Den körs i ett av två lägen och förekomsten av --environment avgör vilket läge som ska användas:

• Lokal byggnadsställning – nej --environment. Skriver mallfilerna till projektkatalogen och stoppar. Kommandot skapar inget i Dataverse och kräver inte inloggning. Använd det här läget när du vill skapa lokalt och ansluta till en miljö senare.
• Bootstrap – --environment medföljer. Autogenerera filerna, paketera dem i en lösning, importerar lösningen till miljön och ansluter arbetsytan till den nyligen skapade agenten. Det här läget är en steg-sökväg från ingenting till en live-, synkroniseringsklar agent och kräver en autentiserad profil.

Exempel

Skapa en arbetsyta lokalt:

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

Scaffold och bootstrap en live-agent i en miljö i ett enda steg:

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

Skapa en CLI-redigerad agent (CliCopilot) i en specifik mapp:

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

Obligatoriska parametrar för copilot init

--name -n

Agentens visningsnamn.

--publisher-prefix -pp

Publisher anpassningsprefix för lösningen.

Valfria parametrar för copilot init

--authoring-mode -am

Agentredigeringsformen till scaffold (standard: 'klassisk'). Använd "cli-copilot" för att skapa en CLI-redigerad CliCopilot-agent.

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--instructions -ins

Instruktioner för agentsystem.

--project-dir -pd

Målkatalog för agentarbetsytan. Standardvärdet är aktuell katalog.

--schema-name -sn

Fullständigt agentschemanamn. Åsidosätter standardhärledning ({publisher-prefix}_{sanitized-name}). Används as-is utan ändringar.

--template -t

Mallprofilnamn (standard, minimalt). Standardvärdet är "standard".

Remarks

• Projektkatalogen måste vara tom. init inte autogenerera över befintliga filer, så peka på --project-dir en ny eller tom mapp.
• Schemanamnshärledning. När du utelämnar --schema-nameskapas agentschemanamnet som {publisher-prefix}_{sanitized-name}. Skicka --schema-name för att ange det explicit. Värdet används as-is.
• Bootstrap fungerar för båda redigeringslägena. init --environment bootstraps en live-agent i ett steg för det klassiska standardläget och för --authoring-mode cli-copilot. Som ett alternativ för en CliCopilot-agent kan du skapa en byggnadsställning lokalt (nej) --environmentoch sedan köra pac copilot pack följt av pac solution import för att distribuera den själv.
• Bootstrap skapar objekt på serversidan. I bootstrap-läge init importerar du en lösning och skapar agenten i målmiljön. Om det redan finns init en agent med samma schemanamn stoppar och pekar du på att pac copilot clone ansluta till den befintliga agenten i stället.
• En helt ny miljö kan ta lång tid att acceptera den första importen. En nyskapade miljö kan ta en minut eller två att värma upp. En tidig bootstrap kan misslyckas med "Async-åtgärder är för närvarande inaktiverade för den här organisationen". Vänta en stund och kör den igen.
• --template (default eller minimal) gäller endast för det klassiska redigeringsläget.

pac copilot list

Lista över andrepiloter i den aktuella eller målbaserade Dataverse-miljön.

Example

Det här kommandot visar alla andrepiloter i den aktuella dataversummiljön eller målmiljön.

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

Kommandot returnerar utdata som följande:

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

Valfria parametrar för copilot list

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac copilot mcp

Information om den lokala MCP-servern (Model Context Protocol).

Example

pac copilot mcp --run

Valfria parametrar för copilot mcp

--run -r

Kör den lokala MCP-servern (Model Context Protocol).

Den här parametern kräver inget värde. Det är en växel.

Remarks

Lär dig hur du använder Power Platform CLI med inbyggd MCP-server

pac copilot merge-translation

Sammanfoga filer som innehåller lokaliserat innehåll för en eller flera robotar.

Example

Det här kommandot sammanfogar filer som innehåller lokaliserat innehåll för en eller flera andrepiloter.

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

Kommandot returnerar utdata som följande när du uppdaterar det tyska 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.

Lär dig hur du hanterar fel från kommandot merge-translation

Valfria parametrar för copilot merge-translation

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--file -f

Listan över filer som innehåller översättningar. Globmönster stöds.

--solution -s

Namnet på lösningen.

--sourcedir -src

Källlösningskatalog. När du anger det ignoreras den anslutna miljön när du letar efter robotar och letar i stället efter innehåll i lösningsmappen.

--verbose

Mata ut mer diagnostikinformation under dataimport/export

Den här parametern kräver inget värde. Det är en växel.

--whatif

Kör inte kommandot, men visar information om vad som skulle hända.

Den här parametern kräver inget värde. Det är en växel.

sammanslagningsöversättningsfel

Baserat på exemplet ovan ser utdata ut så här om det finns ett fel i filen som används för att uppdatera andrepiloten:

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.

Flaggan --verbose lägger till information om felet:

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 den aktuella miljön.

Example

Det här kommandot visar alla AI Builder-modeller.

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

Kommandot returnerar utdata som följande:

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

Valfria parametrar för copilot model list

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac copilot model predict

Skickar text eller fråga till AI Model

Valfria parametrar för copilot model predict

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

--model-id -id

AI Builder-modell-ID

--model-name -n

Fullständigt eller partiellt AI-modellnamn

--prompt -p

Fråga om att skicka till AI-modell

--text -t

Text som ska skickas till AI Model

pac copilot model prepare-fetch

Tar FetchXML-filen från AI Large Language Model (LLM) och förbereder den för körning mot den aktuella miljön.

Obligatoriska parametrar för copilot model prepare-fetch

--inputFile -i

Indata för FetchXML-fil som vanligtvis kommer från AI LLM.

--outputFile -o

Utdata för FetchXML-fil som är redo att köras mot den aktuella miljön.

Valfria parametrar för copilot model prepare-fetch

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac copilot pack

Paketera en Copilot Studio agentarbetsyta i en zip-lösningsfil.

pac copilot pack paketerar en agentarbetsyta i en Dataverse-lösning .zip som du kan distribuera med pac solution import. Det är den fristående formen av paketeringssteget som pac copilot init --environment körs åt dig, så du kan skapa den distributionsbara lösningen som ett separat steg , till exempel i en bygg-pipeline. Det fungerar för både klassiska och CLI-redigerade (CliCopilot) agentarbetsytor.

Example

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

Obligatoriska parametrar för copilot pack

--publisher-prefix -pp

Publisher anpassningsprefix för lösningen.

Valfria parametrar för copilot pack

--output-path -op

Utdatasökväg för zip-lösningens fil. Standardvärdet är aktuell katalog.

--project-dir -pd

Agentarbetsytans katalog att paketera. Standardvärdet är aktuell katalog.

--solution-name -sn

Unikt namn på lösningen. Om det utelämnas härleds från agentschemanamnet.

Remarks

• Det är en lokal åtgärd. Pack läser arbetsytan och skriver en lösning .zip. Den behöver ingen autentisering och ingen miljö, så det är säkert att köra i en bygg-pipeline.
• Utgivarprefixet måste vara giltigt. --publisher-prefix måste vara ett välformat anpassningsprefix, eller så stoppas paketet innan något skrivs.
• Lösningsnamn och utdata. Om du utelämnar --solution-namehärleds lösningens unika namn från agentschemanamnet. .zip Skrivs till den aktuella katalogen om du inte anger --output-path.
• Paketet distribueras inte. Den skapar lösningen men importerar den inte. Följ den med pac solution import för att distribuera agenten och pac copilot clone om du vill ha en synkroniseringsansluten arbetsyta för den.

pac copilot publish

Publicera en anpassad Copilot

Obligatoriska parametrar för copilot publish

--bot -id

Copilot-ID eller schemanamn (unikt namn finns i Robotinformation eller filnamn i Solution Explorer).

Valfria parametrar för copilot publish

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

pac copilot pull

Hämta fjärrändringar från Copilot Studio och slå samman med den lokala arbetsytan.

Kommandot pac copilot pull hämtar agentens aktuella servertillstånd och sammanfogar det till din lokala arbetsyta med hjälp av en trevägssammanslagning. Den här processen säkerställer att redigeringar på serversidan och dina orörda lokala filer förblir intakta. Kör den innan du börjar redigera och kör den igen innan du push-överför ändringarna.

Example

Kör kommandot inifrån arbetsytans mapp:

pac copilot pull

Eller peka den på en arbetsyta någon annanstans på disken:

pac copilot pull --project-dir contoso-support

Valfria parametrar för copilot pull

--project-dir -pd

Sökväg till projektkatalogen. Standardvärdet är den aktuella arbetskatalogen.

Remarks

• Kör den i en synkroniseringsarbetsyta. Kommandot pull fungerar endast i en mapp som skapats av pac copilot clone eller pac copilot init. Den läser målmiljön och agenten från arbetsytans synkroniseringsmetadata, vilket är anledningen till att det inte finns något --environment argument. Om du kör den någon annanstans misslyckas den med felet "arbetsytan hittades inte".
• Den skriver till dina lokala filer. Dra samman fjärrändringar till arbetsytan och hämtar kunskapsfiler. Genomför eller säkerhetskopiera lokalt arbete som du bryr dig om innan du drar.
• Logga in först med pac auth create.

pac copilot push

Skicka ändringar i den lokala arbetsytan till Copilot Studio.

pac copilot push skickar ändringarna i din lokala arbetsyta tillbaka till agenten i Dataverse. Den jämför dina filer med det senast kända servertillståndet, laddar bara upp det som har ändrats – inklusive kunskapsfiler, molnflöden och anslutningsreferenser – och rapporterar vad de push-överförde.

Example

Kör den inifrån arbetsytans mapp:

pac copilot push

Eller peka den på en arbetsyta någon annanstans på disken:

pac copilot push --project-dir contoso-support

Valfria parametrar för copilot push

--project-dir -pd

Sökväg till projektkatalogen. Standardvärdet är den aktuella arbetskatalogen.

Remarks

• Kör den i en synkroniseringsarbetsyta. Som pullfungerar push bara i en mapp som skapats av pac copilot clone eller pac copilot init. Den läser målmiljön från arbetsytans synkroniseringsmetadata. Det finns inget --environment argument.
• Hämta först om det finns en konflikt. Om samma objekt har ändrats både lokalt och på servern stoppas push-överföring och du uppmanas att köra pac copilot pull innan du försöker igen. Den här processen hindrar en push-överföring från att tyst skriva över en ändring på serversidan som du inte såg.
• Inga lokala ändringar är en no-op. Om push inte hittar något att skicka, rapporterar det det och avslutas utan att röra miljön.
• En lyckad push muterar liveagenten i målmiljön.
• Logga in först med pac auth create.

pac copilot quarantine

Karantänstatus för copilot-agenten.

Obligatoriska parametrar för copilot quarantine

--bot-id -id

ID:t på andrepiloten för karantän/avkarantän.

Valfria parametrar för copilot quarantine

--environment -env

Miljö (ID, organisations-ID, URL, unikt namn eller partiellt namn).

--status -s

Karantänstatusvärde. Sant = karantän, falskt = icke-karantän. Standardinställningen är true.

Den här parametern kräver inget värde. Det är en växel.

pac copilot status

Avsök distributionsstatusen för en angiven andrepilot i den aktuella Dataverse-miljön eller målmiljön.

Example

Det här kommandot avsöker distributionsstatusen för en angiven andrepilot i den aktuella Dataverse-miljön eller målmiljön.

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

Kommandot returnerar utdata som följande:

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

Obligatoriska parametrar för copilot status

--bot-id -id

ID för en andrepilot (Chatbot).

Valfria parametrar för copilot status

--environment -env

Anger måldataversum. Värdet kan vara en GUID- eller absolut https-URL. När det inte anges används den aktiva organisation som valts för den aktuella autentiseringsprofilen.

Autentisering och miljö för synkroniseringskommandona

Kommandona clone, pull, pushoch init --environment pratar alla med en Dataverse-miljö, så de behöver en autentiseringsprofil. Logga in först med pac auth create.

• clone, pulloch push kräver en aktiv profil. pac copilot init behöver bara en när du skickar --environment– utan den init skapar du filer lokalt och behöver ingen inloggning.
• pull och push läsa målmiljön från arbetsytans synkroniseringsmetadata, så att de inte tar ett --environment argument. clone och init gör.
• pac copilot pack är helt lokal. Den läser och skriver endast filer, så den behöver ingen autentisering och ingen miljö.

pull och push fungerar bara i en arbetsyta som skapats av clone eller init. Synkroniseringsmetadata som skrivs när arbetsytan skapas är det som talar om för dem vilken agent och miljö de ska prata med, så att köra dem någon annanstans misslyckas snabbt med felet "arbetsytan hittades inte".

Se även

Microsoft Power Platform CLI-kommandogrupper
Microsoft Power Platform CLI-översikt