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 crea el workspace remoto y escribe vatio.yml en el directorio actual. Abre la autorización de dispositivo si no has iniciado sesión. Completa ese paso en tu navegador. Si ya eres dueño del workspace remoto, init lo usa.

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.