pac copilot-studio

(Versão prévia) Administrar Copilot Studio agentes e exportar relatórios de licenciamento de locatário.

Comandos

Command Description
pac copilot-studio delete-copilot-agent (Versão prévia) Excluir um bot.
pac copilot-studio download-agent-channel-manifest (Versão prévia) Baixa o pacote de manifesto do canal para o agente e o canal especificados como um arquivo zip. Atualmente, há suporte apenas para o canal "M365".
pac copilot-studio download-licensing-report-file (Versão prévia) Baixa um relatório de licenciamento gerado como um arquivo CSV compactado por gzip. Use o nome do arquivo retornado por uma operação de relatório com um status bem-sucedido.
pac copilot-studio generate-licensing-report (Versão prévia) Começa a gerar um relatório de licenciamento Copilot Studio para seu locatário no intervalo de datas solicitado. A geração é executada de forma assíncrona; sondar a URL no cabeçalho Local para obter status. Requer a função de administrador Global, Dynamics 365 ou Power Platform.
pac copilot-studio get-bot-quarantine-status (Versão prévia) Recupere o status de quarentena de um bot.
pac copilot-studio get-connector-consent-bypass (Versão prévia) Obtenha a configuração de bypass de consentimento do conector de administrador para um bot.
pac copilot-studio get-licensing-report-operation (Versão prévia) Obtém o status de uma operação de geração de relatório de licenciamento. Quando o status é bem-sucedido, a resposta inclui o nome do arquivo de relatório e o cabeçalho Local contém a URL de download.
pac copilot-studio get-maker-evaluation-test-run (Versão prévia) Obtenha o status e os resultados de uma execução de teste de avaliação específica do criador.
pac copilot-studio get-maker-evaluation-test-set (Versão prévia) Obtenha um conjunto de testes específico para avaliação do criador de um bot.
pac copilot-studio list-maker-evaluation-test-runs (Versão prévia) Listar todas as execuções de teste de avaliação do criador para um bot.
pac copilot-studio list-maker-evaluation-test-sets (Versão prévia) Recupera a lista de conjuntos de testes para um bot em um ambiente especificado.
pac copilot-studio reassign-copilot-agent (Versão prévia) Reatribua o proprietário do bot.
pac copilot-studio run-maker-evaluation-test-set (Versão prévia) Dispare uma execução de teste de avaliação do criador para um conjunto de teste específico.
pac copilot-studio set-bot-as-quarantined (Versão prévia) Defina o status de quarentena de um bot como true.
pac copilot-studio set-bot-as-unquarantined (Versão prévia) Defina o status de quarentena de um bot como false.
pac copilot-studio set-connector-consent-bypass (Versão prévia) Defina a configuração de bypass de consentimento do conector de administrador para um bot.

pac copilot-studio delete-copilot-agent

(Versão prévia) Excluir um bot.

Parâmetros necessários para copilot-studio delete-copilot-agent

--bot-id

A ID do bot.

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

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

delete-copilot-agent Observações

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Excluir Copilot Agent.

pac copilot-studio download-agent-channel-manifest

(Versão prévia) Baixa o pacote de manifesto do canal para o agente e o canal especificados como um arquivo zip. Atualmente, há suporte apenas para o canal "M365".

Parâmetros necessários para copilot-studio download-agent-channel-manifest

--agent-id

A ID do bot.

--channel-name

O nome do canal. Atualmente, há suporte apenas para "M365".

--out-file

O caminho do arquivo local para o qual gravar o conteúdo baixado.

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

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

--include-agent-schema

Se deve incluir o esquema do agente no pacote de manifesto baixado.

download-agent-channel-manifest Observações

Você também pode invocar esse comando usando os canais do agente da API REST do Power Platform – Baixar o Manifesto do Canal do Agente.

pac copilot-studio download-licensing-report-file

(Versão prévia) Baixa um relatório de licenciamento gerado como um arquivo CSV compactado por gzip. Use o nome do arquivo retornado por uma operação de relatório com um status bem-sucedido.

Parâmetros necessários para copilot-studio download-licensing-report-file

--file-name

O nome do arquivo de relatório, retornado por uma operação de relatório com um status bem-sucedido.

--out-file

O caminho do arquivo local para o qual gravar o conteúdo baixado.

--report-name

O nome do relatório gerado.

Use um destes valores:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

pac copilot-studio generate-licensing-report

(Versão prévia) Começa a gerar um relatório de licenciamento Copilot Studio para seu locatário no intervalo de datas solicitado. A geração é executada de forma assíncrona; sondar a URL no cabeçalho Local para obter status. Requer a função de administrador Global, Dynamics 365 ou Power Platform.

Parâmetros necessários para copilot-studio generate-licensing-report

--end-date

A data de término utc inclusiva do intervalo de relatórios. Deve estar ativado ou após a data de início.

--report-name

O nome do relatório a ser gerado.

