Comparteix via

pac copilot

Eines i utilitats per a la gestió del copilot

Comandes

Ordre Descripció
pac copilot create Crea un copilot nou utilitzant un fitxer de plantilla existent com a referència.
pac copilot extract-template Extreu un fitxer de plantilla d'un copilot existent en un entorn.
pac copilot extract-translation Extreu el fitxer que conté contingut localitzat per a un o més bots.
pac copilot list Llista de copilots de l'entorn actual o de destinació del Dataverse.
pac copilot mcp Informació sobre el servidor local MCP (Model Context Protocol).
pac copilot merge-translation Combina fitxers que contenen contingut localitzat per a un o més bots.
pac copilot model list Models d'AI Builder en l'entorn actual.
pac copilot model predict Envia text o sol·licitud al model d'IA
pac copilot model prepare-fetch Pren el fitxer FetchXML del model de llenguatge gran (LLM) de l'IA i el prepara per a l'execució en l'entorn actual.
pac copilot publish Publicar un Copilot personalitzat
pac copilot status Sondeu l'estat d'implementació d'un copilot especificat a l'entorn actual o de destinació del Dataverse.

pac copilot create

Crea un copilot nou utilitzant un fitxer de plantilla existent com a referència.

Paràmetres requerits per a copilot create

--displayName

El nom de visualització del nou copilot

--schemaName

El nom de l'esquema (nom únic) del nou copilot.

--solution -s

Nom de la solució.

--templateFileName

Fitxer yaml d'origen que conté la plantilla copilot que s'ha extret mitjançant l'ordre extract-template.

Paràmetres opcionals per a copilot create

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot extract-template

Extreu un fitxer de plantilla d'un copilot existent en un entorn.

Exemple

Aquesta ordre extreu un fitxer de plantilla d'un copilot existent en un entorn.

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

L'ordre retorna una sortida com la següent per a un copilot que utilitza els idiomes anglès i alemany:

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

Paràmetres requerits per a copilot extract-template

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

--templateFileName

Ubicació del fitxer yaml on escriure la plantilla del copilot.

Paràmetres opcionals per a copilot extract-template

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--overwrite -o

Permet la sobreescriptura del fitxer de dades de sortida si ja existeix.

Aquest paràmetre no requereix cap valor. És un canvi.

--templateName

Nom de la plantilla o 'kickStartTemplate' si no s'especifica el nom.

--templateVersion

Versió de la plantilla en format X.X.X o 1.0.0 si no s'especifica la versió.

pac copilot extract-translation

Extreu el fitxer que conté contingut localitzat per a un o més bots.

Exemple

Aquesta ordre extreu un fitxer que conté contingut localitzat per a un o més copilots.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres opcionals per a copilot extract-translation

--all -a

Escriviu fitxers de localització per a tots els idiomes compatibles. Per defecte, només s'escriu l'idioma principal.

Aquest paràmetre no requereix cap valor. És un canvi.

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--format

El format de fitxer en el qual s'han d'escriure fitxers localitzats, ja sigui 'resx' o 'json'. El valor predeterminat és 'resx'.

--outdir

El directori de sortida on escriure.

--overwrite -o

Permet la sobreescriptura del fitxer de dades de sortida si ja existeix.

Aquest paràmetre no requereix cap valor. És un canvi.

--sourcedir -src

Directori de la solució d'origen. Quan s'especifiqui, ignorarà l'entorn connectat quan cerqui bots i, en canvi, buscarà contingut a la carpeta de la solució.

pac copilot list

Llista de copilots de l'entorn actual o de destinació del Dataverse.

Exemple

Aquesta ordre llista tots els copilots de l'entorn actual o de destinació del Dataverse.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres opcionals per a copilot list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot mcp

Informació sobre el servidor local MCP (Model Context Protocol).

Exemple

pac copilot mcp --run

Paràmetres opcionals per a copilot mcp

--run -r

Executa el servidor local MCP (Model Context Protocol).

Aquest paràmetre no requereix cap valor. És un canvi.

Observacions

Aprèn a utilitzar la CLI de Power Platform amb servidor MCP integrat

pac copilot merge-translation

Combina fitxers que contenen contingut localitzat per a un o més bots.

Exemple

Aquesta ordre combina fitxers que contenen contingut localitzat per a un o més copilots.

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

L'ordre retorna una sortida com la següent quan s'actualitza l'idioma alemany:

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.

Més informació sobre com gestionar els errors des de l'ordre merge-translation

Paràmetres opcionals per a copilot merge-translation

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--file -f

Llista de fitxers que contenen traduccions. S'admeten patrons globals.

--solution -s

Nom de la solució.

--sourcedir -src

Directori de la solució d'origen. Quan s'especifiqui, ignorarà l'entorn connectat quan cerqui bots i, en canvi, buscarà contingut a la carpeta de la solució.

--verbose

Genera més informació de diagnòstic durant la importació/exportació de dades

Aquest paràmetre no requereix cap valor. És un canvi.

--whatif

No executa l'ordre, sinó que mostra els detalls del que passaria.

Aquest paràmetre no requereix cap valor. És un canvi.

errors de fusió-traducció

Basant-se en l'exemple anterior, si hi ha un error al fitxer utilitzat per actualitzar el copilot, la sortida és així:

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.

L'indicador --verbose afegeix detalls sobre l'error:

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

Models d'AI Builder en l'entorn actual.

Exemple

Aquesta ordre enumera tots els models d'AI Builder.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres opcionals per a copilot model list

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot model predict

Envia text o sol·licitud al model d'IA

Paràmetres opcionals per a copilot model predict

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

--model-id -id

Identificador del model AI Builder

--model-name -n

Nom del model d'IA complet o parcial

--prompt -p

Sol·licitud d'enviament al model d'IA

--text -t

Text per enviar al model d'IA

pac copilot model prepare-fetch

Pren el fitxer FetchXML del model de llenguatge gran (LLM) de l'IA i el prepara per a l'execució en l'entorn actual.

Paràmetres requerits per a copilot model prepare-fetch

--inputFile -i

Introduïu el fitxer FetchXML que normalment prové d'AI LLM.

--outputFile -o

Sortida del fitxer FetchXML que està llest per executar-se en l'entorn actual.

Paràmetres opcionals per a copilot model prepare-fetch

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot publish

Publicar un Copilot personalitzat

Paràmetres requerits per a copilot publish

--bot -id

L'identificador del Copilot o el nom de l'esquema (nom únic que es troba als detalls del bot o nom del fitxer a l'explorador de solucions).

Paràmetres opcionals per a copilot publish

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

pac copilot status

Sondeu l'estat d'implementació d'un copilot especificat a l'entorn actual o de destinació del Dataverse.

Exemple

Aquesta ordre sondeja l'estat de desplegament d'un copilot especificat a l'entorn actual o de destinació del Dataverse.

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

L'ordre retorna una sortida com la següent:

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

Paràmetres requerits per a copilot status

--bot-id -id

L'identificador d'un copilot (Chatbot).

Paràmetres opcionals per a copilot status

--environment -env

Especifica el Dataverse de destinació. El valor pot ser un Guid o un URL https absolut. Quan no s'especifiqui, s'utilitzarà l'organització activa seleccionada per al perfil d'autenticació actual.

Vegeu també

Grups d'ordres de l'CLI del Microsoft Power Platform
Informació general de la CLI del Microsoft Power Platform

  • Last updated on