pac copilot

Ferramentas e utilitários para gestão de copilotos.

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

Um loop típico é assim:

1. Começa um espaço de trabalho. Apoie um agente novo com pac copilot init, ou descarregue um já existente com pac copilot clone. De qualquer forma, tens um espaço de trabalho local que transporta os metadados de sincronização dos quais dependem os outros comandos.
2. Retira antes de editares. pac copilot pull Reduz as alterações remotas e junta-as aos teus ficheiros locais, para começares pelo estado atual do servidor.
3. Empurra quando acabares. pac copilot push Envia as alterações locais de volta. Se o mesmo item mudou no servidor entretanto, o push para e pede-te para puxares primeiro.
4. Pacote para implementação. pac copilot pack transforma um espaço de trabalho numa solução .zip que podes implementar com pac solution import.

Para passar do nada a um agente ativo num só passo, pac copilot init --environment andaimes, embalam, importam e ligam o espaço de trabalho por si. Os comandos individuais permitem-te conduzir cada parte do loop isoladamente.

Commands

pac copilot clone

Clone um agente do Copilot Studio para um diretório local de espaço de trabalho.

pac copilot clonedescarrega um agente Copilot Studio existente para um diretório local de espaço de trabalho, juntamente com os metadados de sincronização em que pac copilot pull dependem.pac copilot push Os ficheiros do agente são gravados numa subpasta com o nome do seu nome de visualização.

Example

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

Parâmetros Obrigatórios para copilot clone

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

--component-collection -cc

ID da coleção de componentes para clonar. Repete por vários.

--display-name -dn

Nome de exibição do agente (usado para nomeação de pastas).

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

--output-dir -od

Pasta raiz para saída clone. Por defeito, o diretório atual.

Remarks

• --botaceita um ID Copilot ou nome de esquema. Passe o ID do 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. Clone escreve numa pasta nomeada pelo nome de exibição (sanitizado) do agente sob --output-dir. Se essa pasta já contém ficheiros, o clone para em vez de os sobrescrever. Use --display-name para escolher outro nome de pasta.
• Clonagem de coleções de componentes. Para trazer as coleções de componentes juntamente com o agente, passe um ou mais IDs de coleção com --component-collection, separados por ponto e vírgula.
• Clone requer um perfil autenticado (pac auth create) e resolve o ambiente a partir de --environment, ou da organização do perfil ativo quando o omites.

pac copilot create

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

Parâmetros Obrigatórios para copilot create

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

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

pac copilot delete

Apaga um Copilot personalizado.

Parâmetros Obrigatórios para copilot delete

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

--confirm -y

Necessário confirmar a eliminação do copiloto.

Este parâmetro não requer valor. É uma mudança.

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

pac copilot extract-template

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 Obrigatórios para copilot extract-template

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

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

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

pac copilot init

Crie um novo espaço de trabalho de agente do Copilot Studio a partir de um modelo.

pac copilot initEstrutura um novo espaço de trabalho de agente do Copilot Studio a partir de um modelo. Funciona num de dois modos, e a presença de --environment decide qual o modo a usar:

• Andaimes locais — não --environment. Escreve os ficheiros template no diretório do projeto e para. O comando não cria nada no Dataverse e não requer iniciar sessão. Usa este modo quando quiseres criar localmente e liga-te a um ambiente mais tarde.
• Bootstrap — --environment fornecido. Estrutura os ficheiros, empacota-os numa solução, importa essa solução para o ambiente e liga o espaço de trabalho ao agente recém-criado. Este modo é o caminho de um passo do nada para um agente ao vivo e pronto para sincronização, e requer um perfil autenticado.

Exemplos

Estrutura um espaço de trabalho localmente:

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

Acompanhe e faça bootstrap a um agente ativo num ambiente num único passo:

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

Esquele um agente criado por CLI (CliCopilot) numa pasta específica:

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

Parâmetros Obrigatórios para copilot init

--name -n

Nome de exibição do agente.

--publisher-prefix -pp

Prefixo de personalização do Publisher para a solução.

Parâmetros Opcionais para copilot init

--authoring-mode -am

O agente que cria a forma para andaime (padrão: 'clássico'). Use 'cli-copilot' para andar um agente CliCopilot criado por CLI.

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

