> Instala las skills de Vatio, pídele a tu coding agent el agente que quieres y pruébalo en WhatsApp; después publícalo en tu sitio, WhatsApp e Instagram. # 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/guias/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](https://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: ```text /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): ```bash 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](/es#start), 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](/es/guias/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](/es/guias/chat-con-ia-para-tu-sitio-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](/es/guias/agente-ia-para-whatsapp). - **Instagram.** **Canales → Instagram**, con una cuenta profesional. Más en [Instagram](/es/guias/agente-ia-para-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](/es/guias/agente-ia-en-tu-app-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](/es/guias/agente-ia-para-ecommerce): stock, precios, estado del pedido y devoluciones. - [Clínicas y salud](/es/guias/agente-ia-para-clinicas): horas, convenios y preparación de exámenes, sin diagnosticar nunca. - [Inmobiliarias](/es/guias/agente-ia-para-inmobiliarias): calificar compradores y arrendatarios, mostrar propiedades y agendar visitas. - [Restaurantes y delivery](/es/guias/agente-ia-para-restaurantes): reservas, carta, alérgenos, horarios y pedidos. - [Educación y admisiones](/es/guias/agente-ia-para-educacion): carreras, aranceles, requisitos y estado de postulación. - [Belleza, spa y gimnasios](/es/guias/agente-ia-para-belleza-y-bienestar): reservas, servicios, precios y planes. - [Hoteles y turismo](/es/guias/agente-ia-para-hoteles-y-turismo): disponibilidad, reservas, check-in y preguntas sobre el destino. - [Automotoras y talleres](/es/guias/agente-ia-para-automotoras): inventario, test drives, horas de taller y estado del auto. - [Seguros y finanzas](/es/guias/agente-ia-para-seguros-y-finanzas): cotizaciones, estado de siniestros y documentos, con reglas estrictas. - [Soporte técnico, SaaS e ISP](/es/guias/agente-ia-para-soporte-tecnico): soporte de primer nivel que abre un ticket para lo que no puede resolver. - [Logística y courier](/es/guias/agente-ia-para-logistica): seguimiento, ventanas de entrega, entregas fallidas y puntos de retiro. - [Reclutamiento y RR. HH.](/es/guias/agente-ia-para-reclutamiento): vacantes, estado de postulación y agenda de entrevistas. - [Estudios jurídicos y servicios profesionales](/es/guias/agente-ia-para-servicios-profesionales): recepción de casos, agenda de consultas y estado de causas, sin asesoría legal. - [Veterinarias](/es/guias/agente-ia-para-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](/es/guias/mejorar-tu-agente-de-ia): 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](/es/guias/buenas-practicas-agentes-de-ia): lo que funciona en instrucciones, tools, conocimiento, derivación y evals; vale la pena leerlo antes de revisar lo que escribió tu coding agent. ## Preguntas frecuentes ### ¿Necesito saber programar para construir un agente de IA con Vatio? Necesitas un coding agent más que saber programar. Pides en palabras simples, y Claude Code, Codex o Cursor escribe el agente, lo despliega y lo prueba; tú respondes preguntas sobre el negocio y pruebas el resultado. Conectarlo a tus propios sistemas requiere una API HTTP, y construirla donde no existe es trabajo de desarrollo, que tu coding agent también puede hacer en tu backend. ### ¿Qué coding agents funcionan con las skills de Vatio? Claude Code, como plugin o con npx @vatio-ai/skills, y cualquier coding agent que lea skills desde .agents/skills: Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode y otros. Uno que no lee skills igual encuentra una sección de Vatio en el AGENTS.md del proyecto, y puedes darle el manual para coding agents en vatio.ai/es/guias/manual-para-coding-agents.md. ### ¿En qué canales puede responder un agente de Vatio? En tu sitio web con un solo script tag, en WhatsApp, en los mensajes directos de Instagram, en tus propias apps con los SDK de navegador, iOS y Android, y en la terminal para probar. Es el mismo agente en todas partes; solo cambia la forma de entregar las respuestas. Responde con texto, y puede leer las imágenes, los audios y los PDF que le envían. ### ¿Cuánto tiempo toma construir un agente de IA? Llegar a un primer agente en preview toma una sesión con tu coding agent, y no necesitas una cuenta hasta su primer push. El preview de WhatsApp no requiere una cuenta de Meta, así que puedes probar desde tu teléfono de inmediato. Lo que toma tiempo de verdad es lo que solo tú puedes hacer: decidir qué no debe decir nunca el agente y darle una API a la cual llamar. ### ¿Qué modelo de IA usa un agente de Vatio? DeepSeek V4.1 Flash, a través de OpenRouter y solo en endpoints con retención cero de datos: el proveedor que lo corre no guarda ni el prompt ni la respuesta. Vatio corre el modelo por ti, así que no hay un modelo que alojar ni una llave de modelo en el vatio.yml, y al agente le das forma con instrucciones, tools y conocimiento. La página Models and data de la documentación lista todos los modelos que usa Vatio, incluido el juez de los evals, que es de otra familia para que nunca califique su propio tipo de respuesta. ### ¿El agente puede escribirles primero a los clientes, con recordatorios o campañas? En WhatsApp, sí, cuando tu backend lo pide. La Messages API le envía a cada contacto tu propio texto, un mensaje que el agente escribe a partir de un brief, o una plantilla aprobada cuando pasaron 24 horas desde su último mensaje, y el agente atiende las respuestas sabiendo por qué escribió. El agente nunca decide por su cuenta escribir primero, y no hay un panel de campañas: tu backend decide a quién y cuándo. Instagram no permite que una empresa escriba primero. ### ¿Cómo evito que el agente invente cosas? Dile a tu coding agent lo que el agente nunca debe hacer: lo escribe como reglas explícitas, le da tools para todo lo que cambia, como stock, precios y reservas, y conocimiento para el resto, y le pide que lo diga cuando ninguno de los dos responda. Vatio elimina cualquier link que no se le haya dado al agente, muestra cada llamada a tools en el inbox y convierte cada respuesta que un supervisor marca con una nota en un caso de eval.