Configurar e gerir ligações

Os agentes usam ferramentas e conhecimento para executar ações em nome dos usuários e coletar informações contextuais relevantes. Os programadores frequentemente armazenam estas ferramentas e fontes de conhecimento em sistemas externos, como Microsoft Dataverse, Microsoft SharePoint ou outras APIs. Para aceder a estes recursos de forma segura, os agentes precisam de autenticar-se para estabelecer ligações entre si e o sistema externo. O agente pode utilizar a autenticação do autor do agente ou a autenticação do utilizador, conforme o cenário.

No Microsoft Copilot Studio, utiliza-se ligações para aceder de forma segura a serviços autenticados de ferramentas e conhecimento. Você pode criar conexões com várias fontes de dados, como Microsoft Dataverse, Microsoft SharePoint ou APIs externas.

Ver e gerir ligações de agentes

No Copilot Studio, podes ver e configurar as ligações que o teu agente usa na página Connection Settings.

Na página de Definições de Ligação , pode configurar e gerir as ligações que o seu agente utiliza. Pode ver as ligações existentes, criar novas ligações e editá-las ou desligá-las conforme necessário.

Exibir conexões na página Configurações de Conexão

1. Navegue até à página do seu agente no Copilot Studio selecionando Agentes e depois selecionando o agente que quer ver.

   A página de descrição geral do agente é aberta.

2. Selecione Configurações para abrir a página Configurações do agente.

3. Selecione Definições de Ligação.

Uma lista é apresentada numa tabela com todas as ligações associadas ao seu agente. Para cada ligação, pode ver:

• Nome da conexão
• Ferramentas e fontes de conhecimento que utilizam a ligação
• Estado da ligação

Definições de estado da ligação

O estado da ligação indica o estado atual da ligação. Existem vários estados possíveis:

• Ligado: A ligação está ativa, e o agente pode usá-la para aceder à ferramenta ou conhecimento associado.
• Não Ligado: Não há ligação ativa. O agente não pode aceder à ferramenta ou ao conhecimento associado. Precisas de estabelecer uma ligação.
• Desativado: A ligação está desativada, possivelmente por um administrador, e o agente não a está a usar neste momento.
• Expirado: As credenciais de autenticação da ligação estão expiradas e já não são válidas. É necessário reautenticar a ligação para que o agente possa aceder à ferramenta ou conhecimento associado.
• Estagnada: A ligação já não é válida nem utilizável, normalmente porque foi cortada ou com tempo de expiração. Precisa de rever e atualizar ou substituir a ligação para que o agente aceda à ferramenta ou conhecimento associado.

Filtrar ligações

Se tem muitas ligações no seu agente, filtre a lista para encontrar a ligação com que quer lidar. Você pode aplicar filtros diferentes para exibir conexões com base em seu status, como Ativado/Desativado, Conectado/Não Conectado, Desativado, Expirado ou Erro de Conexão.

Selecione ou crie uma ligação individual

1. Em Status para a entrada de ligação na lista, selecione o hiperlink ao lado do status para abrir a janela Criar ou escolher uma ligação.

2. Seleciona ... para abrir a configuração de Ligação .

3. Selecione uma ligação existente da lista ou selecione Adicionar nova ligação para criar uma nova.

   Se selecionares Adicionar nova ligação, abre-se um painel de configuração de ligação. Conforme necessário, você pode ser solicitado a entrar no serviço ou fornecer informações adicionais para concluir a configuração da conexão.

4. Quando terminar, selecione Enviar para salvar as alterações.

   A ligação está agora configurada e associada ao seu agente, e este pode usar a ligação para aceder às ferramentas e conhecimento.

Ver detalhes e configurar parâmetros de ligação

Em Gerenciar para a entrada de conexão na lista, selecione Ver detalhes para ver mais detalhes sobre a conexão.

As informações aparecem em duas abas.

• Detalhes: Exibe o nome da conexão, a descrição, o status e os detalhes da criação.
• Parâmetros de conexão: Exibe os parâmetros de conexão, como detalhes de autenticação, chaves de API ou outras informações necessárias e permite configurar os detalhes.

Partilhe parâmetros de ligação para a autenticação em nome de outro (OBO)

Para algumas ligações que suportam single sign-on (SSO), pode definir a ligação para utilizar a autenticação On-Behalf-Of (OBO). Num fluxo OBO, o utilizador delega ao agente a utilização dos parâmetros de ligação partilhados com o serviço em nome do utilizador. Este método de autenticação é útil quando o agente precisa de aceder a recursos que requerem permissões específicas do utilizador ou quando é necessário realizar ações no contexto da identidade do utilizador.

Habilitar o compartilhamento de parâmetros para OBO

Em Parâmetros de conexão para a entrada de conexão na lista, você pode permitir que o usuário autorize o compartilhamento de parâmetros de conexão específicos.

1. Em Parâmetros de conexão, ative Permitir permissão para compartilhar parâmetros.

   

2. Marque as caixas de seleção para os parâmetros que você deseja permitir que o usuário compartilhe.

   É pedido ao utilizador que conceda permissão para estes parâmetros quando o agente utiliza a autenticação OBO.

Experiência de utilizador para autenticação OBO

Quando o agente usa a autenticação OBO, o usuário é solicitado a conceder permissão para que o agente use seus parâmetros de conexão. O utilizador pode escolher permitir ou negar esta permissão. Se o usuário permitir, o agente poderá acessar recursos e executar ações em nome do usuário. O agente liga-se ao serviço de forma transparente utilizando os parâmetros de ligação partilhados.

Prompts de ligação repetidos ao usar o OAuth 2.0 com as ferramentas Microsoft Graph API

Quando utiliza autenticação OAuth 2.0 , cada utilizador deve iniciar sessão e conceder consentimento. Quando partilhas ou alojas o agente, outros utilizadores ainda não consentiram, e, por isso, veem o cartão Connect.

Para evitar pedidos repetidos, pode tentar uma das seguintes opções de autenticação:

• Ativar a autenticação única (SSO) do Teams com o fluxo on-behalf-of (OBO): Os utilizadores iniciam sessão uma vez no Teams. Não é necessário consentimento extra no chat.

• Usar permissões de aplicação (principal de serviço): O backend faz chamadas ao Microsoft Graph usando credenciais da app. Não é necessário consentimento do utilizador.

• Utilize OAuth SSO genérico para agentes alojados na web: A sua aplicação gere o início de sessão e transfere o token para o agente.

• Conceder consentimento do administrador para os âmbitos delegados: Elimina pedidos de permissão por utilizador. Ainda é necessário um registo inicial.

Conteúdo relacionado

• Configurar a autenticação OBO para conectores personalizados