#Crie um agente de IA com o seu coding agent

Para criar com a Vatio um agente de IA que atenda os seus clientes, deixe o coding agent que você já usa construir ele. Instale as skills da Vatio no seu projeto, peça ao Claude Code, Codex ou Cursor o agente que você quer e responda as poucas perguntas que o seu código não responde. Ele escreve o agente, faz o deploy em um preview, testa e te dá um link para testar na web, no WhatsApp e no Instagram. A Vatio roda o modelo e as conversas, e dá à sua equipe um inbox para supervisioná-las.

Esta página é para você, quem constrói o app. Você não precisa escrever código; precisa de acesso ao projeto no Claude Code. O manual para coding agents é o mesmo caminho escrito para o seu coding agent, com cada arquivo e cada comando; ele também está em vatio.ai/pt/guias/manual-para-coding-agents.md para você passar a qualquer agente.

#Como funciona

Instale as skills da Vatio no seu projeto.
Peça o agente que você quer, em palavras simples.
Responda o que ele perguntar sobre o negócio.
Teste no seu celular pelo link que ele te dá.
Peça para ele publicar, e conecte seus canais.

#1. Instale as skills da Vatio

Faça isso no repositório ao qual o agente pertence, normalmente o do backend que ele vai chamar: é lá que o seu coding agent encontra a API que o agente pode usar e a documentação que ele pode ler. No Claude Code:

/plugin marketplace add vatio-ai/skills
/plugin install vatio@vatio

Com qualquer coding agent, na raiz do projeto (você precisa do Node.js 20 ou mais recente):

npx @vatio-ai/skills

Isso copia três skills para .claude/skills/ e .agents/skills/, onde o Claude Code, o Codex, o Cursor, o Gemini CLI, o GitHub Copilot e o OpenCode procuram:

vatio-init começa com a Vatio em um projeto. Olha o que já existe e cria um agente novo ou explica o que você já tem.
vatio-improve corrige o que os seus supervisores marcaram quando o agente já está no live.
vatio-share-session envia a sessão para a equipe da Vatio, só se você disser que sim.

Você não instala mais nada nem cria uma conta antes. O seu coding agent roda a CLI da Vatio com npx, e você faz login na primeira vez que ele fizer o deploy.

#2. Peça o agente que você quer

Diga o que você quer, do jeito que diria a um colega. Alguns exemplos que funcionam:

Um agente de suporte para o seu produto. “Crie na Vatio um agente de suporte para o nosso site. Ele responde a partir da nossa documentação e consulta o status do pedido de um cliente na nossa API de pedidos.”
Um agente de WhatsApp para uma loja. “Crie um agente da Vatio para o WhatsApp que diga o que temos em estoque e quanto custa, a partir da nossa API de produtos, e que passe reclamações e reembolsos para uma pessoa.”
Um agente de agendamento. “Crie um agente da Vatio que agende, remarque e cancele consultas pela nossa API de agenda, e que nunca dê orientação médica.”

No Claude Code você também pode chamar a skill pelo nome, /vatio-init (ou /vatio:vatio-init pelo plugin), ou colar o prompt de vatio.ai, que faz o mesmo em qualquer coding agent.

Não sabe o que construir? Pergunte: “Olhe este repositório e me diga o que um agente da Vatio poderia fazer pelos nossos clientes.” Ele lê o seu código e propõe algo concreto: o que o agente responderia, quais dos seus endpoints viram tools e qual documentação vira conhecimento.

Antes de escrever qualquer coisa, ele olha o que já existe e conta o que encontrou. Se o projeto já tem um vatio.yml, ele não começa um segundo agente: explica o que você tem, compara com o que está no live e sugere no que trabalhar.

#3. Responda o que ele perguntar

Ele pergunta só o que o seu código não diz. Tenha as respostas prontas para quatro perguntas:

O que o negócio faz, e quem escreve?
O que o agente nunca pode dizer nem prometer? Descontos, prazos de entrega, diagnósticos, qualquer coisa que seria um problema por escrito.
Quando uma pessoa precisa assumir? Uma reclamação, um reembolso, um cliente irritado.
De quais dos seus sistemas ele deve ler? Uma API, uma agenda, um catálogo.

Essas são as decisões que só você pode tomar. O seu coding agent transforma isso nas instruções do agente, nas regras que ele nunca quebra, na transferência para uma pessoa e nas tools que chamam a sua API, tudo em um vatio.yml no seu repositório que você pode ler e revisar como qualquer outro arquivo. Ele não inventa dados do negócio, então uma resposta vaga recebe uma pergunta de volta, não um palpite.

