Conectar um agente ao Foundry IQ

Depois de criar uma base de dados de conhecimento, um agente ou aplicativo pode usá-la para recuperar informações relevantes. As bases de conhecimento do Foundry IQ podem ser usadas pelo Foundry Agent Service, pelo Microsoft Agent Framework ou por aplicativos personalizados que chamam as APIs de base de conhecimento do Pesquisa de IA do Azure .

Conectar um agente a uma base de dados de conhecimento

As bases de dados de conhecimento do IQ da Foundry expõem uma ferramenta MCP (Model Context Protocol) para integração de agente. O MCP fornece uma maneira padrão para um agente chamar a base de dados de conhecimento. Um fluxo de trabalho típico do Foundry é:

1. Em um projeto do Foundry, crie ou conecte-se a um serviço de Pesquisa de IA do Azure que ofereça suporte à recuperação por meio de agentes.
2. Crie uma base de dados de conhecimento e adicione fontes de conhecimento apropriadas.
3. Crie ou selecione um agente com um modelo implantado.
4. Adicione ao agente a conexão com a base de conhecimento como uma ferramenta MCP.
5. Defina instruções que informem ao agente quando e como usar a base de dados de conhecimento.
6. Faça perguntas de teste e analise respostas, citações e a atividade das ferramentas no playground.

A conexão do projeto deve usar uma identidade apropriada e ter apenas as permissões necessárias para recuperar o conteúdo.

Escreva instruções para respostas fundamentadas

Conectar uma base de dados de conhecimento não garante que um agente a use consistentemente. As instruções do agente devem indicar o comportamento esperado. Por exemplo:

Use a base de dados de conhecimento para responder às perguntas da política de despesas. Base as alegações factuais no conteúdo recuperado e cite as fontes de apoio. Se a base de dados de conhecimento não contiver informações suficientes, diga que você não sabe em vez de adivinhar.

Instruções eficazes definem:

• Quando recuperar: identifique as perguntas ou domínios que exigem a base de dados de conhecimento.
• Como usar evidências: Exija que as respostas permaneçam fundamentadas no conteúdo recuperado.
• Como citar: peça referências de origem que os usuários podem inspecionar.
• O que fazer quando as evidências estão ausentes: diga ao agente para reconhecer a incerteza ou encaminhar o usuário para uma pessoa ou processo apropriado.

Testar e melhorar a experiência

Teste o agente enriquecido com conhecimento com perguntas realistas antes de usá-lo em produção. Inclua:

• Perguntas simples com uma fonte clara.
• Perguntas que exigem informações de várias fontes.
• Perguntas ambíguas que devem desencadear esclarecimentos.
• Perguntas para as quais a base de dados de conhecimento não tem resposta.
• Perguntas de usuários com permissões de origem diferentes.
• Conteúdo que contém texto que tenta alterar as instruções do agente.

Avalie a recuperação e a resposta final separadamente. Primeiro, verifique se o IQ do Foundry retornou provas relevantes, atuais e autorizadas. Em seguida, verifique se a resposta do agente está bem fundamentada, relevante, completa e com citações corretas. Monitorar esses comportamentos ao longo do tempo ajuda a revelar lacunas de conteúdo, recuperação fraca, problemas de permissão e instruções que precisam de refinamento.