#Construye un agente de IA con tu coding agent

Para construir con Vatio un agente de IA que atienda a tus clientes, deja que lo construya el coding agent que ya usas. Instala las skills de Vatio en tu proyecto, pídele a Claude Code, Codex o Cursor el agente que quieres y responde las pocas preguntas que tu código no puede responder. Escribe el agente, lo despliega en un preview, lo prueba y te da un link para probarlo en la web, en WhatsApp y en Instagram. Vatio corre el modelo y las conversaciones, y le da a tu equipo un inbox para supervisarlas.

Esta página es para ti, quien construye la app. No necesitas escribir código tú; necesitas acceso a tu proyecto en Claude Code. El manual para coding agents es el mismo camino escrito para tu coding agent, con cada archivo y cada comando; también está en vatio.ai/es/guias/manual-para-coding-agents.md para dárselo a cualquier agente.

#Cómo funciona

1. Instala las skills de Vatio en tu proyecto.
2. Pide el agente que quieres, en palabras simples.
3. Responde lo que te pregunte sobre el negocio.
4. Pruébalo en tu teléfono desde el link que te da.
5. Pídele que lo publique, y conecta tus canales.

#1. Instala las skills de Vatio

Hazlo en el repositorio al que pertenece el agente, normalmente el del backend al que va a llamar: ahí tu coding agent encuentra la API que el agente puede usar y la documentación que puede leer. En Claude Code:

/plugin marketplace add vatio-ai/skills
/plugin install vatio@vatio

Con cualquier coding agent, desde la raíz del proyecto (necesitas Node.js 20 o más reciente):

npx @vatio-ai/skills

Eso copia tres skills a .claude/skills/ y .agents/skills/, donde las buscan Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot y OpenCode:

• vatio-init empieza con Vatio en un proyecto. Mira lo que ya hay y construye un agente nuevo o te explica el que tienes.
• vatio-improve corrige lo que tus supervisores marcaron una vez que el agente está en live.
• vatio-share-session le envía la sesión al equipo de Vatio, solo si dices que sí.

No instalas nada más ni creas una cuenta antes. Tu coding agent corre la CLI de Vatio con npx, y tú inicias sesión la primera vez que despliega.

#2. Pide el agente que quieres

Di lo que quieres, como se lo dirías a un colega. Algunos ejemplos que funcionan:

• Un agente de soporte para tu producto. “Construye en Vatio un agente de soporte para nuestro sitio web. Responde desde nuestra documentación y revisa el estado del pedido de un cliente con nuestra API de pedidos.”
• Un agente de WhatsApp para una tienda. “Construye un agente de Vatio para WhatsApp que diga qué tenemos en stock y cuánto cuesta, desde nuestra API de productos, y que derive los reclamos y las devoluciones a una persona.”
• Un agente de reservas. “Construye un agente de Vatio que agende, mueva y cancele horas con nuestra API de agenda, y que nunca dé consejos médicos.”

En Claude Code también puedes llamar a la skill por su nombre, /vatio-init (o /vatio:vatio-init desde el plugin), o pegar el prompt de vatio.ai, que hace lo mismo en cualquier coding agent.

¿No sabes qué construir? Pregúntale: “Mira este repositorio y dime qué podría hacer un agente de Vatio por nuestros clientes.” Lee tu código y te propone algo concreto: qué respondería el agente, cuáles de tus endpoints se vuelven sus tools y qué documentación se vuelve su conocimiento.

Antes de escribir nada, mira lo que ya existe y te cuenta lo que encontró. Si el proyecto ya tiene un vatio.yml, no empieza un segundo agente: te explica el que tienes, lo compara con lo que está en live y te sugiere en qué trabajar.

#3. Responde lo que te pregunte

Pregunta solo lo que tu código no dice. Ten listas las respuestas a cuatro preguntas:

• ¿A qué se dedica el negocio y quién escribe?
• ¿Qué no debe decir ni prometer nunca el agente? Descuentos, fechas de entrega, diagnósticos, cualquier cosa que sería un problema por escrito.
• ¿Cuándo tiene que tomar la conversación una persona? Un reclamo, una devolución, un cliente molesto.
• ¿De cuáles de tus sistemas debe leer? Una API, un calendario, un catálogo.

Estas son las decisiones que solo tú puedes tomar. Tu coding agent las convierte en las instrucciones del agente, las reglas que debe seguir, la derivación a una persona y las tools que llaman a tu API, todo en un vatio.yml en tu repositorio que puedes leer y revisar como cualquier otro archivo. No inventa datos del negocio, así que a una respuesta vaga le sigue una pregunta, no una suposición.

Dos cosas que debes saber sobre tu API. Las llaves van a los secrets de Vatio con vatio secrets set, nunca al repositorio. Y las tools corren en los servidores de Vatio, así que no pueden llegar a localhost: apúntalas a una API en internet, por ejemplo un deploy de staging. Conectar tu backend cubre ambas cosas, y las tools que leen los datos propios de un cliente que inició sesión.

#4. Pruébalo en tu teléfono

Tu coding agent despliega en un preview y prueba algunas conversaciones en la terminal, incluida una que debería pasar a una persona y una que pide algo que el agente no debe prometer. El primer despliegue abre tu navegador: inicia sesión con correo, Google o GitHub y revisa que el código de la página coincida con el de la terminal.

Después te da un link a la página Probar del inbox:

