Configurações Avançadas
A aba Avançado reúne o estado do agente, o acesso por categoria, os limites de resposta e o comportamento nos canais externos. Abra Agentes, selecione o agente e escolha Avançado na barra lateral.
As alterações ficam como rascunho. Use Salvar alterações para aplicá-las ou Descartar para voltar aos últimos valores carregados. Se o salvamento apresentar erro, confira os campos e a categoria antes de tentar novamente: esses dois grupos são persistidos em operações separadas.
Valores iniciais do agente
Section titled “Valores iniciais do agente”Um agente criado pela tela atual de Agentes começa com estes valores:
| Configuração | Valor inicial | Faixa disponível |
|---|---|---|
| Agente ativo | ligado | ligado ou desligado |
| Temperatura | 1.0 | 0.0 a 2.0, em passos de 0.1 |
| Memória de contexto | 30 mensagens | 1 a 50 |
| Buscar em conversas anteriores | ligado | ligado ou desligado |
| Máximo de tool calls | 14 | 1 a 20 |
| Agrupar mensagens | desligado | desligado ou janela de 10 a 60 segundos |
| Dividir resposta em várias mensagens | desligado | ligado ou desligado |
Estado e categoria
Section titled “Estado e categoria”Agente ativo controla se o agente pode responder. Ao desligá-lo e salvar, o agente deixa de responder em canais, automações e gatilhos, mas conserva sua configuração. Reative e salve para voltar a usá-lo.
Categoria limita o acesso ao agente de acordo com as categorias autorizadas para cada equipe. Sem categoria remove esse recorte por categoria; as permissões da organização continuam valendo. Se a categoria esperada não estiver disponível, peça a uma pessoa autorizada para revisar categorias e equipes em vez de escolher outra apenas para concluir o salvamento.
Comportamento de resposta
Section titled “Comportamento de resposta”Temperatura
Section titled “Temperatura”Controla a variedade da saída. Valores próximos de 0.0 favorecem respostas mais previsíveis; valores altos aumentam a variação. Para suporte, extração e procedimentos, comece baixo. Para ideação e texto criativo, aumente aos poucos e valide respostas reais.
Memória de contexto
Section titled “Memória de contexto”Define quantas mensagens recentes da conversa entram no contexto do próximo turno. Uma janela maior ajuda em conversas longas, mas aumenta o volume enviado ao modelo. Reduza apenas quando o contexto antigo não for necessário.
Buscar em conversas anteriores
Section titled “Buscar em conversas anteriores”Quando ligada, disponibiliza ao agente uma ferramenta para localizar resumos de conversas anteriores da mesma pessoa com o mesmo agente. Ela funciona somente numa conversa individual do Hub: não cruza pessoas, agentes, salas, conversas diretas entre pessoas nem canais externos. A busca devolve título, data, tópicos e resumo, não a transcrição completa.
Essa opção é diferente da Memória de contexto: memória lê mensagens recentes da conversa atual; busca procura resumos de outras conversas elegíveis.
Tamanho da resposta
Section titled “Tamanho da resposta”Não existe ajuste de tamanho nesta tela. O comprimento da resposta você define no prompt do agente — por exemplo, “responda em no máximo 3 frases” ou “responda em um parágrafo curto”. Escrito no prompt, o modelo planeja o tamanho e conclui o raciocínio; imposto como limite técnico, ele apenas interrompia a resposta no meio. Respostas curtas também não reduzem o custo por si só: a cobrança acompanha o texto que o modelo realmente gera.
Máximo de tool calls
Section titled “Máximo de tool calls”Limita quantas ferramentas o agente pode encadear num turno antes do fechamento final. Cada consulta a base, API, transferência ou outra ferramenta conta como uma chamada. O runtime reserva um passo adicional para a resposta final e limita valores legados acima de 20 a 20. O tempo total do turno ainda pode encerrar um fluxo antes do número escolhido.
Resposta em canais externos
Section titled “Resposta em canais externos”Agrupar mensagens
Section titled “Agrupar mensagens”Ao ligar Agrupar mensagens, escolha uma janela entre 10 e 60 segundos. WhatsApp QR, Z-API, Uazapi, Evolution, WhatsApp Oficial, Telegram e API assíncrona aguardam a sequência e tratam as mensagens recebidas como um único pedido. Cada mensagem nova reinicia a espera, com teto de três vezes a janela contado desde a primeira.
Quando desligado, esses canais continuam passando pela fila de serialização, mas cada mensagem forma seu próprio grupo e é processada sem a janela de espera. O ajuste não se aplica ao Hub, página pública, widget, Instagram Direct nem API síncrona.
Dividir resposta em várias mensagens
Section titled “Dividir resposta em várias mensagens”Quando ligada, a divisão transforma cada parágrafo, separado por uma linha em branco, em uma entrega independente. Ela vale para Telegram, Instagram Direct, WhatsApp Oficial e conexões WhatsApp QR, Z-API, Uazapi e Evolution. Hub, página pública, widget e API ignoram o ajuste.
Exemplo de resposta em três mensagens:
Claro, posso ajudar.
As 14h estão livres.
Quer que eu confirme?O envio de fotos independe dessa opção. Quando o agente inclui uma imagem de uma URL pública na resposta, o SquadOS a entrega como foto nesses canais externos. Com a divisão desligada, o texto acompanha a primeira foto; cada imagem adicional segue em uma foto separada. Com a divisão ligada, o texto continua sendo dividido por parágrafo. Um link comum permanece link: o agente precisa escolher apresentar a imagem, não apenas citar seu endereço. Áudio, vídeo e arquivos não recebem esse tratamento.
Você pode dizer no prompt quando o agente deve mostrar fotos, sem escrever instruções de formatação. O AgentMaker pode ajudar a redigir essa regra. Entre mensagens separadas, o canal pode mostrar o indicador de digitação e aplicar uma pausa curta; não prometa uma cadência exata ao cliente.
Deletar Agente
Section titled “Deletar Agente”A Zona de Perigo aparece somente para quem possui a permissão agents.delete. O botão visível é Deletar Agente, mas a operação preserva o registro e o histórico para análise: ela marca o agente como arquivado e inativo, desativa os gatilhos ativos e remove seus vínculos com times.
O modal mostra quantos gatilhos serão desativados e de quantos times o agente será removido. Para confirmar, copie ou digite o nome do agente exatamente, incluindo maiúsculas e espaços, e escolha Deletar permanentemente.
Não existe restauração na interface atual. Antes de confirmar, registre configurações que precisem ser recriadas e verifique o impacto nas jornadas que dependem do agente.
Checklist de validação
Section titled “Checklist de validação”Depois de salvar:
- saia da aba e volte para confirmar os valores persistidos;
- teste uma resposta curta e outra que use ferramentas;
- se alterou memória ou busca anterior, valide uma conversa individual no Hub;
- se alterou agrupamento ou divisão, teste no canal externo correspondente;
- confira custo, tempo e formato antes de liberar o agente para clientes.
Continue com Prompts de Sistema, Modelos e Testando seu Agente para validar o conjunto da configuração.