Quickstart

You need Node.js 20 or newer and a Vatio account. The examples use acme as a workspace slug; replace it with yours.

Install the CLI

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

Create a workspace

Run these commands in the repository where you want to keep your agent:

mkdir support-agent
cd support-agent
vatio init acme

init creates the remote workspace and writes vatio.yml in the current directory. It opens device authorization if you are not logged in. Complete that step in your browser. If you already own the remote workspace, init uses it.

Define the agent

Replace the starter contents of vatio.yml with:

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 selects the remote workspace. agent.instructions defines what its single agent does. The other fields in this example are optional.

Deploy and test

vatio push
vatio chat "What does Acme do?"

push validates your files and deploys to preview. Open the preview link it prints, or continue the conversation with another chat command.

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

Check that the agent answers from the supplied context and acknowledges what it does not know. debug reads the current CLI chat; reset starts a new one.

Publish

When the preview is ready for customers:

vatio publish

Your agent is now available at https://vatio.ai/w/acme. vatio rollback restores the previous live deployment.

Next, add knowledge, connect your API, or embed the widget.