pac copilot

Ferramentas e utilitários para gerenciamento de copilot.

Os initcomandos , clone, pullpushe pack permitem manter um agente Copilot Studio como um conjunto de arquivos em disco, editá-lo localmente e sincronizá-lo com um ambiente do Dataverse.

Um loop típico tem esta aparência:

1. Inicie um workspace. Faça scaffold de um novo agente com pac copilot init, ou baixe um existente com pac copilot clone. De qualquer forma, você obtém um workspace local que carrega os metadados de sincronização dos quais os outros comandos dependem.
2. Efetuar pull antes de editar. pac copilot pull reduz as alterações remotas e as mescla em seus arquivos locais, portanto, você começa do estado atual do servidor.
3. Efetue push quando terminar. pac copilot push envia as alterações locais de volta. Se o mesmo item tiver sido alterado no servidor enquanto isso, o push será interrompido e pedirá que você efetue pull primeiro.
4. Pacote para implantação. pac copilot pack transforma um workspace em uma solução .zip com pac solution importa qual você pode implantar.

Para ir do nada para um agente ativo em uma única etapa, pac copilot init --environment scaffolds, pacotes, importações e conecta o workspace para você. Os comandos individuais permitem que você conduza cada parte do loop por conta própria.

Commands

pac copilot clone

Clone um agente de Copilot Studio em um diretório de workspace local.

pac copilot clonebaixa um agente de Copilot Studio existente em um diretório de workspace local, juntamente com os metadados de sincronização que pac copilot pull e pac copilot push dependem. Os arquivos do agente são gravados em uma subpasta com o nome de exibição.

Example

