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 os Agentes prontos (Agentes → Agentes prontos), 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, Sonnet e Haiku 5.5, GPT-6.1 Sol, GPT-6 Luna, Gemini 4 Argon, Gemini 3.8 Flash, DeepSeek, Mistral, Qwen, GLM e Grok. Como escolher:
| Caso de uso | Modelo recomendado |
|---|---|
| SDR / comercial conversacional | Claude Sonnet 5.5 ou GPT-6.1 Sol |
| Suporte FAQ, respostas padronizadas | Haiku 5.5 ou GPT-6 Luna (mais baratos) |
| Análise de dados grandes, áudio e vídeo | Gemini 4 Argon (1M de contexto) |
| Raciocínio complexo, revisão crítica | Claude Opus 5.5 |
| Volume muito alto com custo mínimo | DeepSeek V4.1 Flash ou GLM 5.3 Flash |
Em dúvida? Claude Sonnet 5.5 é o padrão e serve para a maioria 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.