# 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

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

## Crea un workspace

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

```bash
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:

```yaml
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

```bash
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`.

```bash
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:

```bash
vatio publish
```

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

Después, [agrega conocimiento](https://docs.vatio.ai/es/knowledge), [conecta tu API](https://docs.vatio.ai/es/tools) o
[embebe el widget](https://docs.vatio.ai/es/channels/widget).