Reatribua a propriedade de agentes órfãos usando a API do Power Platform

O Copilot Studio oferece aos administradores ferramentas robustas para gerenciar a segurança e a conformidade dos agentes, incluindo a capacidade de reatribuir a propriedade de agentes órfãos por meio da API do Power Platform.

A reatribuição da propriedade de agente órfãos faz parte da estrutura de segurança mais abrangente do Copilot Studio e funciona com a abordagem de segurança geral no Copilot Studio.

Por exemplo, quando o proprietário original de um agente deixa a organização ou muda de função, isso pode resultar em agentes órfãos que não possuem uma gestão adequada. Essa situação pode interromper processos empresariais e gerar riscos de segurança, já que pode não haver um responsável para gerenciar as configurações e os requisitos de conformidade do agente. Os administradores podem usar a API de reatribuição para reatribuir a propriedade desses agentes órfãos, a fim de garantir que continuem sendo gerenciados adequadamente e em conformidade.

Usuários e criadores de agentes no Copilot Studio podem ver agentes que estão reatribuídos. O novo proprietário obtém permissões do criador de ambiente no ambiente do agente. O antigo proprietário perde o acesso ao agente após a reatribuição. Após a reatribuição da propriedade de um agente, se o novo proprietário tiver a permissão leitura de transcrições, ele poderá acessar todas as transcrições existentes do agente.

Importante

O namespace powervirtualgents foi preterido. Use o namespace copilotstudio em suas chamadas de API.

Pré-requisitos

  • Você tem a ID do Bot e a ID do Ambiente para o agente de destino.
  • É necessário obter um token de acesso de usuário emitido pelo OAuth2 do Microsoft Entra ID. Para obter um token, consulte Autenticação.
    • Para reatribuir o proprietário de um agente criado no Copilot Studio, o usuário associado ao token deve ter uma das seguintes funções de administrador:
      • Administrator de locatário global
      • Administrador de IA
      • Administrador do Power Platform
      • Administrador de ambiente
    • Para reatribuir o proprietário de um agente criado no Agent Builder, o usuário associado ao token deve ter uma das seguintes funções de administrador:
      • Administrator de locatário global
      • Administrador de IA
      • Administrador do Power Platform
    • Você deve adquirir o token de acesso usando a ID do cliente de um registro do aplicativo que tenha o escopo CopilotStudio.AdminActions.Invoke concedido pela API do Power Platform.
  • Você tem a ID de usuário do Entra do novo proprietário para o qual a propriedade do agente precisa ser reatribuída.
  • O novo proprietário deve pertencer ao locatário.

Operações de API para reatribuição de propriedade de agentes

O Copilot Studio dá suporte à operação da API REST reassign para reatribuir agentes órfãos a novos proprietários, como parte da API do Power Platform.

Observação

A Reatribuir API não oferece suporte a chatbots clássicos. A API retorna 405 Method Not Allowed quando você tenta reatribuir a propriedade de um chatbot clássico.

Para obter mais informações sobre como e quando usar a API do Power Platform, consulte:

Reatribuir a responsabilidade por um agente a um novo responsável

  • Ponto de extremidade: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botAdminOperations/reassign?api-version=1

  • Corpo:: {"NewOwnerAadUserId": "EntraUserId"}

    Substitua EntraUserId pela ID de usuário do Entra do novo proprietário.

  • Propósito: alterar o proprietário do agente

  • Resposta: sem conteúdo

  • Last updated on