Como criar um AI agent em 90 segundos — passo a passo real

Você já deve ter visto aquele chat no canto inferior direito de sites que responde instantaneamente sobre o produto, marca ou serviço. Parece caro e complicado, mas não é. Este tutorial mostra como criar o seu em cerca de 90 segundos — sem uma linha de código.

O que você vai conseguir ao final

Um AI agent treinado com o conteúdo do seu site ou documento, embedado como widget em qualquer página, respondendo com citações das fontes e score de confiança visível. Pronto para produção.

Tempo estimado: 45–90 segundos do zero ao widget funcionando.

---

Passo 1 — Criar sua conta (10 segundos)

Acesse simple-agent.me e clique em Early access.

O onboarding pede apenas seu email. Nada de cartão de crédito, OAuth obrigatório ou formulário longo. Um magic link chega em 8–12 segundos.

Por que magic link? Porque 63% dos abandonos de onboarding SaaS acontecem na tela de cadastro. Menos fricção = mais gente chegando ao "momento wow".

---

Passo 2 — Nomear e configurar seu agent (15 segundos)

Na segunda tela, você escolhe:

• Nome do agent — aparece no header do widget (Suporte Simple Agent, Ana da Loja, etc.)
• URL base do seu site — o sistema já extrai a favicon e a cor primária automaticamente

O avatar do agent é gerado a partir da favicon extraída. Você pode trocar depois, mas na maioria dos casos fica ótimo de cara.

---

Passo 3 — Adicionar uma fonte de treinamento (20 segundos)

Esta é a etapa que diferencia um AI agent de um chatbot com respostas fixas.

Três opções:

1. URL — Cole qualquer URL pública. O sistema faz crawl da página + links internos até 100 páginas.
2. PDF — Upload direto. Funciona com manuais, contratos, catálogos, políticas.
3. Texto direto — Cole qualquer conteúdo na caixa de texto.

Dica importante: Você não precisa esperar o treinamento terminar. O agent já começa a responder com as primeiras páginas indexadas enquanto o crawl continua em background. Isso é o oposto do que o Chatbase faz — eles bloqueiam o agent até 100% concluído.

---

Passo 4 — Pegar o embed code (10 segundos)

Após adicionar a fonte, a tela de embed aparece imediatamente.

<script
  src="https://simple-agent.me/widget/loader.js"
  data-agent-id="seu-agent-id-aqui"
  async
></script>

Esse snippet de 5 linhas é tudo que você precisa colar antes do </body> do seu site.

Detalhes técnicos que importam:

• Carregamento via requestIdleCallback — zero impacto no LCP da sua página
• Bundle inicial de 3KB (Shadow DOM + Preact) — 10× menor que o widget Chatbase (45KB)
• Isolamento total via Shadow DOM — sem conflito com seu CSS

---

Passo 5 — Testar antes de publicar

O dashboard tem um chat playground embutido no painel de configuração. Antes de pegar o script, faça 3 perguntas sobre o conteúdo que você acabou de treinar:

1. Uma pergunta óbvia (resposta deve estar claramente na fonte)
2. Uma pergunta de borda (algo vago ou não documentado)
3. Uma pergunta fora do escopo (para ver como o agent rejeita bem)

O dot de cor no avatar do agent indica a confiança:

• Verde — resposta com alta certeza, bem ancorada na fonte
• Âmbar — resposta parcial, agent indica incerteza
• Sem dot / oferta de handoff — agent não sabe e sugere falar com humano

---

O que acontece nos bastidores

Quando você adiciona uma URL, o pipeline é:

1. Crawl via Firecrawl (com respeito ao robots.txt)
2. Chunking por sliding window semântico (512 tokens, overlap 64)
3. Embedding multilíngue com Cohere embed-v4 1024d
4. Indexação em pgvector HNSW para busca por similaridade
5. BM25 tsvector para busca por keyword (híbrido)
6. FCS heurístico para score de confiança por resposta

Na resposta ao usuário, o sistema faz Cohere Rerank v3 nos top-20 chunks e seleciona os top-8 mais relevantes. É por isso que a qualidade de resposta é muito superior a sistemas RAG simples.

---

Comparativo rápido: Simple Agent vs alternativas

Aspecto	Simple Agent	Chatbase	Botpress
Tempo setup	90s guiado	15–20min	2–4h
Widget size	3KB	45KB	~60KB
Respostas durante treino	Sim	Não	N/A
Citations inline	Sim (chunk-level)	Não	Não
Pricing	Flat $49/mês	Créditos variáveis	Por node/operação
LGPD (dados BR)	Nativo	Não	Não

---

Próximos passos após o setup inicial

Depois de ter o agent funcionando, recomendo três ajustes para maximizar a qualidade:

1. Adicionar mais fontes Quanto mais conteúdo relevante, melhor o agent. Adicione FAQ, política de devolução, manual do produto — qualquer coisa que seu time de suporte consulta regularmente.

2. Revisar perguntas sem resposta O dashboard mostra conversas onde o agent não soube responder. Cada uma é uma oportunidade: clique em + Adicionar resposta inline e vira uma fonte nova automaticamente.

3. Calibrar o tom de voz No painel do agent, há 3 presets: Formal, Equilibrado e Descontraído. Para e-commerce e suporte ao cliente, Equilibrado costuma converter melhor. Para marca premium ou B2B, Formal. Para produto jovem e casual, Descontraído.

---

Dúvidas frequentes

Preciso de cartão para entrar? Não. O early access é por convite enquanto billing self-serve fica bloqueado.

O agent vai inventar respostas que não estão na minha fonte? Sim, se você não configurar o comportamento de out-of-scope. Por padrão, o FCS score filtra respostas de baixa confiança e o agent oferece handoff humano. Mas você pode configurar para responder apenas dentro do escopo.

Consigo usar meu próprio domínio para o agent? Sim, a partir do plano Agency ($399/mês). O Cloudflare for SaaS gerencia o SSL automaticamente.

---

Conclusão

Criar um AI agent de qualidade não exige mais semanas de desenvolvimento nem um orçamento de enterprise. Com a stack certa, você sai de zero para um widget funcionando em cerca de 90 segundos.

O diferencial não é a velocidade de setup — é a qualidade de resposta. Citations chunk-level, score de confiança visível, e respostas durante o treinamento são detalhes que a maioria das ferramentas ainda não tem.

Entrar no early access →