--instructions -ins

Instruções do sistema do agente.

--project-dir -pd

Diretório alvo para o espaço de trabalho do agente. Por defeito, o diretório atual.

--schema-name -sn

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

--template -t

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

Remarks

• O diretório do projeto deve estar vazio. init Não anda sobre ficheiros existentes, por isso aponta --project-dir para uma pasta nova ou vazia.
• Derivação do nome do esquema. Quando se omite --schema-name, o nome do esquema do agente é construído como {publisher-prefix}_{sanitized-name}. Passe --schema-name para definir explicitamente; o valor é usado as-is.
• O bootstrap funciona para ambos os modos de autoria. init --environment Arranca um agente ativo em One Step para o modo clássico padrão e para --authoring-mode cli-copilot. Como alternativa a um agente CliCopilot, podes andar localmente (não --environment), depois correr pac copilot pack e pac solution import depois implementar tu próprio.
• O bootstrap cria objetos do lado do servidor. No modo bootstrap, 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 para e aponta-te pac copilot clone para te ligares ao agente existente.
• Um ambiente novo pode demorar a aceitar a primeira importação. Um ambiente recém-criado pode demorar um ou dois minutos a aquecer. Um bootstrap inicial pode falhar com "As operações assíncronas estão atualmente desativadas para esta organização." Espera um momento e volta a executá-lo.
• --template (default ou minimal) aplica-se apenas ao modo clássico de autoria.

pac copilot list

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

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

pac copilot mcp

Informações sobre o servidor MCP (Model Context Protocol) local.

Example

pac copilot mcp --run

Parâmetros Opcionais para copilot mcp

--run -r

Execute o servidor local MCP (Model Context Protocol).

Este parâmetro não requer valor. É uma mudança.

Remarks

Aprenda a usar a CLI do Power Platform com servidor MCP incorporado

pac copilot merge-translation

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

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

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

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

pac copilot model predict

Envia texto ou prompt para o Modelo AI

Parâmetros Opcionais para copilot model predict

--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 model prepare-fetch

Obtém o arquivo FetchXML do AI Large Language Model (LLM) e o prepara para execução no ambiente atual.

Parâmetros Obrigatórios para copilot model 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 copilot model 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.

pac copilot pack

Empacota um espaço de trabalho de agente do Copilot Studio num ficheiro zip da solução.

pac copilot pack empacota um espaço de trabalho de agente numa solução .zip Dataverse que pode implementar com pac solution import. É a forma autónoma da etapa de empacotamento que pac copilot init --environment corre para si, para que possa produzir a solução implantável como uma etapa separada — por exemplo, numa pipeline de build. Funciona tanto para espaços de trabalho clássicos como para agentes criados por CLI (CliCopilot).

Example

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

Parâmetros Obrigatórios para copilot pack

--publisher-prefix -pp

Prefixo de personalização do Publisher para a solução.

Parâmetros Opcionais para copilot pack

--output-path -op

Caminho de saída para o ficheiro zip da solução. Por defeito, o diretório atual.

--project-dir -pd

Diretório do espaço de trabalho do agente para pacote. Por defeito, o diretório atual.

--solution-name -sn

Solução: nome único. Se omitido, derivado do nome do esquema do agente.

Remarks

• É uma operação local. O Pack lê o espaço de trabalho e escreve uma solução .zip. Não precisa de autenticação nem de ambiente, por isso é seguro correr numa pipeline de build.
• O prefixo editor tem de ser válido. --publisher-prefix Tem de existir um prefixo de personalização bem definido, ou parar o pacote antes de escrever qualquer coisa.
• Nome e saída da solução. Se omitir --solution-name, o nome único da solução deriva do nome do esquema do agente. O .zip está escrito no diretório atual, a menos que defina --output-path.
• O pack não se destaca. Produz a solução mas não a importa. Segue para pac solution import implementar o agente, depois pac copilot clone , se quiseres um espaço de trabalho sincronizado para ele.

pac copilot publish

Publicar um copiloto personalizado

Parâmetros Obrigatórios para copilot publish

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

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

pac copilot pull

Retirar alterações remotas do Copilot Studio e fundir com o espaço de trabalho local.

