Reatribuir a propriedade de agentes órfãos com a API do Power Platform

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

A reatribuição da propriedade de agentes órfãos faz parte do framework de segurança mais amplo do Copilot Studio e funciona em conjunto com sua abordagem geral de segurança no Copilot Studio.

Por exemplo, quando o proprietário original de um agente deixa a organização ou muda de função, isso pode levar a agentes órfãos que não têm uma gestão adequada. Essa situação pode interromper processos de negócios e criar riscos de segurança, já que pode não haver uma parte responsável para gerenciar as configurações e os requisitos de conformidade do agente. Os administradores podem usar a API Reassign para reatribuir a propriedade desses agentes órfãos, garantindo que permaneçam devidamente gerenciados e em conformidade.

Usuários e criadores de agentes no Copilot Studio podem ver agentes que são realocados. O novo proprietário obtém permissões de criador de ambiente no ambiente do bot. O antigo proprietário perde o acesso ao agente após a realocação.

Importante

O powervirtualgents namespace está obsoleto. Use o copilotstudio namespace nas suas chamadas de API.

Pré-requisitos

  • Você tem a ID do bot e a ID do ambiente para o agente de destino.
  • Você deve obter um token de acesso de usuário emitido pelo Microsoft Entra ID OAuth2. Para obter um token, consulte Autenticação.
    • Para reatribuir o proprietário de um agente criado em Copilot Studio, o usuário associado ao token deve ter uma das seguintes funções de administrador:
      • Administrador global de locatários
      • 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 um dos seguintes papéis de administrador:
      • Administrador global de locatários
      • Administrador de IA
      • Administrador do Power Platform
    • Você deve adquirir o token de acesso usando o ID do cliente de um registro de aplicativo que tenha o escopo CopilotStudio.AdminActions.Invoke concedido pela API do Power Platform.
  • Você tem o ID de usuário do Entra do novo proprietário, para quem a propriedade do agente precisa ser reatribuída.
  • O novo proprietário deve pertencer ao inquilino.

Operações de API para reatribuição da propriedade do agente

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

Note

A API Reassign não dá 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 propriedade de um agente para um novo proprietário

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

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

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

  • Propósito: Trocar o dono do agente

  • Resposta: Sem conteúdo

  • Last updated on