Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Ferramentas e utilitários para gerenciamento de copiloto
Commands
| Command | Description |
|---|---|
| copiloto pac criar | Cria um novo copiloto usando um arquivo de modelo existente como referência. |
| Modelo de extração do copiloto PAC | Extrai um arquivo de modelo de um copiloto existente em um ambiente. |
| pac copilot extração-tradução | Extrai arquivo contendo conteúdo localizado para um ou mais bots. |
| Lista de copilotos PAC | Lista de copilots no ambiente Dataverse atual ou de destino. |
| Copiloto PAC MCP | Informações sobre o servidor MCP (Model Context Protocol) local. |
| Tradução de mesclagem do Copilot PAC | Mescle arquivos contendo conteúdo localizado para um ou mais bots. |
| Lista de modelos do PAC Copilot | Modelos do AI Builder no ambiente atual. |
| Modelo de copiloto PAC Predict | Envia texto ou prompt para o Modelo AI |
| PAC Copilot Modelo Prepare-Fetch | Obtém o arquivo FetchXML do AI Large Language Model (LLM) e o prepara para execução no ambiente atual. |
| Publicação do Copiloto do PAC | Publicar um copiloto personalizado |
| Status do copiloto PAC | Sonde o status de implantação de um copiloto especificado no ambiente Dataverse atual ou de destino. |
copiloto pac criar
Cria um novo copiloto usando um arquivo de modelo existente como referência.
Parâmetros necessários para a criação do copiloto
--displayName
O nome de exibição do novo copiloto
--schemaName
O nome do esquema (nome exclusivo) do novo copiloto.
--solution
-s
Nome da solução.
--templateFileName
Arquivo yaml de origem contendo o modelo copilot que foi extraído usando o comando extract-template.
Parâmetros opcionais para criação de copiloto
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.
Modelo de extração do copiloto PAC
Extrai um arquivo de modelo de um copiloto existente em um ambiente.
Example
Este comando extrai um arquivo de modelo de um copiloto 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 a saída como a seguinte para um copiloto 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 o modelo de extração do copiloto
--bot
-id
O ID do Copilot ou nome do esquema (nome exclusivo encontrado em Detalhes do Bot ou nome do arquivo no gerenciador de soluções).
--templateFileName
Localização do arquivo yaml para gravar o modelo copilot.
Parâmetros opcionais para copilot extract-template
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.
--overwrite
-o
Permitir a substituição do arquivo de dados de saída, se ele já existir.
Este parâmetro não requer valor. É uma mudança.
--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 extração-tradução
Extrai arquivo contendo conteúdo localizado para um ou mais bots.
Example
Este comando extrai um arquivo contendo conteúdo localizado para um ou mais copilotos.
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 forma:
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 copiloto extração-tradução
--all
-a
Escreva arquivos de localização para todos os idiomas suportados. Por padrão, apenas o idioma principal é escrito.
Este parâmetro não requer valor. É uma mudança.
--bot
-id
O ID do Copilot ou nome do esquema (nome exclusivo encontrado em Detalhes do Bot ou nome do arquivo no gerenciador de soluções).
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.
--format
O formato de arquivo no qual escrever arquivos localizados, 'resx' ou 'json'. O padrão é 'resx'.
--outdir
O diretório de saída para gravar.
--overwrite
-o
Permitir a substituição do arquivo de dados de saída, se ele já existir.
Este parâmetro não requer valor. É uma mudança.
--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.
Lista de copilotos PAC
Lista de copilots no ambiente Dataverse atual ou de destino.
Example
Este 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 forma:
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 de copilotos
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.
Copiloto PAC MCP
Informações sobre o servidor MCP (Model Context Protocol) local.
Parâmetros opcionais para o copilot mcp
--run
-r
Execute o servidor local MCP (Model Context Protocol).
Este parâmetro não requer valor. É uma mudança.
Tradução de mesclagem do Copilot PAC
Mescle arquivos contendo conteúdo localizado para um ou mais bots.
Example
Este comando mescla arquivos contendo conteúdo localizado para um ou mais copilotos.
pac copilot merge-translation `
--environment 2e250e7a-5607-4fea-aa4e-1aeb7bf79118 `
--file ms_store_newTestCopilot.de-DE.json `
--solution SolutionName
O comando retorna a saída da seguinte forma 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 a partir do comando merge-translation
Parâmetros opcionais para a conversão de mesclagem copiloto
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não 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. Os padrões Glob são suportados.
--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
Produza mais informações de diagnóstico durante a importação/exportação de dados
Este parâmetro não requer valor. É uma mudança.
--whatif
Não executa o comando, mas produz os detalhes do que aconteceria.
Este parâmetro não requer valor. É uma mudança.
erros de mesclagem-tradução
Com base no exemplo acima, se existir um erro no arquivo usado para atualizar o copilot, a saída se parece:
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.
Lista de modelos do PAC Copilot
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 forma:
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 de copiloto
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.
Modelo de copiloto PAC Predict
Envia texto ou prompt para o Modelo AI
Parâmetros opcionais para previsão do modelo copiloto
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não 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 total ou parcial do modelo de IA
--prompt
-p
Prompt para enviar para AI Model
--text
-t
Texto a enviar para o AI Model
PAC Copilot Modelo Prepare-Fetch
Obtém o arquivo FetchXML do AI Large Language Model (LLM) e o prepara para execução no ambiente atual.
Parâmetros necessários para o modelo de copiloto prepare-fetch
--inputFile
-i
Arquivo FetchXML de entrada que geralmente vem do AI LLM.
--outputFile
-o
Arquivo FetchXML de saída que está pronto para ser executado no ambiente atual.
Parâmetros opcionais para o modelo copiloto prepare-fetch
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.
Publicação do Copiloto do PAC
Publicar um copiloto personalizado
Parâmetros necessários para publicação do copiloto
--bot
-id
O ID do Copilot ou 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 copiloto
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.
Status do copiloto PAC
Sonde o status de implantação de um copiloto especificado no ambiente Dataverse atual ou de destino.
Example
Este comando sonda o status de implantação de um copiloto 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 forma:
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 copiloto
--bot-id
-id
O ID de um copiloto (Chatbot).
Parâmetros opcionais para o status do copiloto
--environment
-env
Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não 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