Context

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.

Importante:

Para utilizar contextualización debes configurar una conexión hacia un LLM, tal como se describe en Configurar LLM para tu producto.

Para añadir contexto a tu agente, sigue los pasos de la sección Contextos:

1. Selecciona Añadir contexto.
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.
   • Transformación por lotes : selecciona esta opción si quieres procesar y transformar archivos CSV.
     • Tarea de transformación por lotes : la instrucción específica de la herramienta que define cómo se debe realizar la transformación por lotes. Utilice este campo para decirle a la herramienta exactamente cómo procesar el archivo de entrada
     • Columnas de salida : define el esquema para cualquier columna nueva generada por la transformación por lotes. Para cada columna, especifica el nombre de la columna y una descripción de lo que representa la columna y cómo deben interpretarse sus valores.
     • Habilitar la conexión a tierra de la búsqueda web : si el modelo puede utilizar los resultados de la búsqueda web al generar transformaciones.
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.