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

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

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

Por exemplo, quando o proprietário original de um agente sai da organização ou muda de funções, isso pode resultar em agentes órfãos que ficam sem uma gestão adequada. Esta situação pode perturbar os processos de negócio e criar riscos de segurança, uma vez que pode não existir uma parte responsável por gerir as definições e os requisitos de conformidade do agente. Os administradores podem utilizar a API Reatribuir para reatribuir a propriedade destes agentes órfãos, garantindo que permanecem devidamente geridos e em conformidade.

Os utilizadores e criadores de agentes no Copilot Studio podem ver os agentes que são reatribuídos. O novo proprietário obtém permissões de criador de ambientes no ambiente do agente. O antigo proprietário deixa de poder aceder ao agente após a reatribuição. Após a reatribuição da propriedade de um agente, se o novo proprietário tiver o privilégio de Leitura de transcrições, pode aceder a todas as transcrições existentes do agente.

Importante

O espaço de nomes powervirtualgents foi preterido. Use o espaço de nomes copilotstudio nas suas chamadas à API.

Pré-requisitos

  • Tem o ID do Bot e o ID do Ambiente para o agente de destino.
  • Deve obter um token de acesso de utilizador emitido pelo Microsoft Entra ID OAuth2. Para obter um token, consulte Autenticação.
    • Para reatribuir o proprietário de um agente criado no Copilot Studio, o utilizador associado ao token tem de ter uma das seguintes funções de administrador:
      • Administrador de inquilinos do Azure
      • Administrador de IA
      • Administrador do Power Platform
      • Administrador do ambiente
    • Para reatribuir o proprietário de um agente criado no Construtor de Agentes, o utilizador associado ao token tem de ter uma das seguintes funções de administrador:
      • Administrador de inquilinos do Azure
      • Administrador de IA
      • Administrador do Power Platform
    • Tem de adquirir o token de acesso utilizando o ID de cliente de um registo de aplicação ao qual tenha sido concedido o âmbito CopilotStudio.AdminActions.Invoke concedido na API do Power Platform.
  • Tem o ID de utilizador do Entra do novo proprietário a quem a propriedade do agente deve ser reatribuída.
  • O novo proprietário tem de pertencer ao inquilino.

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

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

Nota

A API Reatribuir não suporta chatbots clássicos. A API devolve 405 Method Not Allowed quando tenta reatribuir a propriedade de um chatbot clássico.

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

Reatribuir a propriedade de um agente a um novo proprietário

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

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

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

  • Objetivo: Alterar o proprietário do agente

  • Resposta: Sem conteúdo

  • Last updated on