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:

  1. Os agentes estão pausados? A parada de emergência é persistente — se foi acionada, continua valendo até ser desligada. Veja Parar agentes.
  2. O servidor está online? Em Servidores. Se está offline, o agente não tem como responder.
  3. O agente está Pronto? Ele pode estar instalando ou ter falhado ao instalar.
  4. 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.

  • Servidor pequeno demais para o preset — a instalação é recusada antes de começar, com a conta na tela (quantos agentes o preset instala, quanto de RAM ele precisa, quanto a máquina tem). Escolha um preset menor ou um servidor maior; a regra está em Servidores.

Corrija a causa e rode a instalação de novo. Ela é feita para poder ser repetida.

A instalação concluiu com avisos

Terminou, mas alguns passos ficaram em âmbar. Abra cada um: as linhas que o servidor escreveu estão ali. Os casos comuns:

  • Um item padrão do motor de missões não instalou (por exemplo, uma extensão do marketplace) — o motivo está na linha warn=item_failed. Na página do servidor, Atualizar itens padrão tenta de novo; se persistir, é o marketplace do projeto que mudou, e o próximo conjunto de versões verificado corrige.
  • Memória abaixo do recomendado — a instalação segue, mas os agentes podem ficar apertados. Um servidor maior resolve; a página do agente mostra quanto de memória sobrou depois de instalá-lo.
  • Um agente com "gateway não ativo" e o aviso de memória — o servidor está matando processos por falta de memória. Não é a configuração do agente: é tamanho de servidor.

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