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

Copilot Studio fornece aos administradores ferramentas robustas para gerir a segurança e conformidade dos agentes, incluindo a capacidade de reatribuir a propriedade de agentes órfãos através da API 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 levar a agentes órfãos que não têm uma gestão adequada. Esta situação pode perturbar os processos de negócio e criar riscos de segurança, pois pode não haver uma parte responsável para gerir as definições e os requisitos de conformidade do agente. Os administradores podem usar a API de Reatribuição 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 agentes que são reatribuídos. O novo proprietário obtém permissões de criador de ambiente no ambiente do agente. O antigo proprietário perde o acesso ao agente após a reatribuição. Após a transferência de propriedade de um agente, se o novo proprietário tiver o privilégio de ler transcrições , pode aceder a todas as transcrições existentes do agente.

Importante

O espaço de nomes powervirtualgents foi preterido. Use o copilotstudio namespace nas suas chamadas de 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 deve ter uma das seguintes funções administrativas:
      • Administrador global de inquilinos
      • Administrador de IA
      • Administrador do Power Platform
      • Administrador de ambiente
    • Para reatribuir o proprietário de um agente criado no Agent Builder, o utilizador associado ao token deve ter um dos seguintes papéis de administrador:
      • Administrador global de inquilinos
      • 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 deve pertencer ao inquilino.

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

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

Note

A API Reassign não suporta chatbots clássicos. A API regressa 405 Method Not Allowed quando tentas reatribuir a propriedade de um chatbot clássico.

Para obter mais informações sobre como e quando usar a API da 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: Mudar o proprietário do agente

  • Resposta: Sem conteúdo

  • Last updated on