Liga-te à Foundry IQ através de um agente

O Foundry IQ liga o seu agente a uma base de conhecimento integrada no Azure AI Foundry. Uma base de dados Foundry IQ reúne uma ou mais fontes de dados empresariais juntamente com definições de recuperação e relevância num único ativo reutilizável. Quando se liga a uma base de conhecimento que alguém na sua organização já construiu e afinou, o seu agente pode responder a perguntas sobre esse conteúdo sem que tenha de recriar a configuração no Copilot Studio.

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

Note

As funcionalidades deste artigo são utilizadas por agentes ou fluxos de trabalho suportados pela estrutura do GitHub Copilot.

A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot. Saiba mais em Gerir custos para agentes alimentados pelo harness GitHub Copilot.

Liga-se à Foundry IQ quando:

  • Uma equipa da sua organização já construiu e afinou uma base de conhecimento no Azure AI Foundry que se enquadra no domínio do seu agente.
  • Queres que o teu agente use a configuração de recuperação dessa equipa em vez de modelar o conhecimento tu próprio no Copilot Studio.

Pré-requisitos

  • Um agente criado com a infraestrutura do GitHub Copilot. Saiba mais em Criar um agente.
  • Acesso a pelo menos uma base de conhecimento do Foundry IQ, concedida no Azure AI Foundry. Apenas as bases de conhecimento a que tens acesso aparecem no seletor.

Note

O seu agente só pode ter uma ligação Foundry IQ por agente.

Criar uma nova ligação Foundry IQ

  1. Abra o seu agente no Copilot Studio.
  2. Selecionar o separador Compilação.
  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 Integrated.
    1. Para a API Key, introduza o endpoint do Foundry IQ Search Service e a API key.
    2. Para a autenticação do Certificado do Cliente, introduza o endpoint do Foundry IQ Search Service, o ID do inquilino, o ID do cliente, o segredo do certificado do cliente e a palavra-passe do certificado.
    3. Para Service principal, introduza o endpoint do Foundry IQ Search Service, o ID do inquilino, o ID do cliente e o segredo do cliente.
    4. Para Microsoft Entra ID Integrated, introduza o endpoint do Foundry IQ Search Service.
  7. Selecione Criar.
  8. A ligação é criada e depois seleciona Próximo.
  9. Selecione uma base de conhecimento da lista e depois selecione Adicionar ao agente.
  10. Selecione Guardar.
  11. Depois de gravar, a secção Ferramentas do separador Build mostra a ligação Foundry IQ como uma ferramenta conectada.
  12. Selecione a ligação recém-adicionada ao Foundry IQ e atualize o nome e a descrição. A descrição deve ser o mais detalhada possível, pois facilita a orquestração.
  13. Selecione Guardar.

Teste a sua fonte de conhecimento sobre o QI da Foundry

  1. Selecione o separador Pré-visualização .
  2. Envie uma pergunta de teste que a base de conhecimento deva conseguir responder.
  3. Abra o registo de atividade da resposta.

O registo da atividade mostra que o Foundry IQ executou a etapa de obtenção e lista os itens que devolveu ao agente. O seu agente usa esses itens para redigir a sua resposta. Se o rasto não mostrar uma etapa de recuperação do Foundry IQ, confirme que a base de conhecimento está selecionada no separador Build e que a pergunta se enquadra nos dados abrangidos pela base de conhecimento.

Sugestão

Se os resultados não forem o que espera, ajuste a própria base de conhecimento no Azure AI Foundry, não no Copilot Studio. Trabalhe com o dono da base de conhecimento para ajustar fontes, instruções de recuperação ou classificação.

Remover uma ligação ao Foundry IQ

  1. No separador Compilação, selecione Ferramentas.
  2. No painel de componentes, selecione a base de conhecimento Foundry IQ associada e selecione o x para remover a associação.

Note

Remover uma ligação no Copilot Studio não apaga nem altera a base de conhecimento no Azure AI Foundry.