Configurar e gerir ligações

Os agentes utilizam ferramentas e conhecimento para realizar ações em nome dos utilizadores e recolher informação contextual relevante. Estas ferramentas e fontes de conhecimento são frequentemente armazenadas 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. O agente pode utilizar a autenticação do autor do agente ou a autenticação do utilizador, dependendo do cenário.

No Microsoft Copilot Studio, as ligações são utilizadas para aceder de forma segura a serviços autenticados para ferramentas e conhecimento. Pode criar ligações a várias origens de dados, como Microsoft Dataverse, Microsoft SharePoint ou APIs externas.

Ver e gerir ligações de agentes

No Copilot Studio, pode ver e configurar as ligações utilizadas pelo seu agente na página Definições de Ligação.

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

Ver ligações na página Definições de Ligação

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

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

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

3. No painel de navegação à esquerda, 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 o respetivo nome, as ferramentas e os conhecimentos que utilizam a ligação, o estado da ligação e a data em que a ligação foi atualizada pela última vez.

Filtrar ligações

Se tiver muitas ligações no seu agente, poderá filtrar para obter uma vista mais restrita e localizar a ligação com a qual pretende lidar. Pode aplicar diferentes filtros para ver ligações com base no estado, como Ativado/Desativado, Ligado/Não Ligado, Desativado, Expirado ou Erro de Ligação.

Selecionar ou criar uma ligação

1. Em Estado para a entrada de ligação na lista, selecione Gerir para abrir o painel Criar ou escolher uma ligação.

2. Abra a configuração da Ligação. Escolha uma ligação existente na lista ou selecione Criar nova ligação para criar uma nova.

   Se selecionar Criar nova ligação, o painel de configuração é aberto. Se necessário, poderá ser-lhe pedido que inicie sessão no serviço ou que forneça informações adicionais para concluir a configuração da ligação.

3. Quando terminar, selecione Submeter para guardar as alterações.

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

Configurar parâmetros de ligação

Em Gerir para a entrada da ligação na lista, selecione Ver detalhes para ver mais detalhes sobre a ligação.

A informação é apresentada em dois separadores:

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

Partilhe parâmetros de ligação para a autenticação OBO (On-Behalf-Of)

Para algumas ligações que suportam o Início de Sessão Único (SSO), pode definir a ligação para utilizar a autenticação OBO (On-Behalf-Of). 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. Isto é útil quando o agente precisa de aceder a recursos que exigem permissões específicas do utilizador ou quando é necessário realizar ações no contexto da identidade do utilizador.

Ativar a partilha de parâmetros para OBO

Em Parâmetros de ligação para a entrada de ligação na lista, pode permitir que o utilizador autorize a partilha de parâmetros específicos de ligação.

1. Em Parâmetros de ligação, ative Permitir permissão para partilhar parâmetros.

   

2. Selecione as caixas de verificação dos parâmetros que pretende permitir que o utilizador partilhe.

   É 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 utiliza autenticação OBO, é pedido ao utilizador que conceda permissão ao agente para utilizar os seus parâmetros de ligação. O utilizador pode escolher permitir ou negar esta permissão. Se o utilizador permitir, o agente pode aceder a recursos e realizar ações em nome do utilizador. O agente liga-se ao serviço de forma transparente utilizando os parâmetros de ligação partilhados.

Conteúdos relacionados

• Configurar a autenticação OBO para conectores personalizados