Controlar como os agentes são compartilhados

Você pode controlar e limitar como os agentes são compartilhados em seu locatário aplicando as atribuições de permissão Editor e Visualizador a indivíduos que precisam acessar o Copilot Studio e, em seguida, configurando as permissões para quem pode compartilhar com quem.

Você configura os limites de compartilhamento para agentes como um controle de Ambientes Gerenciados no Centro de administração do Power Platform. Você pode configurar esses controles para um Ambiente Gerenciado individual ou pode aplicar os controles de compartilhamento em escala usando Grupos e Regras no centro de administração do Power Platform.

Note

As regras de compartilhamento são aplicadas quando os usuários tentam compartilhar um aplicativo, fluxo ou agente. Essa imposição não afeta os usuários que já têm acesso ao aplicativo, fluxo ou agente antes de aplicar as regras. No entanto, se um aplicativo, fluxo ou agente ficar fora de conformidade depois que as regras forem definidas, só será possível parar de compartilhá-lo. O compartilhamento se torna possível novamente quando o aplicativo, fluxo ou agente está em conformidade com as novas regras.

Depois que as regras de compartilhamento são definidas no centro de administração do Power Platform, pode levar até uma hora para que elas comecem a ser aplicadas.

Os limites de compartilhamento só se aplicam a agentes que exigem autenticação. Saiba mais em Configurar autenticação de usuário.

As regras de compartilhamento nos ambientes do Dataverse for Teams não afetam o compartilhamento com uma equipe do Teams quando você publica um agente no Teams. No entanto, quando um usuário tenta compartilhar um agente com indivíduos ou grupos em uma equipe diferente daquela vinculada ao ambiente, os limites de compartilhamento são impostos.

Saiba mais sobre como definir limites de compartilhamento para apps de tela, fluxos e agentes em Limitar compartilhamento na documentação de administrador do Power Platform.

Use as funções Editor e Visualizador para controlar o compartilhamento

Ao definir controles de compartilhamento no Centro de administração do Power Platform, você pode impor como criadores compartilham atribuições de Editor ou Visualizador com outros indivíduos para seus agentes no Copilot Studio. Saiba mais sobre configurar atribuições no Limit sharing na documentação de administrador do Power Platform.

O restante deste artigo descreve como as atribuições afetam quem pode compartilhar e como.

Importante

As permissões de Editor só podem ser dadas a usuários individuais.

Não é possível conceder permissões de Editor a grupos de segurança.

A atribuição Editor permite que os criadores editem, configurem, compartilhem e publiquem seu conteúdo, enquanto os criadores com a atribuição Visualizador só podem conversar com o agente.

Regras de compartilhamento	Comportamento do sistema quando selecionado	Quando não selecionado
Permitir que as pessoas concedam permissões de Editor ao compartilhar agentes	Pode compartilhar com qualquer indivíduo designado como Editor.	Não é possível compartilhar com um indivíduo atribuído como Editor. Este controle não afeta a capacidade de proprietários ou editores compartilharem com visualizadores.
Permitir que as pessoas concedam permissões de Visualizador quando os agentes forem compartilhados	Pode compartilhar com qualquer indivíduo atribuído como Visualizador e quaisquer grupos de segurança.	Não é possível compartilhar com um indivíduo atribuído como um Visualizador. O proprietário ou qualquer outro editor não pode compartilhar com um grupo de segurança. Esse controle não impede que proprietários/editores compartilhem seus agentes com indivíduos na função de editores.
Compartilhar somente com indivíduos (não com grupos de segurança)	Os proprietários/editores só podem compartilhar com indivíduos que estão designados como Visualizador. Eles não podem compartilhar com um grupo de segurança.	Editores e proprietários podem compartilhar com indivíduos (atribuídos como um Visualizador) e grupos de segurança.
Limitar o número de visualizadores que podem acessar cada agente	Se a opção Somente compartilhar com indivíduos (sem grupos de segurança) estiver selecionada, você poderá controlar o número máximo de visualizadores com os quais um agente pode ser compartilhado.	Não há limite para o número de pessoas com quem você pode compartilhar.