O pac copilot pull comando recolhe o estado atual do servidor do agente e funde-o no teu espaço de trabalho local através de uma fusão tripla. Este processo garante que as edições do lado do servidor e os seus ficheiros locais intocados permanecem intactos. Executa antes de começares a editar, e volta a correr antes de lançares as tuas alterações.

Example

Executa o comando a partir da pasta do workspace:

pac copilot pull

Ou apontar para um espaço de trabalho noutro local do disco:

pac copilot pull --project-dir contoso-support

Parâmetros Opcionais para copilot pull

--project-dir -pd

Caminho para o diretório do projeto. O padrão é o diretório de trabalho atual.

Remarks

• Executa-o dentro de um espaço de trabalho sincronizado. O pull comando funciona apenas numa pasta criada por pac copilot clone ou pac copilot init. Lê o ambiente de destino e o agente a partir dos metadados de sincronização do workspace, razão pela qual não --environment há discussão. Se o executares noutro local, falha com um erro de "workspace não encontrado".
• Escreve nos teus ficheiros locais. O pull junta alterações remotas no espaço de trabalho e descarrega ficheiros de conhecimento. Compromete-te ou apoia trabalho local de que gostes antes de retirar.
• Inicie sessão primeiro com pac auth create.

pac copilot push

Empurra as alterações do espaço de trabalho local para o Copilot Studio.

pac copilot push envia as alterações no seu espaço de trabalho local de volta para o agente no Dataverse. Compara os teus ficheiros com o último estado conhecido do servidor, carrega apenas o que mudou – incluindo ficheiros de conhecimento, fluxos na cloud e referências de ligação – e reporta o que foi enviado.

Example

Executa-o a partir da pasta do workspace:

pac copilot push

Ou apontar para um espaço de trabalho noutro local do disco:

pac copilot push --project-dir contoso-support

Parâmetros Opcionais para copilot push

--project-dir -pd

Caminho para o diretório do projeto. O padrão é o diretório de trabalho atual.

Remarks

• Executa-o dentro de um espaço de trabalho sincronizado. Por exemplo pull, push só funciona numa pasta criada por pac copilot clone ou pac copilot init. Lê o ambiente de destino a partir dos metadados de sincronização do espaço de trabalho. Não há --environment discussão.
• Puxa primeiro se houver um conflito. Se o mesmo item mudou tanto localmente como no servidor, o push para e pede-te para correr pac copilot pull antes de tentar novamente. Este processo impede que um push sobrescrita silenciosamente uma alteração do lado do servidor que não viste.
• A ausência de alterações locais é um no-op. Se o Push não encontrar nada para enviar, reporta isso e sai sem tocar no ambiente.
• Um impulso bem-sucedido muta o agente vivo no ambiente alvo.
• Inicie sessão primeiro com pac auth create.

pac copilot quarantine

Estado de quarentena do agente copiloto.

Parâmetros Obrigatórios para copilot quarantine

--bot-id -id

A identificação 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 estado de quarentena. verdadeiro = quarentena, falso = desquarentena. O valor padrão é verdadeiro.

Este parâmetro não requer valor. É uma mudança.

pac copilot status

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 Obrigatórios para copilot status

--bot-id -id

O ID de um copiloto (Chatbot).

Parâmetros Opcionais para copilot status

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

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

Os clonecomandos , pull, push, e init --environment comunicam todos com um ambiente Dataverse, por isso precisam de um perfil de autenticação. Inicie sessão primeiro com pac auth create.

• clone, pull, e push requerem um perfil ativo. pac copilot init Só precisa de um quando passa --environment; sem ele, init os andaimes ficam localmente e não precisam de iniciar sessão.
• pull e push ler o ambiente alvo a partir dos metadados de sincronização do workspace, para que não tenham um --environment argumento. clone e init fazem.
• pac copilot pack é puramente local. Lê e escreve apenas ficheiros, por isso não precisa de autenticação nem de ambiente.

pull e push só funcionam dentro de um espaço de trabalho criado por clone ou init. Os metadados de sincronização escritos quando o workspace é criado são o que lhes indica com que agente e ambiente devem falar, por isso executá-los noutro local falha rapidamente com um erro "workspace não encontrado".

Ver também

Microsoft Power Platform Grupos de Comando CLI
Microsoft Power Platform Visão geral da CLI