Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os agentes usam ferramentas e conhecimento para realizar ações em nome de usuários e coletar informações contextuais relevantes. Essas ferramentas e fontes de conhecimento costumam ser armazenadas em sistemas externos, como Microsoft Dataverse, Microsoft SharePoint ou outras APIs. Para ter acesso seguro a esses recursos, os agentes precisam se autenticar para estabelecer conexões. O agente pode usar a autenticação do autor do agente ou a autenticação do usuário, dependendo do cenário.
No Microsoft Copilot Studio, as conexões são usadas para ter acesso seguro a serviços autenticados de ferramentas e conhecimento. Você pode criar conexões com várias fontes de dados, como o Microsoft Dataverse, o Microsoft SharePoint ou as APIs externas.
Exibir e gerenciar conexões de agente
No Copilot Studio, você pode exibir e configurar as conexões usadas pelo agente na página Configurações de Conexão.
Na página Configurações de conexão, você pode configurar e gerenciar as conexões usadas pelo agente. Você pode exibir conexões existentes, criar novas e editar ou desconectá-las conforme necessário.
Exibir conexões na página Configurações de Conexão
Navegue até a página do agente no Copilot Studio selecionando Agentes e o agente que você deseja analisar.
A página de visão geral do agente é aberta.
Selecione Configurações para abrir a página Configurações do agente.
No painel de navegação esquerdo, selecione Configurações da Conexão.
Uma lista é exibida em uma tabela com todas as conexões associadas ao agente. Para cada conexão, você pode exibir o nome, as ferramentas e o conhecimento usando a conexão, o status da conexão e a data na qual a conexão foi atualizada pela última vez.
Conexões do filtro
Se tiver muitas conexões no agente, você poderá filtrar para obter uma exibição mais restrita e encontrar a conexão com a qual deseja lidar. Você pode aplicar filtros diferentes para exibir conexões com base no status, como Ativado/Desativado, Conectado/Não Conectado, Desativado, Expirado ou Erro de Conexão.
Selecione ou crie uma conexão
Em Status para a entrada de conexão na lista, selecione Gerenciar para abrir o painel Criar ou escolher uma conexão.
Abra a configuração Conexão. Escolha uma conexão existente na lista ou selecione Criar nova conexão para criar uma nova.
Se você selecionar Criar nova conexão, um painel de configuração da conexão abrirá. Conforme necessário, talvez seja solicitada a entrada no serviço ou você deva fornecer informações adicionais para concluir a configuração da conexão.
Quando terminar, selecione Enviar para salvar as alterações.
A conexão agora está associada ao agente, e ele pode usar a conexão para ter acesso às ferramentas e ao conhecimento.
Configurar parâmetros de conexão
Em Gerenciar para a entrada da conexão na lista, selecione Consultar detalhes para exibir mais detalhes sobre a conexão.
As informações são exibidas em duas guias:
- Detalhes: exibe o nome da conexão, a descrição, o status e os detalhes da criação.
- Parâmetros da conexão: exibe os parâmetros da conexão, como detalhes da autenticação, chaves de API ou outras informações necessárias, além de permite configurar os detalhes.
Compartilhar parâmetros de conexão para autenticação Em nome de (OBO)
Para algumas conexões compatíveis com Logon único (SSO), você pode configurar a conexão para usar a autenticação em nome do usuário (OBO). Em um fluxo OBO, o usuário delega o agente para usar os parâmetros de conexão compartilhada com o serviço em nome do usuário. Isso é útil quando o agente precisa ter acesso a recursos que exijam permissões específicas do usuário ou quando ações precisam ser realizadas no contexto da identidade do usuário.
Habilitar compartilhamento de parâmetros para OBO
Em Parâmetros da conexão para a entrada de conexão na lista, você pode permitir ao usuário autorizar o compartilhamento dos parâmetros da conexão específicos.
Em Parâmetros da conexão, ative Permitir permissão para compartilhar parâmetros.
Marque as caixas de seleção dos parâmetros que você deseja permitir que o usuário compartilhe.
O usuário é solicitado a conceder permissão para esses parâmetros quando o agente usa autenticação em nome do usuário.
Experiência do usuário para autenticação em nome do usuário
Quando o agente usa autenticação em nome do usuário, o usuário é solicitado a conceder permissão para que o agente use os parâmetros da conexão. O usuário pode optar por permitir ou negar essa permissão. Se o usuário permitir, o agente poderá ter acesso a recursos e realizar ações em nome do usuário. O agente se conecta ao serviço de maneira transparente usando os parâmetros de conexão compartilhada.