Solução de problemas
O que fazer quando algo não funciona. Comece sempre pela mesma pergunta: o servidor está online? Metade dos problemas termina aí.
Meu agente não responde
Confira nesta ordem:
- Os agentes estão pausados? A parada de emergência é persistente — se foi acionada, continua valendo até ser desligada. Veja Parar agentes.
- O servidor está online? Em Servidores. Se está offline, o agente não tem como responder.
- O agente está Pronto? Ele pode estar instalando ou ter falhado ao instalar.
- A chave do modelo está válida? Uma chave expirada ou sem crédito faz o agente falhar ao pensar. Confira em Credenciais → Modelos.
O servidor está offline
Offline significa que a máquina parou de falar com a Bia. Causas comuns:
- A máquina está desligada ou reiniciando.
- Perdeu rede.
- O provedor bloqueou o IP. Acontece após muitas tentativas de conexão malsucedidas.
Se a máquina está de pé e com rede, e mesmo assim aparece offline, entre nela por SSH e confira se os serviços do runtime estão rodando.
Comandos enfileirados enquanto isso não se perdem imediatamente — são entregues quando o servidor volta, ou expiram se ficarem parados tempo demais.
A instalação falhou
O erro aparece na própria página do servidor, com a etapa que quebrou. As causas mais comuns:
- SSH inacessível — porta errada, firewall bloqueando, ou o endereço mudou.
- Sem permissão de
root— a instalação mexe em serviços do sistema. - Sistema operacional não suportado — use uma distribuição recente e comum.
- Máquina sem espaço em disco.
Corrija a causa e rode a instalação de novo. Ela é feita para poder ser repetida.
Se você já instalou uma vez nessa máquina, a senha SSH provavelmente não funciona mais — o endurecimento troca o acesso para chave. Reinstale o sistema operacional para voltar ao estado inicial.
Um agendamento não executou
- O servidor estava offline no horário. O agendamento roda na máquina; se ela estava fora, aquela execução não acontece e não fica em fila.
- O fuso é o do servidor, não o seu. Confira o horário da próxima execução na página.
- A lista é um espelho do que existe no servidor. Um agendamento novo costuma aparecer em segundos, e no pior caso em cerca de um minuto. Se acabou de criar e ainda não apareceu, espere antes de criar de novo — senão ficam dois.
Um arquivo não abre
Ao clicar em Buscar do servidor você pode ver:
- "não está mais no seu servidor" — o arquivo foi apagado. A linha sai da lista sozinha.
- "a Bia não pode buscar este tipo de arquivo" — o formato está fora da lista permitida. Formatos onde credenciais costumam viver ficam de fora por construção.
- "o servidor está offline" — reconecte a máquina.
O Telegram não responde
- Cada agente precisa do próprio bot. Dois agentes no mesmo token brigam pelas mensagens e nenhum funciona.
- A pessoa está autorizada? Só quem está na lista de pessoas permitidas recebe resposta.
- O token está correto? Um token revogado no BotFather para de funcionar sem aviso.
Mudei a persona e nada mudou
Editar salva na Bia, mas o agente que já roda no servidor continua com a versão antiga até você reaplicar. O painel avisa quando há mudanças pendentes.
Se você reaplicou e o comportamento continua, procure uma diretriz — diretrizes têm precedência sobre a persona, e é comum uma antiga estar sobrepondo o que você acabou de escrever. Veja Memória e diretrizes.
Ainda não resolveu
Reúna: o nome do servidor, o nome do agente, o horário aproximado e o que você esperava que acontecesse. A página Atividade mostra o que a Bia fez e quando — normalmente é lá que a linha do tempo do problema aparece.
Próximos passos
- Parar agentes — congelar tudo enquanto investiga.
- Servidores — status e instalação.