Duas coisas para saber sobre a sua API. As chaves vão para os secrets da Vatio com vatio secrets set, nunca para o repositório. E as tools rodam nos servidores da Vatio, então não alcançam localhost: aponte para uma API na internet, um deploy de staging por exemplo. Conectar seu backend cobre as duas coisas, e as tools que leem os dados do próprio cliente logado.

#4. Teste no seu celular

O seu coding agent faz o deploy em um preview e testa algumas conversas no terminal, incluindo uma que deveria passar para uma pessoa e uma que pede algo que o agente não pode prometer. O primeiro deploy abre o seu navegador: faça login com e-mail, Google ou GitHub e confira se o código da página é o mesmo do terminal.

Depois ele te dá um link para a página Testar do inbox:

Chat web, ali mesmo na página.
WhatsApp: escaneie o QR code com o celular e envie a mensagem que ele deixa escrita. Você está falando com o agente no número compartilhado de preview da Vatio, sem conta na Meta. Até cinco telefones de teste.
Instagram: o mesmo, em uma conta compartilhada de preview.

Conversas, no mesmo inbox, mostra cada conversa com o que o agente fez embaixo de cada resposta: as tools que chamou, o que a sua API devolveu e o conhecimento que leu.

Quando uma resposta sair errada, conte ao seu coding agent o que você viu: “Quando pedi um desconto ele disse que ia verificar; deveria dizer que não.” Ele muda o agente, faz o deploy de novo e repete a conversa.

#5. Peça para ele publicar, e conecte seus canais

O seu coding agent nunca publica sozinho. Quando o preview estiver certo, peça: “Publique o agente.” Depois coloque ele onde seus clientes escrevem:

Seu site. Peça para ele adicionar o widget: ele cria um token para o seu domínio e escreve o script tag no seu site. Mais em Chat no site.
WhatsApp. No inbox, abra Canais → WhatsApp no live, conecte o número da empresa pelo cadastro da Meta e ative Em produção. Dá para continuar usando o app do WhatsApp Business: uma resposta enviada por ele assume a conversa. Mais em WhatsApp.
Instagram. Canais → Instagram, com uma conta profissional. Mais em Instagram.
Seu app. Os SDKs de navegador, iOS e Android te dão a conversa; a interface é sua. Mais em seu app iOS.

Se algo der errado depois de publicar, peça para ele reverter: vatio rollback restaura a versão anterior do live, configuração e conhecimento juntos.

#Na dúvida, pergunte ao seu coding agent

Com as skills instaladas, o seu coding agent lê toda a documentação da Vatio pelo terminal e, pela CLI em que você fez login, as conversas, as chamadas de tools e os flags do seu agente. A maioria das perguntas está a uma frase de distância:

“Por que o agente respondeu isso nesta conversa?”
“Quais chamadas de tools estão falhando, e por quê?”
“O que os supervisores marcaram esta semana? Corrija.”
“Como conecto o nosso próprio número de WhatsApp?”
“Como deixo os clientes logados consultarem os próprios pedidos?”
“O que está nesta pasta é o mesmo que está no live?”

Quando a documentação não responde algo, ele te diz e pode nos enviar o que faltou com vatio feedback. No Claude Code, depois de criar ou corrigir o agente, ele pode oferecer enviar a sessão para a equipe da Vatio; ele pergunta antes e mostra o que seria enviado.

#Escolha o seu setor

Cada guia por setor tem um agente completo para um tipo de negócio: as perguntas a fazer primeiro, as tools, o conhecimento e as regras que ele nunca quebra. Passe o link para o seu coding agent junto com o seu pedido, por exemplo “Crie o nosso agente na Vatio, como vatio.ai/pt/guias/agente-ia-para-clinicas”.

E-commerce e varejo: estoque, preços, status do pedido e trocas.
Clínicas e saúde: consultas, convênios e preparo de exames, sem nunca diagnosticar.
Imobiliárias: qualificar compradores e inquilinos, mostrar imóveis e agendar visitas.
Restaurantes e delivery: reservas, cardápio, alergênicos, horários e pedidos.
Educação e admissões: cursos, mensalidades, requisitos e status de inscrição.
Beleza, spas e academias: agendamentos, serviços, preços e planos.
Hotéis e turismo: disponibilidade, reservas, check-in e dúvidas sobre o destino.
Concessionárias e oficinas: estoque, test drives, agendamento de revisão e status do carro.
Seguros e finanças: cotações, status de sinistros e documentos, com regras rígidas.
Suporte técnico, SaaS e provedores: suporte de primeiro nível que abre um chamado para o que não consegue resolver.
Logística e transportadoras: rastreamento, janelas de entrega, entregas malsucedidas e pontos de retirada.
Recrutamento e RH: vagas abertas, status da candidatura e agendamento de entrevistas.
Escritórios e serviços profissionais: triagem, agendamento de consultas e andamento de casos, sem orientação jurídica.
Clínicas veterinárias: consultas, vacinas e horários, com as emergências passadas para uma pessoa.

