Ativar e pausar o agente

Ativar

1. Em /dashboard/[connectionId]/agent, certifique-se de que todos os campos obrigatorios (nome, prompt, provider, modelo) estao preenchidos.
2. Certifique-se de ter uma chave BYOK — global ou especifica do agente. Sem chave, o sistema nao permite ativar. Veja BYOK chave global.
3. Marque o toggle Ativo.
4. Clique em Salvar.

A partir dai, toda nova DM recebida e respondida automaticamente — desde que a conversa especifica nao esteja pausada.

Screenshot: form do agente com toggle "Ativo" marcado.

Desativar o agente inteiro

No mesmo form, desmarque Ativo e salve. O agente para de responder qualquer DM. Todas as mensagens recebidas continuam sendo armazenadas — voce continua vendo em Live Chat. Quando reativar, ele volta a responder somente mensagens novas (nao faz backfill).

Pausar apenas uma conversa

Dentro do Live Chat (/dashboard/[connectionId]/live-chat), cada conversa tem um botao Pausar IA. Isso:

• Define conversations.is_paused = true para aquela conversa.
• O agente para de responder apenas aquele cliente — os outros continuam sendo atendidos.
• Util quando voce quer assumir como humano.

Para voltar: clique em Retomar IA na mesma conversa.

Screenshot: Live Chat com botao "Pausar IA" no header da conversa.

Pausa automatica — quando o sistema pausa sozinho

O UltronChat pausa o agente em algumas situacoes:

1. Chave BYOK invalida ou removida

Se voce deleta a chave global e nao ha chave especifica configurada, ou se o provider retorna 401 (chave invalida, saldo zerado), o agente e pausado automaticamente. Voce ve o erro em agents.api_key_last_error.

Solucao: cadastre uma nova chave valida em /dashboard/settings/api-keys OU no proprio agente (tab Avancado), e reative manualmente.

2. Detectado loop IA-IA

O UltronChat monitora padroes de conversa. Se detectar que o outro lado tambem e IA (outra empresa com bot igual), ele pausa automaticamente a conversa para evitar gasto infinito em tokens.

3. Rate limit por conversa

Se uma mesma conversa recebe muitas mensagens num intervalo curto (limite interno nao configuravel), o agente espera antes de responder de novo. Isso raramente aparece em uso real.

Retomar apos pausa automatica

Em todos os casos, a pausa aparece como erro em:

• agents.is_active = false (pausa global por BYOK).
• conversations.is_paused = true (pausa por loop ou manualmente).

Voce reativa no form do agente ou no Live Chat. O historico e preservado.

Combinacoes possiveis

Estado do agente (is_active)	Estado da conversa (is_paused)	Resultado
Ativo	Nao pausada	IA responde normalmente
Ativo	Pausada	Mensagens chegam, IA nao responde (voce assume)
Inativo	Qualquer	IA nao responde nenhuma conversa

Proximo passo

BYOK chave global — pre-requisito para ativar qualquer agente.