Contexto

Adicione um índice ou um conjunto de entidades do Data Fabric como contexto de agente e, em seguida, configure sua estratégia de pesquisa, escopo ou tipo de entidade para controlar o que seu agente recupera.

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 um índice como contexto para seu agente, siga as etapas a seguir na seção Contextos :

1. Selecione Adicionar contexto e, em seguida, selecione Índices de contextualização.
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.

Uso de entidades do Data Fabric em agentes

Além de índices, os agentes podem usar entidades do Data Fabric diretamente como contexto. Isso permite que um agente consulte um sistema de registro diretamente dos sistemas empresariais e raciocine sobre os valores atuais sem que você tenha que criar ou manter um índice.

Os tipos de entidade Nativa e Federada são compatíveis para serem adicionados como um contexto. Uma entidade Nativa armazena seus registros no UiPath, enquanto uma entidade Federada não contém dados próprios e lê ao vivo de um sistema externo ou de uma entidade Nativa cada vez que é consultada. Para obter uma comparação completa do que cada tipo suporta, consulte Tipos de entidade. Para obter detalhes sobre como criar e configurar entidades, consulte Criando uma entidade.

Para adicionar uma entidade do Data Fabric definida como contexto para seu agente, siga as etapas a seguir na seção Contextos :

1. Selecione Adicionar contexto e, em seguida, selecione Entidades do Data Fabric.
   Observação:

   Esta visualização exibe somente entidades no nível da pasta.

2. Pesquise e selecione até cinco entidades na lista. As entidades são agrupadas em Na solução atual e Recursos disponíveis, e cada uma mostra um rótulo Nativo ou Federado . Opcionalmente, você pode usar o botão Visualizar para visualizar os detalhes de uma entidade.
3. Selecione Adicionar para adicionar as entidades selecionadas ao seu agente.
   Observação:

   As entidades federadas que se conectam a um sistema externo podem ter parâmetros obrigatórios, dependendo do que o conector desse sistema precisa para ler dados. Se a entidade que você adicionou tiver alguma, seu painel de propriedades as listará. Insira os valores para os parâmetros necessários antes que o agente possa consultar essa entidade.

As entidades aparecem como contexto para seu agente, cada uma carregando seu rótulo Nativo ou Federado e prontas para serem consultadas.