pac copilot clone `
   --bot 11111111-1111-1111-1111-111111111111 `
   --environment 22222222-2222-2222-2222-222222222222 `
   --output-dir contoso-support

Parâmetros necessários para copilot clone

--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 copilot clone

--component-collection -cc

ID da coleção de componentes a ser clonada. Repita para vários.

--display-name -dn

Nome de exibição do agente (usado para nomenclatura de pasta).

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

--output-dir -od

Pasta raiz para a saída do clone. O padrão é o diretório atual.

Remarks

• --botaceita uma ID de Copilot ou um nome de esquema. Passe a ID de Copilot (um GUID) ou o nome do esquema do agente. O comando resolve um nome de esquema em relação ao ambiente de destino.
• A subpasta de destino deve estar vazia. Clonar gravações em uma pasta com o nome --output-dirde exibição do agente (higienizado) em . Se essa pasta já contiver arquivos, clone paradas em vez de substituí-las. Use --display-name para escolher um nome de pasta diferente.
• Clonando coleções de componentes. Para reduzir as coleções de componentes ao lado do agente, passe uma ou mais IDs de coleção com --component-collection, separadas por ponto-e-vírgula.
• Clonar requer um perfil autenticado (pac auth create) e resolve o ambiente de --environment, ou da organização do perfil ativo quando você omite.

pac copilot create

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

Parâmetros necessários para copilot create

--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 copilot create

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

Excluir um Copilot Personalizado.

Parâmetros necessários para copilot delete

--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 copilot delete

--confirm -y

Necessário para confirmar a exclusão do co-piloto.

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

--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 copilot extract-translation

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

Crie um novo workspace do agente Copilot Studio a partir de um modelo.

pac copilot initestrutura um novo workspace do agente Copilot Studio de um modelo. Ele é executado em um dos dois modos e a presença de --environment decide qual modo usar:

• Scaffold local – não --environment. Grava os arquivos de modelo no diretório do projeto e para. O comando não cria nada no Dataverse e não requer entrada. Use esse modo quando quiser criar localmente e conectar-se a um ambiente posteriormente.
• Bootstrap – --environment fornecido. Scaffolds the files, packages them into a solution, imports that solution into the environment, and connects the workspace to the newly created agent. Esse modo é o caminho de uma etapa do nada para um agente ativo e pronto para sincronização e requer um perfil autenticado.

Exemplos

Faça scaffold de um workspace localmente:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso

Faça scaffold e inicialize um agente ativo em um ambiente em uma única etapa:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --environment 22222222-2222-2222-2222-222222222222

Faça scaffold de um agente de CLI (CliCopilot) em uma pasta específica:

pac copilot init `
   --name "Contoso Support Agent" `
   --publisher-prefix contoso `
   --authoring-mode cli-copilot `
   --project-dir contoso-support

Parâmetros necessários para copilot init

--name -n

Nome de exibição do agente.

--publisher-prefix -pp

Publisher prefixo de personalização para a solução.

Parâmetros opcionais para copilot init

--authoring-mode -am

A forma de criação do agente para scaffold (padrão: 'clássico'). Use 'cli-copilot' para estruturar um agente CliCopilot de autoria da CLI.

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

--instructions -ins

Instruções do sistema do agente.

--project-dir -pd

Diretório de destino para o workspace do agente. O padrão é o diretório atual.

--schema-name -sn

Nome do esquema do agente completo. Substitui a derivação padrão ({publisher-prefix}_{sanitized-name}). Usado as-is sem modificação.

--template -t

Nome do perfil do modelo (padrão, mínimo). O padrão é 'default'.

Remarks

• O diretório do projeto deve estar vazio. init não faz scaffold sobre arquivos existentes, portanto, aponte --project-dir para uma pasta nova ou vazia.
• Derivação de nome de esquema. Quando você omite --schema-name, o nome do esquema do agente é criado como {publisher-prefix}_{sanitized-name}. Passe --schema-name para defini-lo explicitamente; o valor é usado as-is.
• O Bootstrap funciona para ambos os modos de criação. init --environment inicializa um agente dinâmico em uma etapa para o modo clássico padrão e para --authoring-mode cli-copilot. Como alternativa para um agente CliCopilot, você pode criar scaffold localmente (não --environment), em seguida, executar pac copilot pack seguido para pac solution import implantá-lo por conta própria.
• Bootstrap cria objetos do lado do servidor. No modo de inicialização, init importa uma solução e cria o agente no ambiente de destino. Se já existir um agente com o mesmo nome de esquema, init pare e aponte para você se pac copilot clone conectar ao agente existente.
• Um ambiente novo pode demorar para aceitar a primeira importação. Um ambiente recém-criado pode levar um minuto ou dois para se aquecer. Uma inicialização inicial pode falhar com "As operações assíncronas estão desabilitadas atualmente para esta organização". Aguarde um momento e execute-o novamente.
• --template (default ou minimal) aplica-se apenas ao modo de criação clássico.

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 copilot list

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

Remarks

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 copilot merge-translation

--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 copilot model list

--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 copilot model predict

--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 model 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 copilot model 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 copilot model 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 pack

Empacote um workspace do agente Copilot Studio em um arquivo zip da solução.

pac copilot pack empacota um workspace de agente em uma solução .zip do Dataverse com pac solution importa qual você pode implantar. É a forma autônoma da etapa de empacotamento que pac copilot init --environment é executada para você, para que você possa produzir a solução implantável como uma etapa separada , por exemplo, em um pipeline de build. Ele funciona tanto para workspaces de agente clássicos quanto de CLI (CliCopilot).

Example

pac copilot pack `
   --publisher-prefix contoso `
   --project-dir contoso-support `
   --output-path out

Parâmetros necessários para copilot pack

--publisher-prefix -pp

Publisher prefixo de personalização para a solução.

Parâmetros opcionais para copilot pack

--output-path -op

Caminho de saída para o arquivo zip da solução. O padrão é o diretório atual.

--project-dir -pd

Diretório do workspace do agente para empacotar. O padrão é o diretório atual.

--solution-name -sn

Nome exclusivo da solução. Se omitido, derivado do nome do esquema do agente.

Remarks

• É uma operação local. O pacote lê o workspace e grava uma solução .zip. Ele não precisa de autenticação nem ambiente, portanto, é seguro executar em um pipeline de build.
• O prefixo do publicador deve ser válido. --publisher-prefix deve ser um prefixo de personalização bem formado ou o pacote para antes de escrever qualquer coisa.
• Nome e saída da solução. Se você omitir --solution-name, o nome exclusivo da solução será derivado do nome do esquema do agente. A .zip gravação é no diretório atual, a menos que você defina --output-path.
• O pacote não é implantado. Ele produz a solução, mas não a importa. Siga-o para pac solution import implantar o agente, pac copilot clone se você quiser um workspace conectado à sincronização para ele.

pac copilot publish

Publicar um Copilot Personalizado

Parâmetros necessários para copilot publish

--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 copilot publish

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

Efetue pull de alterações remotas de Copilot Studio e mesclagem com o workspace local.

