Criar com o assistente
O assistente de criação conduz um briefing em etapas no Builder. No fim, a Zaia monta o agente no workspace — instruções, tom, voz, base de conhecimento, tabelas, integrações e habilidades extras — e abre uma tela de teste antes de você publicar nos canais.
O caminho Criar do zero não muda: continua abrindo um agente em branco no editor avançado. Veja Na lista de Agentes.
Onde começar
Seção intitulada “Onde começar”| Entrada | O que acontece |
|---|---|
| Onboarding do primeiro plano | Depois da aula e da agenda, o workspace pergunta Como você quer começar? — Criar com o assistente ou Começar de um modelo (sem menu lateral do Builder enquanto você cria e testa). |
| Builder → Agentes → Novo Agente → Criar com o assistente | Mesmo briefing, com ← Voltar para a lista Agentes. |
| Builder → Agentes → Novo Agente → Criar a partir de um modelo | Escolha o nicho; briefing preenchido para demonstração (texto de exemplo em O que a empresa faz deve ser trocado antes de avançar). |
| Console → Programa de Aceleração → Comece aqui → Agente modelo | Escolha nicho e, se quiser, cliente e workspace; o briefing já vem preenchido para demonstração. Veja Programa de Aceleração. |
Em Novo Agente, o card Criar com o assistente traz a badge Recomendado e o botão Começar. Criar a partir de um modelo fica no mesmo bloco que Criar do zero.
Visão do briefing
Seção intitulada “Visão do briefing”A barra superior mostra Criar agente e Progresso do briefing. Cada etapa tem um título curto na linha de cima e uma pergunta principal. Use Continuar para avançar e Voltar para a etapa anterior.
Campos de texto aceitam Ditar (microfone do navegador) e, na etapa de tarefas, Organizar em passos depois de ditar ou colar texto.
À direita (ou abaixo, no mobile), a prévia Seu agente acompanha nome, empresa, canais, arquivos e integrações escolhidas.
Etapas marcadas como opcional podem ser puladas com Pular esta etapa.
| Ordem | Rótulo na UI | Pergunta |
|---|---|---|
| 1 | Sobre o negócio | Conte sobre a empresa |
| 2 | Como ele atende | Com quem ele conversa e como se comporta? |
| 3 | O que ele faz | O que ele precisa resolver? |
| 4 | O que ele sabe · opcional | Tem arquivos ou planilhas para ele consultar? |
| 5 | Integrações · opcional | Ele vai usar algum sistema seu? |
| 6 | Habilidades · opcional | O que mais ele sabe fazer? |
| 7 | Revisar e criar | Tudo certo para criar {nome do agente}? |
1. Sobre o negócio
Seção intitulada “1. Sobre o negócio”| Campo | Obrigatório | Limite |
|---|---|---|
| Nome do agente | Sim | 80 caracteres |
| Empresa que ele representa | Sim | 120 caracteres |
| O que a empresa faz | Sim | 4000 caracteres |
| Site | Não | domínio válido (a interface prefixa https://) |
A dica Lembre de incluir lista horário, endereço, formas de pagamento e serviços — o agente usa esse texto mesmo sem arquivos.
Se você veio de um modelo (onboarding, Novo Agente ou Agente modelo), pode aparecer Agente modelo · {nicho} com empresa de exemplo. Enquanto O que a empresa faz ainda for o texto ilustrativo do modelo, Continuar fica bloqueado — use Apagar o exemplo e escrever ou substitua o texto manualmente.
2. Como ele atende
Seção intitulada “2. Como ele atende”| Campo | Detalhe |
|---|---|
| Quem são os clientes | Até 2000 caracteres |
| Por onde ele vai atender | WhatsApp, Instagram, Chat no site, Telegram — marque um ou mais. A conexão das contas é na publicação, depois do teste. |
| Tom | Formal, Equilibrado ou Descontraído |
| Emojis | Nenhum, Poucos ou À vontade |
| Voz · nas respostas em áudio | Feminina ou Masculina — use Ouvir para amostra |
| O que ele nunca deve fazer | Até 2000 caracteres |
A prévia mostra saudação e nota de resposta em áudio conforme tom e voz.
3. O que ele faz
Seção intitulada “3. O que ele faz”Escolha uma ou mais metas (Agendar, Tirar dúvidas, Qualificar interesse, Orçamento e venda, Acompanhar pedido, Pós-venda e suporte ou Outro).
Para cada meta, descreva O que o seu agente deve fazer? — objetivo, passos e jeito de atender. Use Passo a passo quando quiser listar etapas; Organizar em passos ajuda depois de ditar.
Marque Dados que ele precisa pedir quando o agente deve coletar nome, telefone, e-mail, CPF, endereço ou data de nascimento.
Até 8 tarefas no total.
4. O que ele sabe (opcional)
Seção intitulada “4. O que ele sabe (opcional)”Arraste documentos ou planilhas aqui, ou clique para escolher
- PDF, DOCX, TXT ou MD entram na base de conhecimento do agente.
- XLSX abre a revisão de colunas (mesmo fluxo de Criar tabelas) e vira tabela no workspace.
Formatos e status aparecem na lista (Enviando, Na fila, Processando, Pronto, Falhou). Pode continuar enquanto os arquivos são processados.
Para cada planilha importada, em O agente pode marque Consultar, Registrar novas linhas e/ou Atualizar linhas.
Remova itens com Remover. Falha no envio mostra mensagem com o nome do arquivo — tente de novo ou Continuar sem este item quando a criação já estiver em andamento.
Guia de bases: Criar base de conhecimento.
5. Integrações (opcional)
Seção intitulada “5. Integrações (opcional)”Busque ou filtre por categoria (Mais usadas, Agenda, Comunicação, etc.). Para cada ferramenta:
- Selecione na lista.
- Use Conectar conta ou Usar uma conta já conectada (no fluxo pela lista Agentes, contas do workspace ficam disponíveis).
- Preencha O que o agente deve fazer no {ferramenta}? (até 400 caracteres).
Status: Conta conectada, Aguardando autorização, Conta não conectada, A conexão falhou.
Integrações sem conta conectada geram aviso na revisão: o agente é criado sem essa ferramenta até você conectar depois.
WhatsApp, Instagram e Chat no site são canais, não integrações da lista — marque-os em Como ele atende e conecte na publicação.
MCP customizado e catálogo completo fora do briefing continuam no editor avançado. Veja Conectar um MCP.
6. Habilidades (opcional)
Seção intitulada “6. Habilidades (opcional)”Recursos extras sem conta obrigatória (salvo quando a habilidade pede WhatsApp ou workflow):
Follow-up, Pesquisa na internet, Memória contextual, Agendamento de execução, Transferência para humano, Requisição HTTP, Geração de imagem, Envio de mensagens, Avaliação do atendimento, entre outras disponíveis na tela.
Para cada uma selecionada, descreva O que o agente deve fazer? em linguagem natural — a Zaia converte isso na configuração da ferramenta.
Agendamento de execução e Follow-up passam a valer depois que o agente for publicado, como no restante da plataforma.
Algumas habilidades exigem workflow pronto no workspace ou conta de WhatsApp; ficam pendentes na tela de teste se faltar requisito.
7. Revisar e criar
Seção intitulada “7. Revisar e criar”O resumo lista negócio, tarefas, comportamento, arquivos, tabelas, integrações e habilidades. Editar volta à etapa correspondente.
Avisos comuns:
- Integrações sem conta conectada
- Arquivos ainda processando — o agente fica pronto para teste quando terminarem
Use Criar agente para iniciar a montagem.
Montando seu agente
Seção intitulada “Montando seu agente”A tela Montando seu agente mostra etapas como Preparando a criação, Escrevendo as instruções do agente, Processando documentos e tabelas e Criando o agente e conectando as ferramentas. Leva alguns minutos; pode deixar a aba aberta.
Se algo falhar, aparece Precisa da sua atenção com o item (Base de conhecimento, Tabela, Integração, Agente). Use Tentar de novo ou Continuar sem este item. O briefing permanece salvo (Rascunho salvo / Salvando…).
Erros genéricos:
- Não foi possível criar o agente — Tentar de novo ou Revisar o briefing
- A criação automática está indisponível agora — aguarde e tente de novo
Testar antes de publicar
Seção intitulada “Testar antes de publicar”Na tela {nome} está pronto para testar (ou Converse com {nome} no fluxo de teste):
- Teste · ninguém de fora vê esta conversa — chat lateral como cliente, com texto, áudio e anexos.
- Sugestões de primeira mensagem (Primeiro contato, Valores, Atendimento).
- Se arquivos ainda processam: Os arquivos e tabelas ainda estão sendo processados…
- Aba Ajustar — Vibe Agent na lateral (após a primeira resposta) para pedir mudanças em linguagem natural (Ajustar com o Vibe Agent).
- Compartilhar — link de teste (Widget de teste no histórico); não publica canais de atendimento.
- Publicar — abre Onde o agente vai atender?
- Não quero publicar agora — vai para a página do agente no rascunho.
Lista Para configurar depois mostra integrações ou habilidades que ficaram pendentes.
Publicar nos canais
Seção intitulada “Publicar nos canais”Na modal Onde o agente vai atender?, marque WhatsApp (API oficial), WhatsApp (app), Instagram, Telegram e/ou Chat no site.
Para canais que exigem conta, use Conectar conta ou Usar uma conta já conectada. Chat no site não precisa de conta.
Publicar ou Publicar em N canais cria os canais e faz o deploy. Resultado: Agente publicado ou Publicado em parte dos canais se algum canal falhar.
Depois da publicação, o workspace abre a página do agente e um tour destaca Vibe Agent, Conversas, Suporte e Console. Use Próximo e Entendi para fechar.
Guia complementar: Criar um canal e Deploy e rollback.
Limites e slots
Seção intitulada “Limites e slots”Workspaces com slots do Console respeitam Limite de slots de agentes.
Ajustes finos (modelo de IA, squads, MCP customizado, API) ficam no editor avançado — o bloco Depois de criar, dá para ir além na revisão resume isso.
O Vibe Agent na tela de teste consome a cota de Usage quando disponível no workspace; o chat de teste interno tem limite próprio.