Controle o compartilhamento de agentes que utilizam credenciais fornecidas pelo fabricante

Quando os makers adicionam ferramentas a um agente, eles podem configurar conexões para usar suas próprias credenciais em tempo de execução. Quando um agente usa tal conexão, outros usuários do agente podem realizar operações usando as permissões associadas às credenciais do criador.

Administradores podem usar a configuração de Compartilhamento de agentes com credenciais de maker incorporadas no centro de administração do Power Platform para impedir que agentes sejam compartilhados quando contêm conexões configuradas para usar credenciais maker que outros usuários não têm permissão para reutilizar. A conexão subjacente determina se o agente pode ser compartilhado ou reutilizado.

Quando você aplica essa configuração, o Copilot Studio avalia as conexões usadas por um agente e pode impedir que o agente seja compartilhado ou publicado quando uma conexão viola a política de compartilhamento de conexões da organização.

Importante

Essa configuração afeta conexões que usam credenciais fornecidas pelo fabricante. Conexões configuradas para usar credenciais de usuário final não estão sujeitas a essa restrição de compartilhamento de conexão, pois cada usuário se autentica usando sua própria conexão em tempo de execução.

Saiba mais sobre agentes de compartilhamento de controle com credenciais de fabricante embarcadas e Agente de Compartilhamento com credenciais de fabricante incorporadas (prévia).

O que acontece quando a política é aplicada

O Copilot Studio verifica se um agente usa uma conexão de criador que você não pode compartilhar. O comportamento depende de como o agente e suas conexões estão configurados.

Comportamento do agente ao compartilhar

Você não pode compartilhar um agente que viole uma política de segurança de compartilhamento de conexão com um usuário que tenha acesso de visualizador ou de usuário final.

Da mesma forma, você não pode compartilhar o agente com todos na sua organização para acesso por usuários finais.

A experiência de compartilhamento exibe uma mensagem de erro e identifica o alvo afetado.

Comportamento do agente ao publicar

A publicação também é bloqueada quando um agente contém uma conexão que viola a política de compartilhamento de conexão. Para agentes autenticados, um agente que você não compartilhou pode publicar com sucesso, enquanto um agente que você já compartilhou com outro usuário é bloqueado de publicar quando a aplicação for aplicada.

Quando o Copilot Studio detecta uma condição de bloqueio antes da publicação, a opção Publicar fica indisponível e os criadores são orientados a revisar o status do agente.

Status do agente

O Copilot Studio revela violações de compartilhamento de conexão no status do Agente. Para um agente autenticado não compartilhado por você, aparece um aviso indicando quantas conexões violam a política de compartilhamento de conexões do administrador.

Para um agente que você já compartilhou, a validação reporta a violação como um erro crítico.

Ferramentas que violam a política

Os criadores podem ver quais ferramentas são afetadas. Essas ferramentas são marcadas como Bloqueadas com uma mensagem de violação de política de Compartilhamento explicando que uma conexão viola a política de compartilhamento de conexão do administrador.

Se uma ferramenta também for restrita por uma política de dados, o Copilot Studio exibe a mensagem Data policy violation em vez disso.

Resolver um conflito de compartilhamento de conexão

Se o Copilot Studio identificar uma ferramenta ou conexão que viole uma política, o criador deve alterar a configuração do agente antes que o agente possa ser compartilhado.

Para ferramentas que suportam isso, configurar a conexão para usar credenciais do usuário final evita reutilizar as credenciais do criador. Cada usuário final, em vez disso, faz login com suas próprias credenciais em tempo de execução.

Informações relacionadas

• Visão geral de ambientes gerenciados na documentação de administrador do Power Platform
• Limitar compartilhamento na documentação de administrador do Power Platform