Compartilhar via

pac copilot

Ferramentas e utilitários para gerenciamento de copilot

Commands

Command Description
pac copilot create Cria um novo copilot usando um arquivo de modelo existente como referência.
pac copilot extract-template Extrai um arquivo de modelo de um copilot existente em um ambiente.
pac copilot extract-translation Extrai o arquivo que contém conteúdo localizado para um ou mais bots.
pac copilot list Lista de copilots no ambiente dataverse atual ou de destino.
pac copilot mcp Informações sobre o servidor MCP local (Protocolo de Contexto de Modelo).
pac copilot merge-translation Mesclar arquivos que contêm conteúdo localizado para um ou mais bots.
pac copilot model list Modelos do AI Builder no ambiente atual.
pac copilot model predict Envia texto ou prompt para o Modelo de IA
pac copilot modelo prepare-fetch Obtém o arquivo FetchXML do LLM (Modelo de Linguagem Grande) de IA e o prepara para execução no ambiente atual.
pac copilot publish Publicar um Copilot Personalizado
status do pac copilot Sondar o status de implantação de um copilot especificado no ambiente dataverse atual ou de destino.

pac copilot create

Cria um novo copilot usando um arquivo de modelo existente como referência.

Parâmetros necessários para criação de copilot

--displayName

O nome de exibição do novo copilot

--schemaName

O nome do esquema (nome exclusivo) do novo copilot.

--solution -s

Nome da solução.

--templateFileName

Arquivo yaml de origem que contém o modelo copilot que foi extraído usando o comando extract-template.

Parâmetros opcionais para criação de copilot

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac copilot extract-template

Extrai um arquivo de modelo de um copilot existente em um ambiente.

Example

Esse comando extrai um arquivo de modelo de um copilot existente em um ambiente.

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

O comando retorna uma saída semelhante à seguinte para um copilot usando os idiomas inglês e alemão:

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âmetros necessários para copilot extract-template

--bot -id

A ID do Copilot ou o nome do esquema (nome exclusivo encontrado em Detalhes do Bot ou nome do arquivo no gerenciador de soluções).

--templateFileName

Local do arquivo yaml para o qual gravar o modelo de copilot.

Parâmetros opcionais para copilot extract-template

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--overwrite -o

Permita a substituição do arquivo de dados de saída se ele já existir.

Esse parâmetro não requer nenhum valor. É um comutador.

--templateName

Nome do modelo ou 'kickStartTemplate' se o nome não for especificado.

--templateVersion

Versão do modelo no formato X.X.X ou 1.0.0 se a versão não for especificada.

pac copilot extract-translation

Extrai o arquivo que contém conteúdo localizado para um ou mais bots.

Example

Esse comando extrai um arquivo que contém conteúdo localizado para um ou mais copilots.

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

O comando retorna a saída da seguinte maneira:

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âmetros opcionais para extração-tradução de copilot

--all -a

Escreva arquivos de localização para todos os idiomas com suporte. Por padrão, somente o idioma primário é escrito.

Esse parâmetro não requer nenhum valor. É um comutador.

--bot -id

A ID do Copilot ou o nome do esquema (nome exclusivo encontrado em Detalhes do Bot ou nome do arquivo no gerenciador de soluções).

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--format

O formato de arquivo no qual gravar arquivos localizados, 'resx' ou 'json'. O padrão é 'resx'.

--outdir

O diretório de saída no qual gravar.

--overwrite -o

Permita a substituição do arquivo de dados de saída se ele já existir.

Esse parâmetro não requer nenhum valor. É um comutador.

--sourcedir -src

Diretório da solução de origem. Quando especificado, ignorará o ambiente conectado ao procurar bots e, em vez disso, procurará conteúdo na pasta da solução.

pac copilot list

Lista de copilots no ambiente dataverse atual ou de destino.

Example

Esse comando lista todos os copilots no ambiente dataverse atual ou de destino.

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

O comando retorna a saída da seguinte maneira:

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âmetros opcionais para a lista copilot

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac copilot mcp

Informações sobre o servidor MCP local (Protocolo de Contexto de Modelo).

Example

pac copilot mcp --run

Parâmetros opcionais para copilot mcp

--run -r

Execute o servidor MCP local (Protocolo de Contexto de Modelo).

Esse parâmetro não requer nenhum valor. É um comutador.

Observações

Saiba como usar a CLI do Power Platform com o servidor MCP interno

pac copilot merge-translation

Mesclar arquivos que contêm conteúdo localizado para um ou mais bots.

Example

Esse comando mescla arquivos que contêm conteúdo localizado para um ou mais copilots.

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

O comando retorna uma saída semelhante à seguinte ao atualizar o idioma alemão:

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.

Saiba mais sobre como gerenciar erros do comando de tradução de mesclagem

Parâmetros opcionais para conversão de mesclagem de copilot

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--file -f

A lista de arquivos que contêm traduções. Há suporte para padrões glob.

--solution -s

Nome da solução.

--sourcedir -src

Diretório da solução de origem. Quando especificado, ignorará o ambiente conectado ao procurar bots e, em vez disso, procurará conteúdo na pasta da solução.

--verbose

Gerar mais informações de diagnóstico durante a importação/exportação de dados

Esse parâmetro não requer nenhum valor. É um comutador.

--whatif

Não executa o comando, mas gera os detalhes do que aconteceria.

Esse parâmetro não requer nenhum valor. É um comutador.

erros de conversão de mesclagem

Com base no exemplo acima, se houver um erro no arquivo usado para atualizar o copilot, a saída será semelhante a:

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.

O --verbose sinalizador adiciona detalhes sobre o erro:

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

Modelos do AI Builder no ambiente atual.

Example

Este comando lista todos os modelos do AI Builder.

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

O comando retorna a saída da seguinte maneira:

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âmetros opcionais para a lista de modelos copilot

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac copilot model predict

Envia texto ou prompt para o Modelo de IA

Parâmetros opcionais para previsão de modelo de copilot

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--model-id -id

ID do modelo do AI Builder

--model-name -n

Nome completo ou parcial do modelo de IA

--prompt -p

Prompt para enviar para o Modelo de IA

--text -t

Texto a ser enviado para o Modelo de IA

pac copilot modelo prepare-fetch

Obtém o arquivo FetchXML do LLM (Modelo de Linguagem Grande) de IA e o prepara para execução no ambiente atual.

Parâmetros necessários para o modelo de copilot prepare-fetch

--inputFile -i

Arquivo FetchXML de entrada que geralmente vem da IA LLM.

--outputFile -o

Arquivo FetchXML de saída que está pronto para ser executado no ambiente atual.

Parâmetros opcionais para o modelo copilot prepare-fetch

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

pac copilot publish

Publicar um Copilot Personalizado

Parâmetros necessários para publicação de copilot

--bot -id

A ID do Copilot ou o nome do esquema (nome exclusivo encontrado em Detalhes do Bot ou nome do arquivo no gerenciador de soluções).

Parâmetros opcionais para publicação de copilot

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

status do pac copilot

Sondar o status de implantação de um copilot especificado no ambiente dataverse atual ou de destino.

Example

Esse comando sonda o status de implantação de um copilot especificado no ambiente dataverse atual ou de destino.

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

O comando retorna a saída da seguinte maneira:

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âmetros necessários para o status do copilot

--bot-id -id

A ID de um co-piloto (Chatbot).

Parâmetros opcionais para o status do copilot

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

Consulte também

Grupos de comandos da CLI do Microsoft Power Platform
Visão geral da CLI do Microsoft Power Platform

  • Last updated on