Use um destes valores:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

--start-date

A data de início utc inclusiva do intervalo de relatórios.

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

--granularity

A granularidade de um relatório de licenciamento. Diariamente retorna uma linha por dia no intervalo de datas e Resumo retorna uma única linha resumida para todo o intervalo.

Use um destes valores:

  • Daily
  • Summary

pac copilot-studio get-bot-quarantine-status

(Versão prévia) Recupere o status de quarentena de um bot.

Parâmetros necessários para copilot-studio get-bot-quarantine-status

--bot-id

A ID do bot.

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

get-bot-quarantine-status Observações

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Obter Status de Quarentena do Bot.

(Versão prévia) Obtenha a configuração de bypass de consentimento do conector de administrador para um bot.

--bot-id

A ID do bot.

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

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Obter Bypass de Consentimento do Conector.

pac copilot-studio get-licensing-report-operation

(Versão prévia) Obtém o status de uma operação de geração de relatório de licenciamento. Quando o status é bem-sucedido, a resposta inclui o nome do arquivo de relatório e o cabeçalho Local contém a URL de download.

Parâmetros necessários para copilot-studio get-licensing-report-operation

--operation-id

A ID da operação de relatório, retornada no cabeçalho Local quando a geração de relatório é iniciada.

--report-name

O nome do relatório que está sendo gerado.

Use um destes valores:

  • BillingDetailsPerEnvironment
  • FeatureDetailsPerResource

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

(Versão prévia) Obtenha o status e os resultados de uma execução de teste de avaliação específica do criador.

Parâmetros necessários para copilot-studio get-maker-evaluation-test-run

--bot-id

A ID do bot.

--test-run-id

A ID da execução do teste.

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

--columns

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

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

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

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Obter a Execução de Teste de Avaliação do Criador.

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

(Versão prévia) Obtenha um conjunto de testes específico para avaliação do criador de um bot.

Parâmetros necessários para copilot-studio get-maker-evaluation-test-set

--bot-id

A ID do bot.

--test-set-id

A ID do conjunto de testes.

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

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

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

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Obter Conjunto de Testes de Avaliação do Criador.

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

(Versão prévia) Listar todas as execuções de teste de avaliação do criador para um bot.

Parâmetros necessários para copilot-studio list-maker-evaluation-test-runs

--bot-id

A ID do bot.

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

--columns

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

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

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

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – List Maker Evaluation Test Runs.

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

(Versão prévia) Recupera a lista de conjuntos de testes para um bot em um ambiente especificado.

Parâmetros necessários para copilot-studio list-maker-evaluation-test-sets

--bot-id

A ID do bot.

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

--columns

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

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

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

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Conjuntos de Testes de Avaliação do Criador de Listas.

pac copilot-studio reassign-copilot-agent

(Versão prévia) Reatribua o proprietário do bot.

Parâmetros necessários para copilot-studio reassign-copilot-agent

--bot-id

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

reassign-copilot-agent Observações

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Reatribuir Copilot Agent.

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

(Versão prévia) Dispare uma execução de teste de avaliação do criador para um conjunto de teste específico.

Parâmetros necessários para copilot-studio run-maker-evaluation-test-set

--bot-id

A ID do bot.

--test-set-id

A ID do conjunto de testes.

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

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

--evaluation-run-name

O nome da execução da avaliação.

--mcs-connection-id

A ID de conexão do conector MCS usado para executar a execução de avaliação ou deixar vazia para uma execução anônima.

--run-on-published-bot

Indica se a operação deve ser executada em uma instância de bot publicada. Se definido como false, a operação será executada em uma instância de bot de rascunho.

--tools-connections

As conexões de ferramentas que serão usadas para executar a execução de avaliação. Esta é uma lista de ferramentas junto com as conexões de usuário correspondentes que devem ser usadas para cada ferramenta. Forneça o valor como uma matriz JSON.

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

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Conjunto de Testes de Avaliação do Run Maker.

pac copilot-studio set-bot-as-quarantined

(Versão prévia) Defina o status de quarentena de um bot como true.

Parâmetros necessários para copilot-studio set-bot-as-quarantined

--bot-id

A ID do bot.

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

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

set-bot-as-quarantined Observações

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Definir Bot como Em Quarentena.

pac copilot-studio set-bot-as-unquarantined

(Versão prévia) Defina o status de quarentena de um bot como false.

Parâmetros necessários para copilot-studio set-bot-as-unquarantined

--bot-id

A ID do bot.

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

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

set-bot-as-unquarantined Observações

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Definir o Bot como Intransigido.

(Versão prévia) Defina a configuração de bypass de consentimento do conector de administrador para um bot.

--admin-consent-bypass

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

--bot-id

A ID do bot.

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

Você também pode invocar esse comando usando os Bots de API REST do Power Platform – Definir Bypass de Consentimento do Conector.

Consulte também

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

  • Última atualização em