Delen via


pac copilot

Hulpprogramma's en hulpprogramma's voor copilot-beheer

Commands

Command Description
pac copilot maken Hiermee maakt u een nieuwe copilot met behulp van een bestaand sjabloonbestand als referentie.
pac copilot extract-template Extraheert een sjabloonbestand uit een bestaande copilot in een omgeving.
pac copilot extract-translation Extraheert het bestand met gelokaliseerde inhoud voor een of meer bots.
pac copilot-lijst Lijst met copilots in de huidige of doel-Dataverse-omgeving.
pac copilot mcp Informatie over de lokale MCP-server (Model Context Protocol).
pac copilot merge-translation Bestanden met gelokaliseerde inhoud voor een of meer bots samenvoegen.
pac copilot-modellijst AI Builder-modellen in de huidige omgeving.
pac copilot-model voorspellen Tekst of prompt verzenden naar AI-model
pac copilot-model prepare-fetch Neemt het FetchXML-bestand uit het AI Large Language Model (LLM) en bereidt het voor op uitvoering op basis van de huidige omgeving.
pac copilot publish Een aangepaste Copilot publiceren
pac copilot-status Peil de implementatiestatus van een opgegeven copilot in de huidige of doel-Dataverse-omgeving.

pac copilot maken

Hiermee maakt u een nieuwe copilot met behulp van een bestaand sjabloonbestand als referentie.

Vereiste parameters voor copilot maken

--displayName

De weergavenaam van de nieuwe copilot

--schemaName

De schemanaam (unieke naam) van de nieuwe copilot.

--solution -s

Naam van de oplossing.

--templateFileName

Bron-YAML-bestand met de copilot-sjabloon die is geëxtraheerd met behulp van de opdracht extract-template.

Optionele parameters voor copilot maken

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot extract-template

Extraheert een sjabloonbestand uit een bestaande copilot in een omgeving.

Example

Met deze opdracht wordt een sjabloonbestand uit een bestaande copilot in een omgeving geëxtraheerd.

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

De opdracht retourneert uitvoer zoals de volgende voor een copilot met behulp van de Engelse en Duitse talen:

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

Vereiste parameters voor copilot-extract-template

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

--templateFileName

Locatie van het yaml-bestand om de copilot-sjabloon naar te schrijven.

Optionele parameters voor copilot-extract-template

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--overwrite -o

Overschrijven van het uitvoergegevensbestand toestaan als dit al bestaat.

Voor deze parameter is geen waarde vereist. Het is een switch.

--templateName

Sjabloonnaam of kickStartTemplate als de naam niet is opgegeven.

--templateVersion

Sjabloonversie in X.X.X-indeling of 1.0.0 als versie niet is opgegeven.

pac copilot extract-translation

Extraheert het bestand met gelokaliseerde inhoud voor een of meer bots.

Example

Met deze opdracht wordt een bestand met gelokaliseerde inhoud geëxtraheerd voor een of meer copilots.

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

De opdracht retourneert uitvoer zoals hieronder:

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

Optionele parameters voor copilot extract-translation

--all -a

Lokalisatiebestanden schrijven voor alle ondersteunde talen. Standaard wordt alleen de primaire taal geschreven.

Voor deze parameter is geen waarde vereist. Het is een switch.

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--format

De bestandsindeling waarin gelokaliseerde bestanden moeten worden geschreven, 'resx' of 'json'. De standaardwaarde is 'resx'.

--outdir

De uitvoermap waar naar moet worden geschreven.

--overwrite -o

Overschrijven van het uitvoergegevensbestand toestaan als dit al bestaat.

Voor deze parameter is geen waarde vereist. Het is een switch.

--sourcedir -src

Bronoplossingsmap. Wanneer deze is opgegeven, negeert u de verbonden omgeving wanneer u op zoek bent naar bots en zoekt u in plaats daarvan naar inhoud in de oplossingsmap.

pac copilot-lijst

Lijst met copilots in de huidige of doel-Dataverse-omgeving.

Example

Met deze opdracht worden alle copiloten in de huidige of doel-Dataverse-omgeving weergegeven.

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