• Chat web, ahí mismo en la página.
• WhatsApp: escanea el código QR con tu teléfono y envía el mensaje que te deja escrito. Estás hablando con el agente en el número compartido de preview de Vatio, sin cuenta de Meta. Hasta cinco teléfonos de prueba.
• Instagram: lo mismo, en una cuenta compartida de preview.

Conversaciones, en el mismo inbox, muestra cada conversación con lo que hizo el agente bajo cada respuesta: las tools que llamó, lo que respondió tu API y el conocimiento que leyó.

Cuando una respuesta está mal, cuéntale a tu coding agent lo que viste: “Cuando le pedí un descuento dijo que lo iba a revisar; debería decir que no.” Cambia el agente, lo despliega de nuevo y repite la conversación.

#5. Pídele que lo publique, y conecta tus canales

Tu coding agent nunca publica por su cuenta. Cuando el preview esté bien, pídeselo: “Publica el agente.” Después ponlo donde te escriben tus clientes:

• Tu sitio web. Pídele que agregue el widget: crea un token para tu dominio y escribe el script tag en tu sitio. Más en Chat web.
• WhatsApp. En el inbox, abre Canales → WhatsApp en live, conecta tu número de empresa con el registro de Meta y activa En vivo. Puedes seguir usando la app de WhatsApp Business: una respuesta enviada desde ahí toma la conversación. Más en WhatsApp.
• Instagram. Canales → Instagram, con una cuenta profesional. Más en Instagram.
• Tu app. Los SDK de navegador, iOS y Android te dan la conversación; la interfaz es tuya. Más en tu app de iOS.

Si algo sale mal después de publicar, pídele que lo revierta: vatio rollback restaura la versión anterior de live, configuración y conocimiento juntos.

#Si tienes dudas, pregúntale a tu coding agent

Con las skills instaladas, tu coding agent lee toda la documentación de Vatio desde la terminal y, con la CLI en la que iniciaste sesión, las conversaciones, las llamadas a tools y los flags de tu agente. La mayoría de las preguntas están a una frase de distancia:

• “¿Por qué el agente respondió eso en esta conversación?”
• “¿Qué llamadas a tools están fallando, y por qué?”
• “¿Qué marcaron los supervisores esta semana? Corrígelo.”
• “¿Cómo conecto nuestro propio número de WhatsApp?”
• “¿Cómo dejo que los clientes con sesión iniciada revisen sus propios pedidos?”
• “¿Lo que hay en esta carpeta es lo mismo que está en live?”

Cuando la documentación no responde algo, te lo dice y puede enviarnos lo que faltaba con vatio feedback. En Claude Code, después de construir o corregir el agente, puede ofrecerte enviarle la sesión al equipo de Vatio; te pregunta antes y te muestra lo que se enviaría.

#Elige tu industria

Cada guía por industria tiene un agente completo para un tipo de negocio: las preguntas que hay que hacer primero, las tools, el conocimiento y las reglas que debe seguir. Dale su link a tu coding agent junto con lo que pides, por ejemplo “Construye nuestro agente en Vatio, como vatio.ai/es/guias/agente-ia-para-clinicas”.

• E-commerce y retail: stock, precios, estado del pedido y devoluciones.
• Clínicas y salud: horas, convenios y preparación de exámenes, sin diagnosticar nunca.
• Inmobiliarias: calificar compradores y arrendatarios, mostrar propiedades y agendar visitas.
• Restaurantes y delivery: reservas, carta, alérgenos, horarios y pedidos.
• Educación y admisiones: carreras, aranceles, requisitos y estado de postulación.
• Belleza, spa y gimnasios: reservas, servicios, precios y planes.
• Hoteles y turismo: disponibilidad, reservas, check-in y preguntas sobre el destino.
• Automotoras y talleres: inventario, test drives, horas de taller y estado del auto.
• Seguros y finanzas: cotizaciones, estado de siniestros y documentos, con reglas estrictas.
• Soporte técnico, SaaS e ISP: soporte de primer nivel que abre un ticket para lo que no puede resolver.
• Logística y courier: seguimiento, ventanas de entrega, entregas fallidas y puntos de retiro.
• Reclutamiento y RR. HH.: vacantes, estado de postulación y agenda de entrevistas.
• Estudios jurídicos y servicios profesionales: recepción de casos, agenda de consultas y estado de causas, sin asesoría legal.
• Veterinarias: horas, vacunas y horarios, con las urgencias derivadas a una persona.

#Cuando ya está en live

Invita como supervisores a quienes hoy atienden a tus clientes, desde Equipo en el inbox. Ven cada conversación y cada llamada a tools en el inbox, toman una conversación respondiendo y reportan las respuestas que estuvieron mal. Quien solo necesita leer, como un gerente o un auditor, entra con solo lectura, y puedes limitar cualquiera de los dos roles a las conversaciones de algunos agentes. Actividad registra quién abrió, respondió o cambió qué. Desde ahí:

• Mejorar tu agente: cada mañana tus developers reciben los reportes abiertos y el prompt /vatio:vatio-improve; Claude Code los corrige y vatio eval prueba cada uno antes de publicar.
• Buenas prácticas: lo que funciona en instrucciones, tools, conocimiento, derivación y evals; vale la pena leerlo antes de revisar lo que escribió tu coding agent.

Actualizado: 11 de octubre de 2026