Conecte-se ao Foundry IQ por meio de um agente

O Foundry IQ conecta seu agente a uma base de conhecimento construída no Fábrica de IA do Azure. Uma base de conhecimento do Foundry IQ reúne uma ou mais fontes de dados empresariais junto com configurações de recuperação e relevância em um único ativo reutilizável. Quando você se conecta a uma base de conhecimento que alguém da sua organização já construiu e otimizou, seu agente pode responder perguntas sobre esse conteúdo sem que você precise recriar a configuração no Copilot Studio.

O Foundry IQ é adicionado ao seu agente como uma ferramenta pelo botão Ferramentas do painel de componentes.

Note

Os recursos deste artigo são usados por agentes ou fluxos de trabalho alimentados pelo GitHub Copilot.

A cobrança por uso se aplica ao uso, criação, teste e avaliação de agentes. Essas ações podem consumir Créditos do Copilot. Saiba mais em Gerenciar os custos de agentes viabilizados pelo GitHub Copilot harness.

Você se conecta ao Foundry IQ quando:

  • Uma equipe da sua organização já construiu e ajustou uma base de conhecimento no Fábrica de IA do Azure que se encaixa no domínio do seu agente.
  • Você quer que seu agente use a configuração de recuperação de informações dessa equipe em vez de você mesmo modelar o conhecimento no Copilot Studio.

Pré-requisitos

  • Um agente criado com a estrutura do GitHub Copilot. Saiba mais em Criar um agente.
  • Acesso a pelo menos uma base de conhecimento do Foundry IQ, concedida no Fábrica de IA do Azure. Apenas as bases de conhecimento às quais você tem acesso aparecem no seletor.

Note

Cada agente pode ter apenas uma conexão com o Foundry IQ.

Crie uma nova conexão do Foundry IQ

  1. Abra seu agente no Copilot Studio.
  2. Selecione a guia Compilar.
  3. No painel de componentes, selecione Ferramentas para abrir o diálogo Adicionar uma ferramenta .
  4. Selecione Foundry IQ.
  5. Selecione Criar nova ligação.
  6. Selecione o tipo de autenticação: chave API, Autenticação de Certificado do Cliente, Principal de Serviço (aplicação Microsoft Entra ID) ou Microsoft Entra ID Integrado.
    1. Em API Key, insira o endpoint e a chave de API do Foundry IQ Search Service.
    2. Para a Autenticação do Certificado do Cliente, insira o endpoint do Foundry IQ Search Service, o ID do inquilino, o ID do cliente, o segredo do certificado do cliente e a senha do certificado.
    3. Para o principal de serviço, insira o endpoint do Foundry IQ Search Service, o ID do tenente, o ID do cliente e o segredo do cliente.
    4. Para Microsoft Entra ID Integrated, insira o endpoint do Foundry IQ Search Service.
  7. Selecione Criar.
  8. A conexão é criada, então selecione Próximo.
  9. Selecione uma base de conhecimento da lista e então selecione Adicionar ao agente.
  10. Clique em Salvar.
  11. Depois de salvar, a seção Ferramentas da aba Build mostra a conexão do Foundry IQ como uma ferramenta conectada.
  12. Selecione a conexão recém-adicionada do Foundry IQ e atualize o nome e a descrição. A descrição deve ser o mais detalhada possível, pois ela auxilia na orquestração.
  13. Clique em Salvar.

Teste sua fonte de conhecimento sobre o QI da Foundry

  1. Selecione a aba Prévia.
  2. Envie uma pergunta de teste que a base de conhecimento deveria conseguir responder.
  3. Abra o rastreamento de atividade para a resposta.

O rastreamento de atividade mostra que a Foundry IQ cuidou da etapa de recuperação e lista os itens que devolveu ao seu agente. Seu corretor usa esses itens para compor sua resposta. Se o rastreamento não mostrar uma etapa de recuperação de QI do Foundry, confirme que a base de conhecimento está selecionada na aba Build e que a pergunta está dentro do escopo dos dados que a base de conhecimento cobre.

Dica

Se os resultados não forem os que você espera, ajuste a base de conhecimento em si no Fábrica de IA do Azure, não no Copilot Studio. Trabalhe com o dono do banco de conhecimento para ajustar fontes, instruções de recuperação ou ranking.

Remover uma conexão do Foundry IQ

  1. Na aba Build , selecione Ferramentas.
  2. No painel de componentes, selecione a base de conhecimento Foundry IQ conectada e selecione o x para remover a conexão.

Note

Remover uma conexão no Copilot Studio não exclui nem altera a base de conhecimento no Fábrica de IA do Azure.

  • Last updated on