pac copilot-studio

(Pré-visualização) Administrar os agentes do Copilot Studio e os relatórios de licenciamento de inquilinos de exportação.

Comandos

Comando Description
pac copilot-studio delete-copilot-agent (Pré-visualização) Apagar um bot.
pac copilot-studio download-agent-channel-manifest (Pré-visualização) Descarrega o pacote de manifestos do canal para o agente e canal especificados como ficheiro zip. Atualmente, apenas o canal "M365" é suportado.
pac copilot-studio download-licensing-report-file (Pré-visualização) Descarrega um relatório de licenciamento gerado como um ficheiro CSV comprimido em gzip. Use o nome do ficheiro devolvido por uma operação de relatório com o estado Sucesso.
pac copilot-studio generate-licensing-report (Pré-visualização) Começa a gerar um relatório de licenciamento do Copilot Studio para o seu inquilino dentro do intervalo de datas solicitado. A geração corre de forma assíncrona; consultar a URL no cabeçalho Localização para o estado. Requer as funções de administrador Global, Dynamics 365 ou Power Platform.
pac copilot-studio get-bot-quarantine-status (Pré-visualização) Recuperar o estado de quarentena de um bot.
pac copilot-studio get-connector-consent-bypass (Pré-visualização) Desbloqueia a definição de consentimento de consentimento do conector de administrador para um bot.
pac copilot-studio get-licensing-report-operation (Pré-visualização) Recebe o estado de uma operação de geração de relatórios de licenciamento. Quando o estado é Succeeded, a resposta inclui o nome do ficheiro de relatório e o cabeçalho Location contém o URL de download.
pac copilot-studio get-maker-evaluation-test-run (Pré-visualização) Obtenha o estado e os resultados de um teste específico de avaliação do fabricante.
pac copilot-studio get-maker-evaluation-test-set (Pré-visualização) Arranja um conjunto de testes específico para avaliação do fabricante de um robô.
pac copilot-studio list-maker-evaluation-test-runs (Pré-visualização) Lista todas as execuções de teste de avaliação do fabricante para um bot.
pac copilot-studio list-maker-evaluation-test-sets (Pré-visualização) Recupera a lista de conjuntos de teste para um bot num ambiente especificado.
pac copilot-studio reassign-copilot-agent (Pré-visualização) Reatribuir o dono do bot.
pac copilot-studio run-maker-evaluation-test-set (Pré-visualização) Acionar um teste de avaliação do maker para um conjunto de testes específico.
pac copilot-studio set-bot-as-quarantined (Pré-visualização) Definir o estado de quarentena de um bot para verdadeiro.
pac copilot-studio set-bot-as-unquarantined (Pré-visualização) Defina o estado de quarentena de um bot para falso.
pac copilot-studio set-connector-consent-bypass (Pré-visualização) Define a definição de consentimento de contorno do conector de administrador para um bot.

pac copilot-studio delete-copilot-agent

(Pré-visualização) Apagar um bot.

Parâmetros Obrigatórios para copilot-studio delete-copilot-agent

--bot-id

O ID do bot.

Parâmetros Opcionais para copilot-studio delete-copilot-agent

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

delete-copilot-agent Observações

Também pode invocar este comando usando o Power Platform REST API Bots - Delete Copilot Agent.

pac copilot-studio download-agent-channel-manifest

(Pré-visualização) Descarrega o pacote de manifestos do canal para o agente e canal especificados como ficheiro zip. Atualmente, apenas o canal "M365" é suportado.

Parâmetros Obrigatórios para copilot-studio download-agent-channel-manifest

--agent-id

O ID do bot.

--channel-name

O nome do canal. Atualmente, apenas o "M365" é suportado.

--out-file

O caminho do ficheiro local para escrever o conteúdo descarregado.

Parâmetros Opcionais para copilot-studio download-agent-channel-manifest

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

--include-agent-schema

Se deve incluir o esquema do agente no pacote de manifestos descarregado.

download-agent-channel-manifest Observações

Também pode invocar este comando usando o Power Platform REST API Agent Channels - Download Agent Channel Manifest.

pac copilot-studio download-licensing-report-file

