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 la recuperación y reclasificación de fragmentos relevantes. No se devuelven los fragmentos relevantes que se puntúan por debajo de este umbral. Utilice este campo para que los resultados sean más precisos. A medida que aumentas este número, Contextualización filtra y fundamenta 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 conexión a tierra de la generación de LLM (tamaño general del token de la llamada de LLM) sea más pequeña y puede ayudar a actuar como un filtro adicional en los resultados que se obtienen de Contextualización. Al aumentar el número de resultados, aumenta la cantidad de fragmentos que se devuelven.
     • Consulta : la consulta para la estrategia de búsqueda. Este campo admite valores estáticos, modos Estático, Argumento y 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 información, consulta Uso de DeepRAG.
     • Habilitar citas : habilite para citas para consultas de DeepRAG.
     • Solicitud : la solicitud para la consulta de DeepRAG. Este campo admite valores estáticos, modos Estático, Argumento y 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, actualmente solo se admiten archivos PDF.