De opdracht retourneert uitvoer zoals hieronder:

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

Optionele parameters voor copilot-lijst

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot mcp

Informatie over de lokale MCP-server (Model Context Protocol).

Optionele parameters voor copilot mcp

--run -r

Voer de lokale MCP-server (Model Context Protocol) uit.

Voor deze parameter is geen waarde vereist. Het is een switch.

pac copilot merge-translation

Bestanden met gelokaliseerde inhoud voor een of meer bots samenvoegen.

Example

Met deze opdracht worden bestanden met gelokaliseerde inhoud samengevoegd voor een of meer copilots.

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

De opdracht retourneert uitvoer als de volgende bij het bijwerken van de Duitse taal:

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.

Meer informatie over het beheren van fouten met de opdracht merge-translation

Optionele parameters voor copilot merge-translation

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--file -f

De lijst met bestanden die vertalingen bevatten. Glob-patronen worden ondersteund.

--solution -s

Naam van de oplossing.

--sourcedir -src

Bronoplossingsmap. Wanneer deze is opgegeven, negeert u de verbonden omgeving wanneer u op zoek bent naar bots en zoekt u in plaats daarvan naar inhoud in de oplossingsmap.

--verbose

Meer diagnostische informatie uitvoeren tijdens het importeren/exporteren van gegevens

Voor deze parameter is geen waarde vereist. Het is een switch.

--whatif

Voert de opdracht niet uit, maar voert de details uit van wat er zou gebeuren.

Voor deze parameter is geen waarde vereist. Het is een switch.

samenvoegingsfouten

Als in het bovenstaande voorbeeld één fout voorkomt in het bestand dat wordt gebruikt om de copilot bij te werken, ziet de uitvoer er als volgt uit:

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.

Met --verbose de vlag worden details over de fout toegevoegd:

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

AI Builder-modellen in de huidige omgeving.

Example

Met deze opdracht worden alle AI Builder-modellen weergegeven.

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

De opdracht retourneert uitvoer zoals hieronder:

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

Optionele parameters voor copilot-modellijst

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot-model voorspellen

Tekst of prompt verzenden naar AI-model

Optionele parameters voor copilot-model voorspellen

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

--model-id -id

Ai Builder-model-id

--model-name -n

Volledige of gedeeltelijke naam van AI-model

--prompt -p

Vragen om te verzenden naar AI-model

--text -t

Tekst die moet worden verzonden naar AI-model

pac copilot-model prepare-fetch

Neemt het FetchXML-bestand uit het AI Large Language Model (LLM) en bereidt het voor op uitvoering op basis van de huidige omgeving.

Vereiste parameters voor het voorbereiden en ophalen van copilot-modellen

--inputFile -i

Invoer fetchXML-bestand dat meestal afkomstig is van AI LLM.

--outputFile -o

Output FetchXML-bestand dat gereed is voor uitvoering op basis van de huidige omgeving.

Optionele parameters voor copilot-model voorbereiden-ophalen

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot publish

Een aangepaste Copilot publiceren

Vereiste parameters voor copilot-publicatie

--bot -id

De Copilot-id of schemanaam (unieke naam gevonden in Bot Details of bestandsnaam in Solution Explorer).

Optionele parameters voor copilot publiceren

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

pac copilot-status

Peil de implementatiestatus van een opgegeven copilot in de huidige of doel-Dataverse-omgeving.

Example

Met deze opdracht wordt de implementatiestatus van een opgegeven copilot in de huidige of doel-Dataverse-omgeving gecontroleerd.

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

De opdracht retourneert uitvoer zoals hieronder:

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

Vereiste parameters voor copilot-status

--bot-id -id

De id van een copilot (chatbot).

Optionele parameters voor copilot-status

--environment -env

Hiermee geeft u de doel Dataverse. De waarde kan een GUID- of absolute HTTPS-URL zijn. Wanneer dit niet is opgegeven, wordt de actieve organisatie gebruikt die is geselecteerd voor het huidige verificatieprofiel.

Zie ook

Microsoft Power Platform CLI-opdrachtgroepen
Overzicht van Microsoft Power Platform CLI