Agentes
Criando seu primeiro agente
Passo a passo para configurar um agente do zero, escolher modelo e escrever o system prompt
Atualizado em
Agente é a unidade fundamental da ControlHub. É uma combinação de:
- Modelo de IA (Claude, GPT, Gemini, etc.)
- System prompt — instruções que definem persona, estilo e limites
- Ferramentas que ele pode usar (tools nativas + MCP)
- Onde ele atua — o chat interno do time e, com o módulo Atendimento, canais como WhatsApp e Instagram
Passo 1: abrir o wizard
Dashboard → Meus Agentes → Novo Agente.
Você tem 3 pontos de partida:
- Manual — preenche tudo do zero.
- Template — parte de um modelo pronto da galeria de templates. Para o time de software, veja também as Receitas (Agentes → Receitas), que já vêm com prompt e ferramentas de leitura.
- Vibe — descreve em português e a plataforma gera tudo para você. Veja Vibe Coding.
Passo 2: dar nome e descrição
- Nome — vai aparecer nas conversas. Algo curto e claro ("Nina SDR", "Suporte Lucas").
- Descrição interna — notas para você mesmo, não vai para o cliente.
Passo 3: escolher o modelo
O catálogo atual inclui Claude Opus 4.6, Sonnet 4.6, Haiku 4.5, GPT-5, GPT-4.1, Gemini 2.5/3.1 Pro e outros. Como escolher:
| Caso de uso | Modelo recomendado |
|---|---|
| SDR / comercial conversacional | Claude Sonnet 4.6 ou GPT-5 |
| Suporte FAQ, respostas padronizadas | Haiku 4.5 ou GPT-4.1 Mini (mais baratos) |
| Análise de dados grandes (planilhas, relatórios) | Gemini 3.1 Pro (2M de contexto) |
| Brainstorm criativo, copy | Claude Opus 4.6 |
Em dúvida? Claude Sonnet 4.6 é seguro para 80% dos casos.
Passo 4: escrever o system prompt
Essa é a parte mais importante. Um prompt bom tem 5 seções:
- Persona — quem o agente é ("Você é um SDR consultor da imobiliária X").
- Objetivo — o que ele deve alcançar ("Qualificar leads: orçamento, localização, tipo de imóvel").
- Estilo de comunicação — tom ("Amigável mas direto. Máximo 2 frases por mensagem.").
- Limites — o que não fazer ("Nunca prometa preço fechado. Sempre passe para o corretor humano quando o lead pedir visita.").
- Decisões comuns — como reagir a cenários frequentes ("Se o lead mencionar outra imobiliária, responda: ...").
Passo 5: configurar ferramentas (opcional)
Na aba Integração:
- Agent Tools — tools nativas (agenda, base de conhecimento, handoff para humano).
- MCP Servers — tools externas que você plugou. Veja como conectar MCP.
Passo 6: salvar e testar
Clique Salvar e Ativar. Você é levado para a tela de teste onde pode conversar com o agente antes de expor para o cliente. Se quer testar em mais de um canal, vá em Canais e associe ao WhatsApp ou Inbox.
Editar depois
Qualquer campo pode ser editado a qualquer momento. As mudanças valem a partir da próxima mensagem — conversas em andamento continuam com as regras antigas até fecharem.