(Pré-visualização) Descarrega um relatório de licenciamento gerado como um ficheiro CSV comprimido em gzip. Use o nome do ficheiro devolvido por uma operação de relatório com o estado Sucesso.

Parâmetros Obrigatórios para copilot-studio download-licensing-report-file

--file-name

O nome do ficheiro de relatório, devolvido por uma operação de relatório com o estado Sucedido.

--out-file

O caminho do ficheiro local para escrever o conteúdo descarregado.

--report-name

O nome do relatório gerado.

Use um destes valores:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio generate-licensing-report

(Pré-visualização) Começa a gerar um relatório de licenciamento do Copilot Studio para o seu inquilino dentro do intervalo de datas solicitado. A geração corre de forma assíncrona; consultar a URL no cabeçalho Localização para o estado. Requer as funções de administrador Global, Dynamics 365 ou Power Platform.

Parâmetros Obrigatórios para copilot-studio generate-licensing-report

--end-date

A data de término UTC inclusiva do intervalo do relatório. Tem de ser na data de início ou depois dela.

--report-name

O nome do relatório a gerar.

Use um destes valores:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

--start-date

A data de início UTC inclusiva do intervalo do relatório.

Parâmetros Opcionais para copilot-studio generate-licensing-report

--granularity

A granularidade de um relatório de licenciamento. O diário devolve uma linha por dia no intervalo de datas, e o Resumo devolve uma única linha resumida para todo o intervalo.

Use um destes valores:

  • Daily
  • Summary

pac copilot-studio get-bot-quarantine-status

(Pré-visualização) Recuperar o estado de quarentena de um bot.

Parâmetros Obrigatórios para copilot-studio get-bot-quarantine-status

--bot-id

O ID do bot.

Parâmetros Opcionais para copilot-studio get-bot-quarantine-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.

get-bot-quarantine-status Observações

Também pode invocar este comando usando a API REST Bots da Power Platform - Get Bot Quarantine Status.

(Pré-visualização) Desbloqueia a definição de consentimento de consentimento do conector de administrador para um bot.

--bot-id

O ID do bot.

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

Também pode invocar este comando usando os Bots da API REST da Power Platform - Get Connector Consent Bypass.

pac copilot-studio get-licensing-report-operation

(Pré-visualização) Recebe o estado de uma operação de geração de relatórios de licenciamento. Quando o estado é Succeeded, a resposta inclui o nome do ficheiro de relatório e o cabeçalho Location contém o URL de download.

Parâmetros Obrigatórios para copilot-studio get-licensing-report-operation

--operation-id

O ID da operação do relatório é devolvido no cabeçalho Localização quando a geração do relatório começa.

--report-name

O nome do relatório que está a ser gerado.

Use um destes valores:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio get-maker-evaluation-test-run

(Pré-visualização) Obtenha o estado e os resultados de um teste específico de avaliação do fabricante.

Parâmetros Obrigatórios para copilot-studio get-maker-evaluation-test-run

--bot-id

O ID do bot.

--test-run-id

O ID da corrida de teste.

Parâmetros Opcionais para copilot-studio get-maker-evaluation-test-run

--columns

Lista separada por vírgulas das propriedades de resposta a incluir na saída da tabela. Use --json para a resposta completa.

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

get-maker-evaluation-test-run Observações

Também pode invocar este comando usando o Power Platform REST API Bots - Get Maker Evaluation Test Run.

pac copilot-studio get-maker-evaluation-test-set

(Pré-visualização) Arranja um conjunto de testes específico para avaliação do fabricante de um robô.

Parâmetros Obrigatórios para copilot-studio get-maker-evaluation-test-set

--bot-id

O ID do bot.

--test-set-id

O ID do conjunto de teste.

Parâmetros Opcionais para copilot-studio get-maker-evaluation-test-set

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

get-maker-evaluation-test-set Observações

Também pode invocar este comando usando o Power Platform REST API Bots - Get Maker Evaluation Test Set.

pac copilot-studio list-maker-evaluation-test-runs

(Pré-visualização) Lista todas as execuções de teste de avaliação do fabricante para um bot.

