Contextos

Añade un índice o un conjunto de entidades de Data Fabric como contexto de agente y, a continuación, configura su estrategia de búsqueda, ámbito o tipo de entidad para controlar lo que recupera tu agente.

Uso de índices en agentes

Los índices dan acceso a los agentes a bases de conocimiento con permisos. Esto ayuda a los agentes a razonar utilizando datos específicos de la empresa. Para obtener orientación sobre cómo aprovechar el contexto de forma efectiva, consulta Mejores prácticas para ingeniería de contexto.

Para configurar un modelo personalizado para las características de contextualización, consulta Configurar LLM.

Para añadir un índice como contexto para tu agente, sigue los siguientes pasos en la sección Contextos :

1. Selecciona Añadir contexto y luego selecciona Índices de contextualización.
2. Selecciona un índice de la lista disponible o Crear nuevo para crear un nuevo índice en Orchestrator. Para obtener más información, consulta Índices.
3. Proporciona una Descripción para tu contexto.
4. Configura la estrategia de búsqueda utilizando el panel de propiedades. Puedes controlar el tipo de consulta, la precisión y la relevancia del contexto utilizando la siguiente configuración:
   • Semántica: selecciona esta opción para consultas semánticas si utilizas fuentes de datos de texto.
     • Umbral de puntuación de relevancia: se refiere a un umbral de puntuación de similitud aplicado después de recuperar y reclasificar los fragmentos relevantes. No se devolverán los fragmentos relevantes que tengan una puntuación inferior a este umbral. Utiliza este campo para que los resultados sean más precisos. A medida que aumentas este número, Contextualización filtra y contextualiza las solicitudes solo con las mejores puntuaciones.
     • Resultados máximos generados: se refiere al número de fragmentos devueltos por Contextualización a partir de la consulta de un usuario. Esto ayuda a hacer que la carga útil de creacíon de base de la generación de LLM (el tamaño general del token de la llamada al LLM) sea más pequeña y puede ayudar a actuar como un filtro adicional en los resultados que se obtienen de Contextualización. Aumentar el número de resultados incrementa la cantidad de fragmentos que se devuelven.
     • Consulta: la consulta de la estrategia de búsqueda. Este campo admite valores estáticos, modos estático, argumento, dinámico.
   • Estructurado (vista previa): selecciona esta opción para consultas estructuradas si utilizas fuentes de datos tabulares. Admite el formato de datos CSV.
   • DeepRAG: selecciona esta opción para habilitar la síntesis y recuperación avanzadas de varios documentos. Para obtener más detalles, consulta Detalles sobre DeepRAG.
     • Habilitar citas: para consultas DeepRAG.
     • Solicitud: la solicitud de la consulta de DeepRAG. Este campo admite valores estáticos, modos estático, argumento, dinámico.
5. Limita el ámbito de búsqueda utilizando la siguiente configuración:
   • Prefijo de la ruta de la carpeta: utiliza este campo para especificar la ruta de la carpeta donde se almacenan tus documentos de destino. Puedes introducir manualmente una ruta estática, como /documents/project o utilizar un argumento dinámico, lo que permite al agente buscar diferentes carpetas en función de las entradas del runtime.
   Nota:

   De forma predeterminada, solo se indexan los archivos que están directamente en la carpeta especificada. Los archivos almacenados en subcarpetas no se incluyen automáticamente. Para incluir archivos de subcarpetas, anexa /** a la ruta (por ejemplo, /documents/project/**). Si los archivos de las subcarpetas no se incluyen, es posible que veas el siguiente error: "No hay archivos válidos para utilizar para DeepRAG. Actualiza y vuelve a sincronizar tu índice, o utiliza un patrón coincidente diferente."

   • Extensión de archivo – selecciona los tipos de archivo contenidos en el índice. Para DeepRAG, solo se admiten archivos PDF.

Usar entidades de Data Fabric en agentes

Además de los índices, los agentes pueden utilizar entidades de Data Fabric directamente como contexto. Esto permite a un agente consultar un sistema de registro directamente desde los sistemas empresariales y razonar sobre los valores actuales sin tener que crear o mantener un índice.

Se admite que los tipos de entidad nativos y federados se añadan como contexto. Una entidad nativa almacena sus registros en UiPath, mientras que una entidad federada no tiene datos propios y lee en directo desde un sistema externo o desde una entidad nativa cada vez que se consulta. Para obtener una comparación completa de lo que admite cada tipo, consulta Tipos de entidad. Para obtener más información sobre la creación y configuración de entidades, consulta Crear una entidad.

Para añadir un conjunto de entidades de Data Fabric como contexto para tu agente, sigue los siguientes pasos en la sección Contextos :

1. Selecciona Añadir contexto y, a continuación, selecciona Entidades de Data Fabric.
   Nota:

   Esta vista muestra solo las entidades a nivel de carpeta.

2. Busca y selecciona hasta cinco entidades de la lista. Las entidades se agrupan en En la solución actual y Recursos disponibles, y cada una muestra una etiqueta Nativo o Federado . Opcionalmente, puedes utilizar el botón Ver para ver los detalles de una entidad.
3. Selecciona Añadir para añadir las entidades seleccionadas a tu agente.
   Nota:

   Las entidades federadas que se conectan a un sistema externo pueden tener parámetros obligatorios, dependiendo de lo que el conector de ese sistema necesite para leer datos. Si la entidad que has añadido tiene alguna, su panel de propiedades las enumera. Introduce los valores de los parámetros necesarios antes de que el agente pueda consultar esa entidad.

Las entidades aparecen como contexto para tu agente, cada una con su etiqueta Nativo o Federado y listas para ser consultadas.