#Depois que estiver no live

Convide como supervisores as pessoas que hoje atendem seus clientes, em Equipe no inbox. Elas veem cada conversa e cada chamada de tool no inbox, assumem uma conversa respondendo e reportam as respostas que saíram erradas. Quem só precisa ler, como um gerente ou um auditor, entra com somente leitura, e qualquer um dos dois papéis pode ficar limitado às conversas de alguns agentes. Atividade registra quem abriu, respondeu ou mudou o quê. A partir daí:

Melhorar seu agente: cada relato vira um teste; no Claude Code, /vatio:vatio-improve corrige todos os abertos, e o vatio publish só leva ao ar uma versão que não quebra nenhum que já passava.
Boas práticas: o que funciona em instruções, tools, conhecimento, transferência e evals; vale ler antes de revisar o que o seu coding agent escreveu.

Perguntas frequentes

Preciso saber programar para criar um agente de IA com a Vatio?

Você precisa mais de um coding agent do que de saber programar. Você pede em palavras simples, e o Claude Code, o Codex ou o Cursor escreve o agente, faz o deploy e testa; você responde perguntas sobre o negócio e testa o resultado. Conectar o agente aos seus sistemas exige uma API HTTP, e construir uma onde não existe é trabalho de desenvolvimento, que o seu coding agent também pode fazer no seu backend.

Quais coding agents funcionam com as skills da Vatio?

O Claude Code, como plugin ou com npx @vatio-ai/skills, e qualquer coding agent que leia skills de .agents/skills: Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode e outros. Um que não lê skills ainda encontra uma seção da Vatio no AGENTS.md do projeto, e você pode passar para ele o manual para coding agents em vatio.ai/pt/guias/manual-para-coding-agents.md.

Em quais canais um agente da Vatio pode responder?

No seu site com um único script tag, no WhatsApp, nas mensagens diretas do Instagram, nos seus próprios apps com os SDKs de navegador, iOS e Android, e no terminal para testar. É o mesmo agente em todo lugar; só muda a forma de entregar as respostas. Ele responde em texto e consegue ler as imagens, os áudios e os PDFs que recebe.

Quanto tempo leva para criar um agente de IA?

Chegar a um primeiro agente em preview leva uma sessão com o seu coding agent, e você não precisa de conta até o primeiro push. O preview do WhatsApp não exige conta na Meta, então você testa do seu celular na hora. O que leva tempo de verdade é a parte que só você pode fazer: decidir o que o agente nunca pode dizer e dar a ele uma API para chamar.

Qual modelo de IA um agente da Vatio usa?

DeepSeek V4.1 Flash, via OpenRouter e só em endpoints com retenção zero de dados: o provedor que o executa não guarda nem o prompt nem a resposta. A Vatio roda o modelo para você, então não há modelo para hospedar nem chave de modelo no vatio.yml, e você molda o agente com instruções, tools e conhecimento. A página Models and data da documentação lista todos os modelos que a Vatio usa, incluindo o juiz dos evals, que é de outra família para nunca avaliar o próprio tipo de resposta.

O agente pode mandar mensagem primeiro para os clientes, com lembretes ou campanhas?

No WhatsApp, sim, quando o seu backend pede. A Messages API envia a cada contato o seu próprio texto, uma mensagem que o agente escreve a partir de um brief, ou um modelo aprovado quando já se passaram 24 horas desde a última mensagem da pessoa, e o agente atende as respostas sabendo por que escreveu. O agente nunca decide por conta própria escrever primeiro, e não há um painel de campanhas: o seu backend decide para quem e quando. O Instagram não permite que uma empresa escreva primeiro.

Como evito que o agente invente coisas?

Diga ao seu coding agent o que o agente nunca pode fazer: ele escreve isso como regras explícitas, dá ao agente tools para tudo o que muda, como estoque, preços e agendamentos, e conhecimento para o resto, e pede que ele diga quando nenhum dos dois responder. A Vatio remove qualquer link que não foi dado ao agente, mostra cada chamada de tool no inbox e transforma cada resposta que um supervisor marca com uma nota em um caso de eval.

Atualizado: 11 de outubro de 2026