Contexto

Uso de índices em agentes

Os índices dão aos agentes acesso a bases de conhecimento com permissão. Isso ajuda os agentes a raciocinar usando dados específicos de negócios. Para obter orientação sobre o aproveitamento eficaz do contexto, consulte Melhores práticas para engenharia de contexto.

Para configurar um modelo personalizado para funcionalidades de Contextualização, consulte Configuração de LLMs.

Para adicionar contexto ao seu agente, siga as etapas a seguir na seção Contextos:

1. Selecionar Adicionar contexto.
2. Selecione um índice na lista disponível ou Criar um novopara criar um novo índice no Orchestrator. Para obter detalhes, consulte Índices.
3. Forneça uma Descrição para o seu contexto.
4. Configure a Estratégia de Pesquisar usando o painel de propriedades. Você pode controlar o tipo de consulta, a precisão e a relevância do contexto usando as seguintes configurações:
   • Semântica: selecione esta opção para consultas semânticas se você estiver usando fontes de dados de texto.
     • Limiar de pontuação de relevância: refere-se a um limiar de pontuação de similaridade aplicado após a recuperação e a reclassificação de partes relevantes. Quaisquer partes relevantes pontuadas abaixo desse limiar não são retornadas. Use esse campo para tornar os resultados mais precisos. À medida que esse número aumenta, a contextualização filtra e fundamenta solicitações apenas com as melhores pontuações.
     • Resultados máximos gerados: refere-se ao número de partes retornadas pela contextualização a partir da consulta de um usuário. Isso ajuda a tornar a carga de fundamentação da geração de LLM (tamanho geral do token da chamada de LLM) menor e pode ajudar a atuar como um filtro adicional nos resultados que você obtém da Contextualização. O aumento do número de resultados aumenta a quantidade de partes retornadas.
     • Consulta – A consulta para a estratégia de pesquisa. Esse campo é compatível com valores estáticos, modos Estático, Argumento, Dinâmico.
   • Estruturado (Visualização): selecione essa opção para consultas estruturadas se estiver usando fontes de dados tabulares. Suporta o formato de dados CSV.
   • DeepRAG: selecione esta opção para habilitar a síntese e recuperação avançadas de vários documentos. Para obter detalhes, consulte Como usar o DeepRAG.
     • Habilitar citações – habilitar para citações para consultas DeepRAG.
     • Solicitação – A solicitação para a consulta do DeepRAG. Esse campo é compatível com valores estáticos, modos Estático, Argumento, Dinâmico.
5. Limite o escopo da pesquisa usando as seguintes configurações:
   • Prefixo do caminho de pasta – Use esse campo para especificar o caminho da pasta onde seus documentos de destino são armazenados. Você pode inserir manualmente um caminho estático, como /documents/project, ou usar um argumento dinâmico, permitindo que o agente pesquise diferentes pastas com base em entradas do runtime.
   Observação:

   Por padrão, apenas arquivos localizados diretamente na pasta especificada são indexados. Os arquivos armazenados em subpastas não são incluídos automaticamente. Para incluir arquivos de subpastas, acrescente /** ao caminho (por exemplo, /documents/project/**). Se os arquivos em subpastas não estiverem incluídos, você pode ver o seguinte erro: "Nenhum arquivo válido para usar para DeepRAG. Atualize e ressincronize seu índice ou use um padrão de correspondência diferente."

   • Extensão do arquivo – Selecione os tipos de arquivo contidos no índice. Para o DeepRAG, apenas arquivos PDF são compatíveis.