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á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 de arquivo — selecione os tipos de arquivos contidos no índice. Para o DeepRAG, apenas arquivos PDF são compatíveis.

Contexto just-in-time usando arquivos

O contexto just-in-time permite que você forneça arquivos a um agente no runtime sem gerenciar índices de longa duração ou fontes de dados persistentes. Em vez de sincronizar arquivos em um índice permanente, o agente trabalha diretamente com arquivos. Essa abordagem reduz a sobrecarga operacional, melhora o rendimento e evita custos de armazenamento desnecessários. Use o contexto just-in-time sempre que seu caso de uso exigir que o agente trabalhe com arquivos fornecidos no runtime e você não precisar manter os dados indexados posteriormente.

1. Selecione Adicionar contexto e escolha Usar entradas de arquivos. Essa opção está disponível apenas quando os argumentos de tipo de Arquivo são definidos para seu agente no Gerenciador de dados.

2. Use o campo Nome para definir um nome descritivo para o índice de seus arquivos.
3. (Opcional) Em Descrição, documente que tipo de documentos esse contexto fornecerá.
4. Em Arquivos, associe a entrada que contém os arquivos ou anexos (por exemplo, uma matriz de documentos da conversa ou de uma ferramenta).
5. Defina as configurações restantes exatamente como faria para um índice regular.

Durante a execução, o índice temporário é criado, consultado de acordo com sua configuração e, em seguida, descartado. O agente recebe o contexto extraído relevante como parte de seu processo de raciocínio, sem exigir que você gerencie fontes de dados, sincronizações de índices ou limpeza.

Requisitos e limites

Ao usar o contexto just-in-time, aplicam-se as seguintes restrições:

• Anexos de entrada: até 25 anexos por execução, com um tamanho máximo total de 128 MB.
• Tipos de arquivo compatíveis: todos os tipos de arquivo compatíveis com contextualização.
• Formato de saída: corresponde aos formatos de saída padrão de ferramentas de contextualização existentes.
• TTL (período de vida útil): os índices temporários são excluídos automaticamente 24 horas após o último uso. Isso permite a reutilização do mesmo índice durante a depuração sem nova ingestão.
• Até 1.000 índices temporários por tenant podem estar ativos de uma só vez.Uma cota mais alta pode ser solicitada caso a caso.