Parâmetros Obrigatórios para copilot-studio list-maker-evaluation-test-runs

--bot-id

O ID do bot.

Parâmetros Opcionais para copilot-studio list-maker-evaluation-test-runs

--columns

Lista separada por vírgulas das propriedades de resposta a incluir na saída da tabela. Use --json para a resposta completa.

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

list-maker-evaluation-test-runs Observações

Também pode invocar este comando usando a Power Platform REST API Bots - List Maker Evaluation Test Runs.

pac copilot-studio list-maker-evaluation-test-sets

(Pré-visualização) Recupera a lista de conjuntos de teste para um bot num ambiente especificado.

Parâmetros Obrigatórios para copilot-studio list-maker-evaluation-test-sets

--bot-id

O ID do bot.

Parâmetros Opcionais para copilot-studio list-maker-evaluation-test-sets

--columns

Lista separada por vírgulas das propriedades de resposta a incluir na saída da tabela. Use --json para a resposta completa.

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

list-maker-evaluation-test-sets Observações

Também pode invocar este comando usando os Bots da API REST da Power Platform - List Maker Evaluation Test Sets.

pac copilot-studio reassign-copilot-agent

(Pré-visualização) Reatribuir o dono do bot.

Parâmetros Obrigatórios para copilot-studio reassign-copilot-agent

--bot-id

O ID do bot.

--new-owner-aad-user-id

O novo proprietário Entra ID.

Parâmetros Opcionais para copilot-studio reassign-copilot-agent

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

reassign-copilot-agent Observações

Também pode invocar este comando usando o Power Platform REST API Bots - Reassign Copilot Agent.

pac copilot-studio run-maker-evaluation-test-set

(Pré-visualização) Acionar um teste de avaliação do maker para um conjunto de testes específico.

Parâmetros Obrigatórios para copilot-studio run-maker-evaluation-test-set

--bot-id

O ID do bot.

--test-set-id

O ID do conjunto de teste.

Parâmetros Opcionais para copilot-studio run-maker-evaluation-test-set

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

--evaluation-run-name

O nome da sessão de avaliação.

--mcs-connection-id

O ID de ligação para o conector MCS usado para executar a execução de avaliação, ou deixa vazio para uma execução anónima.

--run-on-published-bot

Indica se a operação deve correr numa instância publicada do bot. Se estiver definido como falso, a operação irá correr numa instância de draft bot.

--tools-connections

As ligações das ferramentas que serão usadas para executar a avaliação são executadas. Esta é uma lista de ferramentas juntamente com as conexões de utilizador correspondentes que devem ser usadas para cada ferramenta. Fornece o valor como um array JSON.

run-maker-evaluation-test-set Observações

Também pode invocar este comando usando o Power Platform REST API Bots - Run Maker Evaluation Test Set.

pac copilot-studio set-bot-as-quarantined

(Pré-visualização) Definir o estado de quarentena de um bot para verdadeiro.

Parâmetros Obrigatórios para copilot-studio set-bot-as-quarantined

--bot-id

O ID do bot.

Parâmetros Opcionais para copilot-studio set-bot-as-quarantined

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

set-bot-as-quarantined Observações

Também pode invocar este comando usando a API REST Bots da Power Platform - Definir Bot Como Quarentena.

pac copilot-studio set-bot-as-unquarantined

(Pré-visualização) Defina o estado de quarentena de um bot para falso.

Parâmetros Obrigatórios para copilot-studio set-bot-as-unquarantined

--bot-id

O ID do bot.

Parâmetros Opcionais para copilot-studio set-bot-as-unquarantined

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

set-bot-as-unquarantined Observações

Também pode invocar este comando usando a API REST Bots da Power Platform - Definir Bot como Unquarantined.

(Pré-visualização) Define a definição de consentimento de contorno do conector de administrador para um bot.

--admin-consent-bypass

Indica se deve ativar o bypass de consentimento do conector de administrador para o bot.

--bot-id

O ID do bot.

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

Também pode invocar este comando usando o Power Platform REST API Bots - Set Connector Consent Bypass.

Consulte também

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

  • Última atualização a