> Construye un agente de IA que busca en tu inventario, agenda test drives y horas de taller e informa el estado del auto en servicio, sin dar un precio final. # Agente de IA para automotoras y talleres Un agente de IA para una automotora atiende a compradores y dueños por WhatsApp, Instagram y tu sitio web: busca los autos que tienes en stock, agenda test drives y horas de taller, y le dice al dueño cómo va su auto en el taller a partir del número de orden de trabajo y la patente. Nunca da un precio final ni condiciones de financiamiento, y deriva la tasación y el crédito a un vendedor. Con Vatio describes ese agente en un archivo `vatio.yml` y responde desde tu propio número de WhatsApp. Esta guía construye uno de punta a punta para una automotora con sala de ventas y taller: las instrucciones, las tools que llegan a tu sistema de gestión, el conocimiento que lee y las reglas que le impiden hacer una oferta. ## Qué resuelve el agente El chat de una automotora junta dos negocios, ventas y servicio, y en cada uno se repiten las mismas conversaciones: - **Buscar un auto.** «¿Tienen alguna SUV automática bajo 20 millones?». El agente pregunta lo que importa, busca en tu stock y muestra algunas opciones con su precio de lista y el link a la ficha de cada auto. - **Test drives.** Agenda uno para el auto que eligió el cliente, en un día y hora que tu agenda tenga libres. - **Horas de taller.** Mantención, un ruido, una luz en el tablero: pide la patente y el kilometraje y agenda la hora. - **Un auto en el taller.** «¿Está listo mi auto?». Con el número de orden de trabajo y la patente, le lee el estado. - **Sucursales y políticas.** Horarios, qué incluye una mantención, qué traer a un test drive. - **Todo lo demás va a un vendedor o asesor de servicio.** Parte de pago, financiamiento, negociación, reclamos, trabajos adicionales que cotizó el taller. Una conversación típica, con lo que el agente hizo por dentro: > **Cliente:** hola tienen alguna suv automática bajo 20 millones? > > **Agente:** Tenemos tres. Un Kia Sportage 2022 con 38.000 km a $18.990.000, un Mazda CX-5 2021 con 45.000 km a $19.490.000 y un Hyundai Tucson 2023 con 21.000 km a $19.990.000. ¿Quieres ver alguno o agendar un test drive? > > **Cliente:** el mazda. de cuánto sería la cuota? > > **Agente:** No puedo darte valores de financiamiento, pero un vendedor puede calcularlo contigo. ¿Te paso con él? Mientras tanto, puedo agendarte un test drive del CX-5. Detrás de la primera respuesta hubo una llamada a `buscar_autos`, que devolvió los tres autos con su precio de lista. La segunda no llamó a nada: una cuota es una regla de lo que nunca dice, y el financiamiento está en la lista de `handoff`. ## Antes de escribir nada: cinco preguntas para la automotora 1. **¿Quién escribe y para qué?** Normalmente compradores mirando stock, dueños agendando taller y dueños preguntando por su auto. 2. **¿Qué no debe decir nunca?** Precios finales, descuentos, tasaciones, cuotas, fechas de entrega, qué tiene un auto. 3. **¿Cuándo toma la conversación una persona?** Parte de pago, financiamiento, negociación, reclamos, aprobar trabajos adicionales. 4. **¿De qué sistemas lee?** La API del sistema de gestión (DMS) para el stock, las agendas de test drive y de taller, y las órdenes de trabajo. 5. **¿Qué cuenta como urgencia en la ruta?** Una luz roja, humo, un problema de frenos. El agente necesita las palabras de la propia automotora y el número de asistencia en ruta. Las respuestas se convierten en las instrucciones, las condiciones de `handoff`, las tools y el conocimiento, en ese orden. ## El `vatio.yml` ```yaml workspace: automotora-ruta agent: name: Automotora Ruta personality: Amable, directo y breve. Sabe de autos y nunca presiona. instructions: | Ayudas a los clientes de Automotora Ruta a encontrar un auto en stock, agendar un test drive, agendar una hora de taller y saber cómo va un auto que está en el taller. Buscar un auto: pregunta qué necesita (tipo de carrocería, presupuesto, nuevo o usado, transmisión). Llama a buscar_autos y muestra como máximo tres autos con el precio de lista tal como lo devolvió la tool, y envía el link_ficha del auto cuando quiera fotos o detalles. Test drives: pide un día y hora, su nombre y, salvo en WhatsApp, un teléfono, y llama a agendar_test_drive. Taller: pide la patente, el kilometraje, el motivo y un día, y llama a agendar_taller. Solo di que quedó agendado cuando la tool lo haya devuelto. Un auto en el taller: pide el número de orden de trabajo y la patente, y llama a estado_servicio. Si no devuelve nada, di que no coinciden. Nunca adivines una fecha de entrega que la tool no devolvió. Sucursales, horarios y qué incluye una mantención: busca primero en knowledge_lookup. Reglas que nunca rompes: - El precio de lista de buscar_autos es el único precio que das. Nunca des un precio final, un descuento, una tasación, una cuota, una tasa de interés ni ninguna condición de financiamiento. - Nunca digas qué falla tiene un auto ni que es seguro manejarlo. - Si alguien reporta una luz roja en el tablero, humo o un problema de frenos, dile que se detenga en un lugar seguro y llame a asistencia en ruta (el número está en el conocimiento), y después ofrécele una hora de taller. Si hay heridos en un accidente, dile que llame primero al 131. - Nunca prometas una fecha de entrega ni que un auto quedará reservado. tools: [buscar_autos, agendar_test_drive, agendar_taller, estado_servicio, knowledge_lookup, identify_contact] knowledge: [automotora] handoff: after_turns: 12 when: - el cliente quiere tasar su auto en parte de pago - el cliente pregunta por financiamiento, crédito o cuotas - el cliente quiere negociar el precio o reservar un auto - aprobar o cuestionar trabajos adicionales que cotizó el taller - un reclamo por una reparación, un cobro o una entrega ``` Algunas decisiones que vale la pena explicar: - **La regla de precios nombra cada número que no puede dar.** Un modelo que conoce un precio de lista calcula una cuota con gusto. Nombrar «cuota» y «tasa de interés» cierra esa puerta, y la condición de financiamiento en `handoff` manda la pregunta a quien puede responderla. - **Un agente, dos negocios.** Ventas y taller comparten un agente, con un párrafo cada uno. Un workspace corre un solo agente, y al cliente no le importa a qué área le escribió. - **«Solo di que quedó agendado cuando la tool lo devolvió».** Esa línea elimina la falla más cara de un agente de agenda: confirmar una hora que no existe. - **Las derivaciones necesitan a alguien mirando.** Vatio todavía no le avisa a nadie de una derivación: la conversación aparece como en espera en el inbox. Dentro del horario de atención, que se configura en la página **Negocio** del inbox (lunes a viernes de 9:00 a 19:00 y sábado de 10:00 a 14:00), el agente se queda en silencio, así que mantén el inbox abierto en la sala de ventas. Fuera de ese horario sigue ayudando y le dice al cliente que un vendedor le responderá en la mañana. ## Tools: llegar a tu sistema de gestión Una tool es un request HTTP a tu backend, descrito en YAML. Guarda la dirección y la llave como secrets: ```bash vatio secrets set DMS_API https://api.automotora-ruta.example vatio secrets set DMS_API_KEY sk_live_... ``` `tools/buscar_autos.yml`: ```yaml description: Busca los autos en stock. when_to_use: El cliente busca un auto o pregunta si hay un modelo disponible. parameters: type: object properties: carroceria: { type: string, description: "por ejemplo suv, sedán, hatchback, camioneta" } precio_max: { type: number } condicion: { type: string, enum: [nuevo, usado] } transmision: { type: string, enum: [automatica, manual] } marca: { type: string } access: public request: method: GET base_url: "$env.DMS_API" path: /inventario headers: Authorization: "Bearer $env.DMS_API_KEY" query: carroceria: "$params.carroceria" precio_max: "$params.precio_max" condicion: "$params.condicion" transmision: "$params.transmision" marca: "$params.marca" limite: 3 respond: data: autos: "$.autos" message: when_empty: No hay autos en stock que calcen con esa búsqueda. default: "Encontré {{count}} autos." ``` Cada auto trae su año, kilometraje, precio de lista y un `link_ficha` a su página en tu sitio. Como ese link lo devolvió una tool, el agente puede enviarlo; una URL que armara por su cuenta sería eliminada. `tools/estado_servicio.yml`: ```yaml description: Estado de un auto en el taller, por número de orden de trabajo y patente. when_to_use: El cliente pregunta cómo va su auto o si ya está listo. parameters: type: object properties: orden_trabajo: { type: string } patente: { type: string } required: [orden_trabajo, patente] access: public request: method: POST base_url: "$env.DMS_API" path: /ordenes-trabajo/estado requires: [params.orden_trabajo, params.patente] headers: Authorization: "Bearer $env.DMS_API_KEY" body: orden_trabajo: "$params.orden_trabajo" patente: "$params.patente" respond: data: estado: "$.estado" listo_el: "$.listo_el" pendiente_aprobacion: "$.pendiente_aprobacion" ``` `agendar_test_drive` y `agendar_taller` son `POST` con la misma forma: el auto o la patente, un día y hora, el nombre del cliente y su teléfono como `"$params.telefono || $contact.phone_number"`, así que en WhatsApp el agente nunca tiene que pedirlo. Tu backend revisa la agenda, y cuando la hora está tomada devuelve un `409` con un mensaje que nombra las horas libres cercanas, así el agente ofrece esas en vez de confirmar. Vatio convierte cualquier respuesta que no sea 2xx en un error que el agente puede explicar. En WhatsApp e Instagram un contacto es anónimo mientras no [inicie sesión](https://vatio.ai/docs/authentication/sessions#on-whatsapp), así que `estado_servicio` es una tool pública y **tu backend verifica que la orden de trabajo y la patente correspondan** antes de devolver nada, con el mismo `404` para un número equivocado y para una patente equivocada. Devuelve solo el estado, la fecha en que estará listo y si hay trabajos esperando aprobación. Nunca el nombre, el teléfono ni la dirección del dueño: el modelo ve cada resultado de una tool y puede repetirlo. El historial de servicio y las facturas van detrás de un login en tu sitio, con tools marcadas `access: private`; mira [Conectar tu backend](/es/guias/conectar-tu-backend). ## Conocimiento: sucursales, taller y políticas Todo lo largo que el agente deba leer en vez de memorizar va en una base de conocimiento: una entrada en Markdown por tema, con secciones que puedan responder una pregunta por sí solas. ```bash vatio kb create automotora vatio kb write automotora sucursales sucursales.md vatio kb write automotora taller taller.md vatio kb write automotora test-drives test-drives.md vatio kb write automotora garantia garantia.md ``` Una buena entrada es específica: ```markdown # Taller ## Dejar el auto De 8:00 a 10:00 el día de la hora. Trae los papeles del auto y la llave; el asesor de servicio recibe el auto contigo. ## Mantención La mayoría de las mantenciones toman medio día. Puedes esperar en la sala o pedir un auto de reemplazo al agendar, sujeto a disponibilidad. ## Asistencia en ruta Las 24 horas en el +56 2 0000 0000, para todo auto con mantenciones en nuestro taller. ``` Vatio no lee tu sitio web. Si la respuesta está en una página, pon en una entrada lo que el agente necesita. Los supervisores pueden editar entradas desde el inbox cuando cambian los horarios, y cada edición queda guardada como versión. ## Fotos de luces del tablero, patentes y autos en parte de pago Los clientes mandan fotos: una luz del tablero, la patente, el comprobante de la orden de trabajo, el auto que quieren dejar en parte de pago. Vatio le pasa al agente las imágenes y los PDF compatibles de hasta 8 MB y transcribe los audios, y agrupa varios mensajes seguidos en una sola pregunta antes de responder. Así, una foto del comprobante basta para revisar el estado, y una foto del tablero basta para agendar una hora por «la luz del motor». Lo que el agente hace con una foto sigue gobernado por las reglas. Puede decir que una luz parece la del motor y agendar una hora; no dice cuál es la falla ni si el auto es seguro, y una luz roja recibe la instrucción de asistencia en ruta. Las fotos de un auto en parte de pago van a un vendedor con la conversación, que ya está en el inbox cuando la toma. ## Pruébalo antes que cualquier cliente ```bash vatio push vatio chat "¿Tienen alguna SUV automática bajo 20 millones?" vatio chat "¿De cuánto sería la cuota en 48 meses?" vatio chat --new "Se me prendió una luz roja de aceite, ¿puedo seguir manejando?" vatio chat --new "¿Está listo mi auto? OT 58120, patente KXPT41" vatio chat show ``` Las tres últimas son las importantes: una pregunta de financiamiento que debe derivar, una luz urgente que no debe diagnosticar y una orden de trabajo con una patente que no coincide, así que no debe decir nada del auto. `chat show` muestra cada llamada a tools que hizo. Después agrega tu teléfono como número de prueba en la página **Probar** del inbox y habla con el agente en el número compartido de preview de WhatsApp. Para eso no necesitas una cuenta de Meta. ## Que mejore cada semana Cuando vendedores y asesores de servicio usan el inbox, **marcan** cualquier respuesta que estuvo mal y escriben lo que debió pasar. `vatio flags` convierte esas notas en un documento desde el cual tu coding agent puede corregir, cada flag se vuelve un caso de eval, y el flag queda marcado como resuelto cuando live lo pasa. Mira [Mejorar tu agente](/es/guias/mejorar-tu-agente-de-ia). ## Publicar ```bash vatio publish ``` Después conecta el número de WhatsApp Business y la cuenta de Instagram de la automotora en la página **Canales** del inbox (WhatsApp además necesita su interruptor **En vivo** activado), y agrega el widget a las páginas de tu inventario con una sola etiqueta script. Puedes seguir usando la app de WhatsApp Business en el teléfono de un vendedor: si responde desde ahí, toma la conversación, y el agente se hace a un lado hasta que la liberen. El agente nunca decide por su cuenta escribir primero. Los recordatorios de mantención y los avisos de «tu auto está listo» salen por WhatsApp cuando tu sistema lo pide, con la [Messages API](https://vatio.ai/docs/api/messages), y el agente atiende las respuestas sabiendo qué se envió. ## Preguntas frecuentes ### ¿Un agente de IA puede agendar test drives por WhatsApp? Sí. El agente busca en tu inventario y agenda el test drive con tools que describes en YAML, cada una un request HTTP a tu sistema de gestión (DMS) o a tu propio backend. Tu sistema sigue siendo el que confirma la hora. ### ¿El agente da precios o condiciones de financiamiento? Da el precio de lista que devuelve tu tool de inventario, y nada más. Precios finales, descuentos, tasaciones, cuotas y condiciones de financiamiento son reglas explícitas de lo que nunca dice, y esas preguntas pasan a un vendedor. ### ¿Los clientes pueden saber si su auto está listo en el taller? Sí. El cliente da el número de orden de trabajo y la patente, una tool envía ambos a tu backend y tu backend devuelve el estado solo si coinciden. El agente nunca adivina una fecha de entrega que la tool no devolvió. ### ¿El agente envía recordatorios de mantención? Sí, cuando tu sistema los pide. Sabe cuándo le toca la mantención a cada auto, así que llama a la Messages API de Vatio para cada cliente y la conversación se abre por WhatsApp: tu propio texto, un mensaje que el agente escribe a partir de un brief, o una plantilla aprobada si pasaron más de 24 horas desde el último mensaje del cliente. El agente atiende la respuesta sabiendo por qué escribió, y agenda la hora. ### ¿El agente puede tasar un auto en parte de pago a partir de fotos? No, y no debería intentarlo. Puede leer las fotos que manda el cliente, pero la tasación está en la lista de derivación, así que un vendedor toma la conversación con las fotos ya en el inbox.