# Vatio

> Vatio es un runtime para agentes de IA de cara al cliente: defines el agente en `vatio.yml`, le conectas herramientas y conocimiento, y lo despliegas a chat web, WhatsApp e Instagram.

Todo el contenido de abajo, en un solo archivo: https://docs.vatio.ai/es/docs.md

## Documentación

- [Changelog](https://docs.vatio.ai/changelog.md): What changed in Vatio, newest first. One entry per released version, covering the CLI and the platform together.
- [Introducción](https://docs.vatio.ai/es/index.md): Vatio es un runtime para agentes de IA de cara al cliente. Defines el agente en vatio.yml, le conectas las herramientas y el conocimiento que necesita, y lo despliegas a chat web, WhatsApp e Instagram.
- [Guía rápida](https://docs.vatio.ai/es/quickstart.md): Instala la CLI, crea un workspace, define un agente en vatio.yml, despliégalo a un preview y publícalo en vivo.
- [Workspace y manifiesto](https://docs.vatio.ai/es/manifest.md): Un workspace contiene un agente y sus conversaciones, contactos, conocimiento, secretos y conexiones de canal. Su configuración desplegable vive en vatio.yml.
- [Agentes](https://docs.vatio.ai/es/agents.md): El bloque agent describe un agente — sus instrucciones, nombre, personalidad, herramientas, conocimiento y enlaces.
- [Varios agentes](https://docs.vatio.ai/es/multi-agent.md): Un workspace puede correr más de un agente, cada uno con sus instrucciones, herramientas y conocimiento. Una tabla de entrada ordenada decide cuál le toca a cada visitante.
- [Herramientas](https://docs.vatio.ai/es/tools.md): Las herramientas le permiten al agente llamar a tus APIs. Una herramienta es una petición HTTP descrita en YAML, con placeholders para parámetros, secretos, la identidad verificada y el contacto.
- [Bases de conocimiento](https://docs.vatio.ai/es/knowledge.md): Una base de conocimiento guarda entradas en Markdown — las que escribes tú, y las que escribe un sitio que Vatio lee y relee cada noche.
- [Enlaces](https://docs.vatio.ai/es/links.md): Declara los destinos estáticos que un agente puede entregar, con placeholders expandidos al momento del despliegue.
- [Humano en el loop](https://docs.vatio.ai/es/handoff.md): Dos bloques del agente deciden cuándo toma una persona — handoff, que le da la herramienta y las condiciones, y hours, que dice si hay alguien de turno.
- [Resguardos](https://docs.vatio.ai/es/safeguards.md): Vatio revisa los borradores de respuesta buscando contenido vacío, medios generados y enlaces no autorizados. Estas revisiones corren para todo agente y no se pueden desactivar.
- [Autenticación](https://docs.vatio.ai/es/authentication/index.md): Tú firmas un JWT que dice quién es el visitante. Vatio lo verifica con tu clave pública y se lo pasa a tus herramientas — nunca puede emitir uno.
- [Sesiones y canales](https://docs.vatio.ai/es/authentication/sessions.md): Cómo llega un token firmado a Vatio — renderizado en el widget en la web, o emitido por tu backend en WhatsApp y otros canales sin sesión.
- [Herramientas privadas](https://docs.vatio.ai/es/authentication/tools.md): Qué ve una herramienta privada del visitante verificado, y la única regla que importa — nunca tomes el id del usuario como parámetro.
- [Canales](https://docs.vatio.ai/es/channels/index.md): El mismo agente atiende chat web, WhatsApp, Instagram y conversaciones de CLI. Lo que cambia entre ellos es la entrega, no el agente.
- [Widget web](https://docs.vatio.ai/es/channels/widget.md): Embebe el chat de Vatio en tu propio sitio con un script tag, con el tema del manifiesto o sobrescrito por página.
- [WhatsApp](https://docs.vatio.ai/es/channels/whatsapp.md): Prueba en el número de preview compartido de Vatio sin una cuenta de Meta, y después conecta tu propio número de negocio para tráfico real.
- [Instagram](https://docs.vatio.ai/es/channels/instagram.md): Prueba los DMs en la cuenta de preview compartida de Vatio, y después conecta tu propia cuenta profesional para DMs reales.
- [Bandeja](https://docs.vatio.ai/es/channels/inbox.md): Donde tu equipo mira cada conversación, le toma una al agente y se la devuelve.
- [Despliegues](https://docs.vatio.ai/es/deployments.md): Entornos preview y live, previews con nombre para ramas, despliegue desde GitHub, y los secretos del workspace que leen las herramientas.
- [Solución de problemas](https://docs.vatio.ai/es/troubleshooting.md): Síntomas y qué revisar, y cómo enviar un reporte de error o una solicitud de funcionalidad desde la CLI.

## CLI

- [CLI](https://docs.vatio.ai/es/cli/index.md): El paquete npm es @vatio-ai/cli y su ejecutable instalado es vatio. Instálalo globalmente, o córrelo a través de npx.
- [Workspace y cuenta](https://docs.vatio.ai/es/cli/workspace.md): Crear un workspace, autorizar esta máquina, leer la documentación y revisar con qué cree la CLI que está hablando.
- [Despliegues](https://docs.vatio.ai/es/cli/deploy.md): Validar el workspace, pushearlo a un preview, promover un preview a live, revertir y comparar los archivos locales con un despliegue.
- [Chats](https://docs.vatio.ai/es/cli/chat.md): Hablar con un despliegue como el desarrollador que tiene el token, releer la conversación y ver cada llamada a herramienta que hizo.
- [Bases de conocimiento](https://docs.vatio.ai/es/cli/knowledge.md): Crear bases, escribir y leer entradas, seguir sitios y releerlos cuando quieras.
- [Secretos](https://docs.vatio.ai/es/cli/secrets.md): Administrar los secretos del workspace que tus herramientas leen como $env.KEY.
- [Tokens publicables y el widget](https://docs.vatio.ai/es/cli/tokens.md): Emitir y revocar los tokens vatpub_ que lleva una página, y releer la configuración de widget que gobierna el manifiesto.
- [Canales](https://docs.vatio.ai/es/cli/channels.md): Conectar, revisar y pausar tu número de WhatsApp y tu cuenta de Instagram en vivo, y administrar los teléfonos y handles del preview compartido.
- [Claves de autenticación](https://docs.vatio.ai/es/cli/auth.md): Generar el par de claves que firma el JWT que dice quién es un visitante.
- [Configuración y subidas](https://docs.vatio.ai/es/cli/configuration.md): Dónde guarda la CLI las credenciales, qué variables de entorno las sobrescriben, y exactamente qué envía un push.
- [Conectar MCP](https://docs.vatio.ai/es/cli/mcp.md): Vatio provee un servidor MCP sobre stdio. Apunta cualquier cliente MCP a `vatio mcp` y obtiene docs, despliegues, chat, conocimiento y administración de canales.

## SDK

- [SDK de navegador](https://docs.vatio.ai/es/sdk/index.md): Arma tu propia UI de chat sobre @vatio-ai/sdk — un paquete npm sin dependencias y con tipos incluidos.
- [Referencia del SDK](https://docs.vatio.ai/es/sdk/reference.md): Cada método de Vatio y de un chat, las opciones que acepta Vatio.chat, y qué guarda el SDK en el navegador.
- [Límites y entrega](https://docs.vatio.ai/es/sdk/limits.md): Los límites de tasa a los que está sujeto el SDK, qué prueba y qué no prueba la lista de orígenes permitidos, y los tres estilos de respuesta.

## Referencia de API

- [Referencia de API](https://docs.vatio.ai/es/api/index.md): Todo lo que abre un token de desarrollador de Vatio, sobre HTTP. URL base https://vatio.ai, rutas relativas a /api/v1/:slug.
- [Errores](https://docs.vatio.ai/es/api/errors.md): Las formas que toma un error de la API de Vatio, qué significa cada código de estado y qué campo lleva la razón.
- [Autorización de dispositivo](https://docs.vatio.ai/es/api/device-authorization.md): Cómo funciona vatio login, y cómo una CLI propia obtiene un token de desarrollador sin tener navegador.
- [API de despliegues](https://docs.vatio.ai/es/api/deployments.md): Validar un bundle de archivos, desplegarlo a un preview, publicarlo en vivo, revertir y leer el historial de despliegues sobre HTTP.
- [API de secretos](https://docs.vatio.ai/es/api/secrets.md): Listar, definir y eliminar los secretos del workspace que las herramientas leen como $env.KEY. Los valores son de solo escritura.
- [API de bases de conocimiento](https://docs.vatio.ai/es/api/knowledge.md): Crear bases, escribir y leer entradas, seguir sitios y encolar re-crawls sobre HTTP.
- [API de tokens publicables](https://docs.vatio.ai/es/api/tokens.md): Emitir y revocar los tokens vatpub_ que lleva una página, y leer la configuración de widget que gobierna el manifiesto.
- [API de canales](https://docs.vatio.ai/es/api/channels.md): Conexiones de WhatsApp e Instagram, y los registros de teléfonos y cuentas del preview compartido, sobre HTTP.
- [API de chats](https://docs.vatio.ai/es/api/chats.md): Iniciar, leer y borrar tus propias conversaciones de desarrollador. No es una forma de suplantar a un cliente.
- [API de verificación de teléfono](https://docs.vatio.ai/es/api/phone-verification.md): Verifica un número de teléfono por OTP de WhatsApp desde tu propio backend. No requiere un agente desplegado.