Pular para o conteúdo
use-cases / tail-your-agent-on-the-train / hero
PIPE · TAIL · NOTIFY

Acompanhe seu agente no trem, receba um aviso quando ele terminar

Você disparou um agente de quarenta minutos antes de sair do escritório. Agora você está no trem. O agente envia o trace para um caminho de pipe; você faz curl da mesma URL pelo celular e vê as mensagens de estado passando. Quando o loop termina, o hoody-notifications te avisa. Duas URLs e um buzz — sem SDK, sem dashboard, sem polling.

Leia a API do Pipe
use-cases / tail-your-agent-on-the-train / surfaces

Um celular, duas superfícies

Tail ao vivo em cima, notificação push embaixo — mesmo celular, mesmo agente. O trace é o monólogo em execução que você espia; a notificação é o ponto final. Você não precisa escolher qual conectar: ambos vêm do agente, ambos chegam ao dispositivo que já está no seu bolso.

01 · TAIL AO VIVO

O trace, caractere por caractere

O loop do seu agente envia cada evento por PUT em um caminho. Do trem, você faz GET do mesmo caminho em um app de terminal. As linhas chegam conforme acontecem — sem refresh de cinco segundos, sem timestamp de "última atualização". Você olha a tela, vê que o agente está vivo e guarda o celular.

[think] plano: dump → diff → write[tool_use] sql.exec("SELECT …")[result] 412 linhas · 88 ms
02 · PUSH

O buzz, no caminho até sua estação

Quando o loop externo termina, a última chamada do agente atinge o hoody-notifications com um resumo de uma linha. Seu celular vibra. Você não desbloqueia — lê o banner e sabe que a execução terminou antes mesmo de chegar à próxima estação.

AGENTE · billing-reconcile-7Reconciliação concluída · 412 linhas · 0 errosconcluído em 41:08 · 08:55

Hoody Pipe carrega o tail ao vivo; hoody-notifications carrega o buzz. O agente trata os dois como qualquer outra chamada HTTP — um PUT e um POST, sem SDK no meio.

use-cases / tail-your-agent-on-the-train / wire

Três chamadas a partir do agente. Nenhuma do seu laptop.

O agente roda em um servidor que você configurou antes de sair. Enquanto você se move, seu celular é o único cliente no loop. O agente faz todo o trabalho; o celular faz toda a observação.

agent.loop · pipe + notify
01 · AGENTEPUT cada passo em um caminho de pipe

Dentro do loop, cada evento — think, tool_use, result — é enviado para um único caminho. O pipe transmite para quem estiver lendo; se ninguém estiver lendo ainda, o caminho fica aberto por até cinco minutos.

PUT https://agent-pipe.…hoody.com/api/v1/pipe/agent-trace
02 · CELULARGET do mesmo caminho a partir do trem

Abra um terminal no celular. curl -N o caminho. O trace aparece conforme chega — sem encanamento SSE, sem broker, sem app para instalar. Feche a aba quando não quiser mais olhar.

$ curl -N https://agent-pipe.…hoody.com/api/v1/pipe/agent-trace
03 · NOTIFICARA última ação do agente é um POST para /notify

Quando o loop externo retorna, o agente posta um resumo de uma linha no hoody-notifications. Seu celular recebe o push do sistema a partir daí — mesmo buzz de um lembrete de calendário, sem app necessário.

POST /notify ["summary":"billing-reconcile-7","body":"completed in 41:08"]

Dois caminhos HTTP e um terceiro para o buzz. O agente não sabe que seu celular existe; ele apenas fala HTTP. O celular não sabe do contêiner do agente; ele apenas abre uma URL.

use-cases / tail-your-agent-on-the-train / anatomy

Anatomia de uma olhada

Você não lê cada palavra. Você bate o olho em três tokens: um pensamento, uma chamada, um resultado. Se eles estão se mexendo, o agente está vivo. Se param, você confere o horário no próximo push.

01 · AZUL

[think] — o que o modelo está planejando

Por que o agente escolheu essa ferramenta, o que ele espera de volta, onde ele pode bifurcar. Ler isso num trem é ler a mente do agente em tempo real — uma linha por passo de raciocínio.

[think] reconciliar faturas de jul
02 · NEUTRO

[tool_use] — a chamada que ele acabou de disparar

A função exata e os argumentos que o agente decidiu invocar. Uma linha por chamada, na ordem em que dispararam. Sem abstração de SDK, sem ID opaco — apenas a requisição no nível do wire.

[tool_use] sql.exec("SELECT …")
03 · VERDE

[result] — o que voltou, e o buzz

Contagens de linhas, durações, códigos de status — as coisas sobre as quais a próxima linha [think] vai raciocinar. Quando o loop externo termina, o resultado final chega no wire e o hoody-notifications faz o celular no seu bolso vibrar.

[result] 412 linhas · 88 ms
use-cases / tail-your-agent-on-the-train / punchline

Seu celular é a barra de status do agente.

Sem dashboard. Sem app. Sem SDK enviado para o dispositivo. O agente roda em um servidor, o status vive no seu celular, e a única coisa entre os dois é HTTP. Você pode trocar de trem, trocar de operadora, perder sinal por duas estações — quando reconectar, a próxima linha [result] continua imprimindo.

  • sem dashboard
  • sem app
  • sem polling
  • só HTTP
Leia a API do Pipe
use-cases / tail-your-agent-on-the-train / replaces

O que isto substitui

Acompanhar um agente de longa duração historicamente significou um SaaS, uma aba de dashboard ou um webhook + bot custom. Nada disso sobrevive à pergunta "e se eu simplesmente fizer curl pelo celular?".

  • Dashboards AgentOps / LangSmithUma camada SaaS para ler seus próprios logs
  • Datadog APM para agentesFeito para serviços, esquisito para loops
  • Webhooks de agente customCola que você escreve uma vez, debuga para sempre
  • Alertas PushoverMais uma conta, mais uma chave de API
  • Bots de status no TelegramUm bot por projeto · token apodrecendo
  • Polling /status a cada 5 segundosLatência que você inventou · bateria que você gasta
use-cases / tail-your-agent-on-the-train / cta

Pipe o trace, poste o buzz. Seu celular é a barra de status do agente — sem app necessário.

Leia a API do Pipe
use-cases / tail-your-agent-on-the-train / related

Leia os outros