Web do agente

O Agente Fire inclui duas páginas web integradas, servidas pelo próprio agente (não exigem conexão com a internet). Servem para verificar o status, diagnosticar e fazer testes de impressão sem o aplicativo de ponto de venda. As duas só são acessíveis do mesmo equipamento onde o agente roda, porque ele escuta apenas em 127.0.0.1 (localhost).

​

Pré-requisitos

• O Agente Fire deve estar instalado e em execução (ícone visível na bandeja do sistema). Se não estiver, consulte Instalação no Windows.
• Um navegador compatível: Chrome ou Edge 105+, Brave, Opera ou Firefox 110+. Veja requisitos do terminal.
• O token do agente (FIRE_AGENT_TOKEN). Em instalações novas o valor padrão é fire-agent-dev-token; em produção é o que foi configurado durante a instalação.

​

Página de testes

A página de testes permite conectar ao agente e imprimir comprovantes de exemplo. É a ferramenta principal para confirmar que uma impressora funciona. A interface tem uma barra lateral esquerda com quatro seções (Connection, Printers, Print, Log) e um botão Connect / Disconnect no canto superior direito.

​

Abrir a página

Abra http://localhost:9100/ no navegador. A interface Fire Agent será exibida.

​

Connection (Conexão)

É a seção mostrada ao abrir a página.

1. No campo FIRE_AGENT_TOKEN, digite o token do agente. Use o ícone de olho para mostrá-lo ou ocultá-lo.
2. Clique em Connect (canto superior direito).
3. O indicador de status muda:
   • Connecting… (amarelo): estabelecendo a conexão.
   • Connected (verde): conexão bem-sucedida.
   • Error (vermelho): não foi possível conectar (verifique se o agente está rodando).
4. Ao conectar, o agente lista as impressoras automaticamente e o botão muda para Disconnect.

​

Printers (Impressoras)

1. Clique em Printers na barra lateral.
2. Você verá as impressoras detectadas no Windows. A padrão aparece como (default).
3. Selecione uma impressora no menu Select printer. A seleção fica salva para a próxima vez.
4. Se conectou uma impressora nova, clique em Refresh para consultá-las novamente.

​

Print (Imprimir)

Esta seção envia trabalhos de impressão de teste para a impressora selecionada.

1. Confirme que selecionou uma impressora na seção anterior.
2. Edite o conteúdo do comprovante na caixa ESC/POS content (vem com um exemplo pré-carregado).
3. Use um dos quatro botões:

O resultado de cada ação aparece na seção Log.

​

Log (Registro)

Mostra, com marca de tempo, todas as mensagens trocadas com o agente:

• Em amarelo: mensagens enviadas (→) ao agente.
• Em verde: respostas corretas (← print_ok, printers, pong).
• Em vermelho: erros (← ERROR: …).

Use o botão Clear para limpar o registro. É a primeira seção a revisar quando algo não funciona.

​

Formatação do comprovante

Dentro da caixa de texto você pode aplicar ênfase com marcadores: O conteúdo é centralizado automaticamente e linhas de avanço são adicionadas no final.

​

Salvamento automático

A página lembra a configuração no navegador (localStorage): Se o token já estiver salvo, ao abrir a página o agente se conecta sozinho e lista as impressoras.

​

Painel informativo

O painel é uma visão somente leitura (não imprime). Resume o status do agente e se atualiza sozinho a cada 30 segundos. Abra em http://localhost:9100/panel (ou clique no ícone do Fire Agent na bandeja do sistema). A barra lateral tem quatro seções: O botão ↻ Refresh força uma atualização imediata de todos os dados. A seção Printers mostra, em cartões, as impressoras detectadas e o status: A seção Connection mostra as URLs disponíveis para conectar ao agente:

​

Tema claro / escuro

As duas páginas têm um botão de tema (ícone de sol/lua) no canto superior direito. Ao clicar, alterna entre modo escuro e claro, e a preferência é salva no navegador.

​

Solução de problemas