Configurações do Agente
Esta é uma página de referência com todas as opções de configuração disponíveis para agentes. Se você está começando, consulte Criando seu App primeiro.
A seção de configurações define como o agente se comporta, quais recursos pode utilizar e quais dados pode acessar. Essas configurações impactam diretamente a qualidade das respostas, automações e integrações.
Prompt
O prompt é a instrução principal que guia o comportamento do agente.
- Define tom, objetivo, regras e contexto
- Pode ser editado manualmente
- Recomenda-se ajustar via Agent Builder (mais seguro e estruturado)
Uso incorreto do prompt pode comprometer toda a lógica do agente.
Ferramentas (Tools)
Define quais ações o agente pode executar dentro da plataforma.
Ferramentas disponíveis
| Ferramenta | Descrição |
|---|---|
| Clientes | Gerenciar contatos e dados de clientes |
| Tarefas | Criar e gerenciar tarefas |
| Agendas | Gerenciar eventos e compromissos |
| Negócios | Pipeline de vendas (CRM) |
| Lembretes | Agendar lembretes automáticos |
| Mídias | Enviar e gerenciar arquivos |
| Automações | Executar fluxos automatizados |
| Relatórios | Consultar dados e métricas |
Diretrizes de uso
Se NÃO for utilizar o CRM do Tyxter:
- Desativar: Agendas, Tarefas, Negócios
- Manter: Clientes, Lembretes, Mídias, Automações, Relatórios
Se for usar ferramentas externas (ex: Google Calendar):
- Desativar funcionalidades equivalentes do Tyxter
- Evitar redundância e conflitos de dados
Templates do WhatsApp
Permite vincular templates de mensagens criados dentro da plataforma. Usado para padronizar comunicação e garantir consistência em mensagens críticas.
Mensagem de Onboarding
Mensagem inicial enviada ao usuário quando inicia interação com o agente. Serve para apresentar o agente, definir contexto inicial e guiar o usuário nos primeiros passos.
Instruções Personalizadas
Regras adicionais que refinam o comportamento do agente:
- Ajustar forma de atendimento
- Definir estilo de resposta
- Especificar restrições ou prioridades
É o principal ponto de controle fino do agente.
Aplicação do Onboarding
Define o nível de rigor do agente ao coletar informações do usuário:
| Modo | Comportamento |
|---|---|
| Rigoroso | Coleta dados antes de responder, mantém controle da conversa, não avança sem informações necessárias |
| Flexível | Responde rapidamente, menor exigência de dados, conversa mais fluida |
A escolha depende do tipo de operação (ex: vendas → rigoroso, suporte → flexível).
Instalação (WhatsApp API)
Conecta o agente ao canal de comunicação via API oficial do WhatsApp. Configuração simples com documentação específica dentro da plataforma. Veja o guia completo em Integração com a Meta.
Configuração de LLM
Define qual modelo de IA será utilizado pelo agente.
Provedores suportados
- OpenAI — GPT 5.4 Mini (padrão)
- xAI — Grok 4.1
Chave própria (BYOK)
É possível conectar provedores externos:
- Anthropic (Claude)
- Google (Gemini)
Quando usar chave própria:
- Necessidade de modelos específicos
- Controle de custo
- Customização avançada
Controle de Acesso
Define quem pode interagir com o agente:
- Todos os usuários — acesso aberto
- Lista restrita — apenas usuários específicos (importar lista ou adicionar manualmente)
Casos de uso: produtos pagos, acesso exclusivo, testes controlados.
Base de Conhecimento
Permite adicionar dados que o agente utiliza para responder.
Tipos suportados: planilhas, PDFs, documentos
A base de conhecimento fornece contexto real para respostas baseadas em dados. Exemplo: agente imobiliário que busca imóveis a partir de um inventário carregado.
Sem base de conhecimento, o agente responde apenas com conhecimento genérico do modelo de IA.
APIs Externas
Permite conectar o agente a sistemas externos (ex: Shopify, Google Calendar, sistemas internos).
Configuração
API simples:
- Inserir chave da API
- Configurar endpoints
API que exige hospedagem:
- Utilizar serviço como Cloudflare Workers
- Gerar URL da API
- Configurar endpoints no Tyxter
Cloudflare Workers é recomendado para hospedar APIs intermediárias — oferece controle, flexibilidade e é gratuito em muitos casos.
Diretrizes Gerais
- Evitar redundância entre ferramentas internas e externas
- Garantir que o agente tenha apenas os recursos necessários
- Usar base de conhecimento sempre que houver dados estruturados
- Integrar APIs quando houver necessidade de ação real fora da plataforma
Configuração errada não quebra só uma função — compromete todo o comportamento do agente.