Guía rápida

Necesitas Node.js 20 o superior y una cuenta de Vatio. Los ejemplos usan acme como slug del workspace; reemplázalo por el tuyo.

Instala la CLI

npm install -g @vatio-ai/cli@latest
vatio --help

Crea un workspace

Corre estos comandos en el repositorio donde quieres guardar tu agente:

mkdir support-agent
cd support-agent
vatio init acme

init escribe vatio.yml en el directorio actual y no pide cuenta: podés escribir el agente entero sin registrarte en nada. Si ya iniciaste sesión, además crea el workspace remoto (o usa el tuyo si ya existe).

La cuenta aparece recién en vatio push, que es lo primero que hace correr algo en un servidor. Ahí te vamos a pedir un email y mandarte un link: ese mismo click crea tu cuenta si no existía, autoriza esta terminal, y te deja en la consola. Antes de apretarlo, fijate que el código que muestra el mail sea el mismo que imprimió tu terminal.

Define el agente

Reemplaza el contenido inicial de vatio.yml por:

workspace: acme
business:
  name: Acme
  summary: Acme sells warehouse robotics.
agent:
  name: Acme Support
  instructions: |
    Help visitors understand Acme's warehouse robotics.
    Ask what they need help with. If you do not have the information
    to answer, say so. Never invent product details or prices.
  personality: Warm, concise, and clear.

workspace elige el workspace remoto. agent.instructions define qué hace su único agente. Los demás campos de este ejemplo son opcionales.

Despliega y prueba

vatio push
vatio chat "What does Acme do?"

push valida tus archivos y despliega a preview. Abre el enlace de preview que imprime, o sigue la conversación con otro comando chat.

vatio chat "Can you tell me the price?"
vatio chat debug
vatio chat reset

Verifica que el agente responda desde el contexto que le diste y que reconozca lo que no sabe. debug lee el chat actual de la CLI; reset empieza uno nuevo.

Publica

Cuando el preview esté listo para clientes:

vatio publish

Tu agente queda disponible en https://vatio.ai/w/acme. vatio rollback restaura el despliegue en vivo anterior.

Después, agrega conocimiento, conecta tu API o embebe el widget.