pac copilot

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

Kommandoer

Command Description
pac copilot create Opretter en ny andenpilot ved hjælp af en eksisterende skabelonfil som reference.
pac copilot extract-template Udtrækker en skabelonfil fra en eksisterende copilot i et miljø.
pac copilot extract-translation Udtrækker fil, der indeholder lokaliseret indhold til en eller flere robotter.
pac copilot init-skills Udpak filer med copilot-kompetencedefinitioner til den aktuelle mappe.
pac copilot list Liste over medpiloter i det aktuelle dataverse-miljø eller målmiljøet.
pac copilot mcp Oplysninger om lokal MCP-server (Model Context Protocol).
pac copilot merge-translation Flet filer, der indeholder lokaliseret indhold for en eller flere robotter.
pac copilot model list AI Builder-modeller i det aktuelle miljø.
pac copilot model predict Sender tekst eller prompt 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ø.
pac copilot publish Udgiv en brugerdefineret copilot
pac copilot status Polling udrulningsstatus for en angivet copilot i det aktuelle Dataverse-miljø eller målmiljøet.

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 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-skills

Udpak filer med copilot-kompetencedefinitioner til den aktuelle mappe.

Valgfrie parametre for copilot init-skills

--output -o

Outputmappe til kompetencefiler. Standard: .github/skills

--skills -s

Kommasepareret liste over kompetencenavne (navne på navneord på øverste niveau), der skal kopieres, f.eks. administrator, godkendelse. Standard: alle færdigheder.

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.

Bemærkninger

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 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 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.

Se også

Kommandolinjekommandogrupper for Microsoft Power Platform
Oversigt over kommandolinjegrænsefladen til Microsoft Power Platform