Pular para o conteúdo

Configurações do Agente

As Agente Settings definem toda a configuração comportamental, cognitiva e operacional de um Agente.
Cada parâmetro afeta diretamente como o Agente interpreta entradas, raciocina sobre o contexto e executa ações usando MCPs, Tools e Workflows conectados.

Esta seção detalha cada campo configurável disponível na interface do Agent Builder.


As configurações do Agente são salvas automaticamente. Não existe um botão Salvar.

Ao editar uma configuração, a Zaia salva em segundo plano a configuração completa e válida. Isso inclui a identidade do Agente, suas instruções, o modelo e as configurações comportamentais.

Campos de texto, como Role e Prompt, são salvos após 1,25 segundo sem digitação. Seletores, sliders e switches são salvos após 300 milissegundos.

A interface exibe Salvando… enquanto uma alteração está pendente, sendo salva ou sendo repetida. Você pode continuar editando durante esse período.

A Zaia preserva as edições mais recentes quando um salvamento anterior é concluído. Se um salvamento falhar temporariamente, suas alterações locais são mantidas e a tentativa é repetida automaticamente.

Se você sair da tela enquanto um salvamento está em andamento ou sendo repetido, a Zaia mostra o diálogo Alterações não salvas. Voltar permanece na tela. Sair sem salvar descarta as alterações ainda não persistidas e sai.

Provedor e Modelo são salvos juntos. Ao selecionar outro provedor, a Zaia atualiza os modelos disponíveis e seleciona o primeiro modelo compatível sempre que possível.

O Prompt, o Role e os demais campos já preenchidos continuam sendo salvos mesmo se o seletor de Modelo ainda mostrar Carregando modelos…. A Zaia usa o provedor e o modelo já selecionados no Agente.

A Zaia só persiste a configuração quando o Agente já tem um provedor e um modelo válidos. Enquanto a lista carrega, o seletor de Modelo fica indisponível — espere a lista para trocar de modelo.

Alterar apenas o Modelo aciona o mesmo fluxo de salvamento automático. A nova seleção é persistida sem alterar o Prompt ou outras configurações do Agente.

No seletor de Modelo, a lista mostra um indicador de custo relativo ($ × N, níveis 1 a 5) para comparar o consumo de créditos entre os modelos disponíveis. Veja Model Selection.


Seção Descrição
Model Selection Define o provider e o modelo de LLM usados para o raciocínio.
Vozes Define o preset de voz (Zaia ou ElevenLabs) usado quando o canal responde em áudio. Veja Vozes.
Role Estabelece a identidade e o propósito do Agente.
Prompt Configura tom, lógica e regras de comunicação.
Temperature Controla criatividade versus consistência.
Effort Determina a profundidade do raciocínio e o número de iterações.
Planning Habilita a decomposição de tarefas e a execução em múltiplas etapas.
Supervision Permite validação iterativa e autocorreção.
Tasks Adiciona comportamentos automatizados condicionais.
Detector de bots Liga ou desliga, por agente, a contenção de loop de mensagens (ticket humano, sem bloquear o contato) e o prompt daquele Agente. Veja Detector de bots.
Internal Chat Espaço interativo para testes e ajuste fino.

Juntas, essas configurações definem como cada Agente pensa, decide e age dentro do ecossistema Endless.