O pac copilot pull comando busca o estado atual do servidor do agente e o mescla em seu workspace local usando uma mesclagem de três vias. Esse processo garante que as edições do lado do servidor e seus arquivos locais intocados permaneçam intactos. Execute-o antes de começar a editar e execute-o novamente antes de enviar suas alterações por push.

Example

Execute o comando de dentro da pasta do workspace:

pac copilot pull

Ou aponte-o para um workspace em outro lugar no disco:

pac copilot pull --project-dir contoso-support

Parâmetros opcionais para copilot pull

--project-dir -pd

Caminho para o diretório do projeto. Usa o diretório de trabalho atual por padrão.

Remarks

• Execute-o dentro de um workspace de sincronização. O pull comando funciona apenas em uma pasta criada por pac copilot clone ou pac copilot init. Ele lê o ambiente de destino e o agente dos metadados de sincronização do workspace, razão pela qual não há nenhum --environment argumento. Se você executá-lo em qualquer outro lugar, ele falhará com um erro "workspace não encontrado".
• Ele grava em seus arquivos locais. O pull mescla alterações remotas no workspace e baixa arquivos de conhecimento. Confirme ou faça backup do trabalho local com o qual você se importa antes de efetuar pull.
• Entre primeiro com pac auth create.

pac copilot push

Envie por push as alterações do workspace local para Copilot Studio.

pac copilot push envia as alterações no workspace local de volta para o agente no Dataverse. Ele compara seus arquivos com o último estado do servidor conhecido, carrega apenas o que foi alterado - incluindo arquivos de conhecimento, fluxos de nuvem e referências de conexão - e relata o que ele enviou por push.

Example

Execute-o de dentro da pasta do workspace:

pac copilot push

Ou aponte-o para um workspace em outro lugar no disco:

pac copilot push --project-dir contoso-support

Parâmetros opcionais para copilot push

--project-dir -pd

Caminho para o diretório do projeto. Usa o diretório de trabalho atual por padrão.

Remarks

• Execute-o dentro de um workspace de sincronização. Assim como pull, push só funciona em uma pasta criada por pac copilot clone ou pac copilot init. Ele lê o ambiente de destino dos metadados de sincronização do workspace. Não há argumento --environment .
• Puxe primeiro se houver um conflito. Se o mesmo item tiver sido alterado localmente e no servidor, o push será interrompido e solicitará que você execute pac copilot pull antes de tentar novamente. Esse processo impede que um push substitua silenciosamente uma alteração do lado do servidor que você não viu.
• Nenhuma alteração local é um no-op. Se o push não encontrar nada para enviar, ele relatará isso e sairá sem tocar no ambiente.
• Um push bem-sucedido transforma o agente ativo no ambiente de destino.
• Entre primeiro com pac auth create.

pac copilot quarantine

Status de quarentena do agente copiloto.

Parâmetros necessários para copilot quarantine

--bot-id -id

O ID do copiloto para quarentena/desquarentena.

Parâmetros opcionais para copilot quarantine

--environment -env

Ambiente (ID, ID da organização, url, nome exclusivo ou nome parcial).

--status -s

Valor de status de quarentena. verdadeiro = quarentena, falso = desquarentena. O padrão é true.

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

pac copilot status

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 copilot status

--bot-id -id

A ID de um co-piloto (Chatbot).

Parâmetros opcionais para copilot status

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

Autenticação e ambiente para os comandos de sincronização

Os clonecomandos , pullpushe init --environment todos conversam com um ambiente do Dataverse, portanto, eles precisam de um perfil de autenticação. Entre primeiro com pac auth create.

• clonee pullpush exija um perfil ativo. pac copilot init só precisa de um quando você passa --environment; sem ele, init scaffolds arquivos localmente e não precisa de entrada.
• pull e push leia o ambiente de destino dos metadados de sincronização do workspace para que eles não usem um --environment argumento. clone e init fazer.
• pac copilot pack é puramente local. Ele lê e grava somente arquivos, portanto, não precisa de autenticação nem ambiente.

pull e push só funcionam dentro de um workspace criado por clone ou init. Os metadados de sincronização gravados quando o workspace é criado é o que lhes diz com qual agente e ambiente conversar, portanto, executá-los em qualquer outro lugar falha rapidamente com um erro "workspace não encontrado".

Consulte também

grupos de comandos da CLI Microsoft Power Platform
Visão geral da CLI Microsoft Power Platform