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 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áx. gerados: refere-se ao número de partes retornadas por contextualização de uma 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 filtrar 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: Selecionar essa opção para habilitar a síntese e recuperação avançadas de vários documentos.Para obter detalhes, consulte Usando 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 atualmente.