Herramienta de Consulta

Cuándo un técnico le pregunta al agente "¿cuáles son las especificaciones del compresor C-03?" o "¿hay stock del filtro de aceite Baldwin B7144?", el agente necesita buscar esa información en algún lugar. La herramienta de consulta es la conexión entre el agente y tus colecciones de datos — permite que el agente busque y recupere registros específicos durante la conversación.

¿Para qué sirve?

Sin herramientas de consulta, el agente solo puede responder con lo que está en su prompt — información estática que hay que actualizar manualmente. Con una herramienta de consulta, el agente accede en tiempo real a cualquier colección de datos de la plataforma: fichas técnicas de equipos, inventario de repuestos, historial de mantenimiento, proveedores, manuales, procedimientos.

Las herramientas de consulta permiten:

• Buscar fichas técnicas de equipos por nombre, código, o descripción
• Consultar disponibilidad de repuestos en inventario
• Recuperar historial de mantenimiento de un activo específico
• Buscar procedimientos de trabajo por tipo de tarea o equipo
• Encontrar datos de proveedores o contratos de servicio

¿Cómo funciona?

La herramienta de consulta usa dos tipos de búsqueda según el campo que se consulte:

Búsqueda inteligente (semántica): Encuentra resultados por significado, no solo por palabras exactas. Si el técnico pregunta "bomba centrífuga para agua caliente", el agente puede encontrar "Bomba BC-45 — servicio agua proceso 80°C" aunque las palabras no coincidan exactamente. Esta búsqueda usa embeddings — representaciones matemáticas del significado del texto que se calculan automáticamente cuando guardas datos en la colección.

Búsqueda exacta: Para campos donde la coincidencia precisa es obligatoria — códigos de parte, números de serie, códigos de equipo. Si el técnico escribe "filtro B7144", el agente busca exactamente ese código sin interpretación semántica.

El agente combina ambos tipos de búsqueda según los parámetros que recibe. Si la consulta incluye un código de parte, usa búsqueda exacta para ese campo; si incluye una descripción, usa búsqueda inteligente.

¿Cómo usarlo?

Crear una herramienta de consulta

1. Ve a Herramientas en la barra lateral.
2. Haz clic en Nueva Herramienta.
3. Selecciona el tipo Consulta de datos.
4. Configura los campos:

5. Haz clic en Guardar.
6. Asigna la herramienta al agente en su configuración.

Configurar la puntuación mínima

La puntuación mínima controla la calidad de los resultados:

• 0.9 o más — Solo resultados muy similares. Útil cuando los datos son muy específicos y no quieres resultados irrelevantes.
• 0.7 a 0.9 — Balance entre precisión y amplitud. Recomendado para la mayoría de casos.
• Menos de 0.7 — Resultados más amplios, pero puede incluir información poco relacionada.

Definir qué campos devolver al agente

No es necesario que el agente reciba todos los campos de cada registro. Selecciona solo los que son relevantes para la conversación:

• Para una consulta de inventario: código, descripción, cantidad disponible, ubicación en bodega
• Para una ficha técnica: nombre del equipo, fabricante, modelo, especificaciones, manual
• Para historial de mantenimiento: fecha, tipo de trabajo, técnico, resultado, próximo mantenimiento

Devolver solo los campos necesarios hace que las respuestas del agente sean más rápidas y precisas.

Configurar campos de coincidencia exacta

Marca como "coincidencia exacta" los campos que son identificadores únicos:

• Código de parte o número de parte del fabricante
• Número de serie del equipo
• Código de activo (ej: C-03, M-08, B-12)
• Número de orden de compra

Cuándo el técnico proporciona uno de estos valores, el agente busca la coincidencia exacta sin interpretación semántica — garantizando que obtenga exactamente el registro correcto.

Beneficios clave

• El agente responde con datos reales y actualizados de tus colecciones
• Búsqueda inteligente encuentra resultados aunque el usuario no use las palabras exactas
• Búsqueda exacta para códigos y seriales garantiza precisión en identificadores
• Puntuación mínima filtra resultados irrelevantes automáticamente
• El agente puede combinar múltiples herramientas de consulta en una misma respuesta
• Los datos de la colección se actualizan independientemente del agente — sin reprogramar el agente

Casos de uso comunes

Escenario 1: Agente de inventario de repuestos El técnico de turno le escribe al agente: "Necesito un sello mecánico para la bomba B-12, modelo Flowserve 21-1U2." El agente usa la herramienta de consulta en la colección de inventario. Los campos de coincidencia exacta incluyen el número de parte; el campo de búsqueda inteligente es la descripción. El agente encuentra 2 sellos compatibles en stock: uno en bodega principal (cantidad: 3) y uno en bodega planta norte (cantidad: 1). Responde con la ubicación exacta en bodega y el número de parte para la requisición.

Escenario 2: Agente de especificaciones técnicas El supervisor de turno pregunta: "¿Cuál es el lubricante recomendado para el compresor de aire C-01?" El agente usa la herramienta de consulta en la colección de fichas técnicas. Busca por el código exacto "C-01" y retorna la ficha: lubricante recomendado Mobil Rarus 427, viscosidad ISO 32, cambio cada 2000 horas de operación. El agente responde directamente con esa información sin que el supervisor tenga que buscar en el manual.

Escenario 3: Agente con múltiples consultas para respuesta completa Un técnico reporta una falla en el motor M-08 por WhatsApp. El agente ejecuta dos consultas simultáneas: una en la colección de historial de mantenimiento (para ver si ya tuvo esta falla antes) y otra en inventario (para ver si hay repuestos disponibles). Responde: "El motor M-08 tuvo una falla similar en rodamiento trasero en octubre del año pasado. Actualmente hay 2 rodamientos 6205-ZZ en bodega principal (ubicación: estante B-4). ¿Creo la orden de trabajo?"