Contextos

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 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.
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.

Contexto justo-a-tiempo utilizando archivos

El contexto justo-a-tiempo te permite proporcionar archivos a un agente en runtime sin gestionar índices de larga duración ni fuentes de datos persistentes. En lugar de sincronizar archivos en un índice permanente, el agente trabaja con archivos directamente. Este enfoque reduce la sobrecarga operativa, mejora el rendimiento y evita costes de almacenamiento innecesarios. Usa el contexto justo-a-tiempo cada vez que tu caso de uso requiera que el agente trabaje con los archivos proporcionados en runtime y no necesites mantener los datos indexados después.

1. Selecciona Añadir contexto y elige Usar entradas de archivo. Esta opción está disponible solo cuando se definen los argumentos de tipo de archivo para tu agente en el Gestor de datos.

2. Usa el campo Nombre para establecer un nombre descriptivo para tu índice de archivos.
3. (Opcional) En Descripción, documenta qué tipo de documentos proporcionará este contexto.
4. En Archivos, vincula la entrada que contiene los archivos o archivos adjuntos (por ejemplo, una matriz de documentos de la conversación o de una herramienta).
5. Configura los ajustes restantes tal como lo harías para un índice normal.

Durante la ejecución, se crea el índice temporal, se consulta según tu configuración y luego se descarta. El agente recibe el contexto extraído relevante como parte de su proceso de razonamiento, sin requerir que gestiones fuentes de datos, sincronices índices o realices limpieza.

Requisitos y límites

Al utilizar el contexto justo-a-tiempo, se aplican las siguientes restricciones:

• Archivos adjuntos de entrada: hasta 25 archivos adjuntos por ejecución, con un tamaño máximo total de 128 MB.
• Tipos de archivo admitidos: todos los tipos de archivos admitidos por Contextualización.
• Formato de Salida: coincide con los formatos de salida estándar de las herramientas de contextualización existentes.
• TTL (Periodo de vida): los Índices temporales se eliminan automáticamente 24 horas después del último uso. Esto permite reutilizar el mismo índice durante la depuración sin volver a ingerirlo.
• Pueden estar activos hasta 1000 índices temporales por tenant a la vez. Se puede realizar una solicitud de una cuota más alta caso por caso.