Ir para o conteúdo
Sua IA@https://hoody.com Connect to Hoody

Modo dev

Mantivemos tudo simples. Aqui está o Hoody, na prática.

Cada seção agora mostra as chamadas exatas da API do Bot por trás dela, com o botão Copiar. O conjunto completo de chamadas está no final.

Abrir as chamadas

hoody / bots

Bots

Fale com seus Bots.
Eles comandam os agentes.

Um Bot é um assistente que fica ativo, com um só chat que guarda toda a conversa. Peça o que quiser: ele abre agentes nos seus computadores, acompanha o trabalho deles e conta o que fizeram. Dê a ele uma URL .hoody.bot e compartilhe com pessoas e IAs de confiança usando chaves com nome.

Seu primeiro Bot, chief, já existe desde o início. O Hoody AI (grátis) já vem integrado. Ou entre com o ChatGPT. Os ajudantes do Bot podem usar o Claude Pro ou Max pelo Claude Code, quando você permitir.

Como se encaixaExemplo
Você

Corrija o erro de digitação no Meu site e o preço da Loja, depois organize as fotos novas.

Seu Bot

chiefum chat · partes antigas resumidas · seus limites

Agentes

feitoCorrigir erro de digitação no Meu site

perguntaCorrigir preço da Loja

em andamentoOrganizar fotos novas

Seus computadores
Meu site Loja Fotos

Cada agente é uma sessão completa do Hoody Agent em um dos seus computadores.

Na prática

Seu primeiro Bot
GET /api/v1/agent/bots/chiefchief é criado no primeiro uso, então a lista de Bots nunca fica vazia.
Onde roda
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsOs Bots rodam no Hoody Agent (agent-1). Não no app de chat em /api/bot/.
hoody / how it flows

Uma mensagem segue até o fim. Um relatório volta.

Você

de qualquer um destes

RelatórioPronto. A Loja foi corrigida.

Seus computadores

Seu Bot

recebe sua mensagem na hora e traz o resultado quando termina

Agente

ajudantes dele

Agente

ajudantes dele

  • Meu siteatualizar
  • Lojacorrigir
  • Fotosfazer backup

ExemploTudo roda nos seus computadores. Seu Bot conhece cada um.

Na prática

Agentes do Bot
GET /api/v1/agent/bots/chief/delegates?state=openCada agente delegado é uma sessão comum, lida ou conectada pelas rotas /sessions. As sessões abertas trazem capability e current_step.
Turno ao vivo próprio
GET /api/v1/agent/sessions/{session_id}/streamTexto da resposta e raciocínio conforme são escritos, chamadas de ferramentas e o fim de cada turno. session_id vem de GET /bots/{id} depois que o Bot recebe a primeira mensagem.
Mais: veja um turno completo, um Bot por vez

Você pede uma vez. Ele distribui o trabalho.

Ele responde, abre agentes para as partes longas e volta com as perguntas e os resultados deles.

Turno de exemplo

Você, 09:12

Corrija o erro de digitação no preço do Meu site. E descubra por que o checkout da Loja ficou lento.

Chief, 09:12

Já estou nisso. Vou abrir dois agentes: um no Meu site para a correção e outro na Loja para medir o tempo do checkout. Volto com o resultado.

abriu 2 agentes · Meu site, Loja

Chief, 09:19

O agente do Meu site corrigiu o erro de digitação e quer executar isto. Permitir?

bash: ./publish.sh

Você, 09:20

Sim, pode ir.

[relatório] Agente do Meu site concluiu: erro de digitação corrigido, site atualizado.

Chief, 09:31

Pronto no Meu site: a correção está no ar. O checkout espera por uma consulta lenta; o agente da Loja tem uma correção pronta para testar.

Escreva quando quiserUma mensagem enviada enquanto ele está ocupado espera a vez. Envie uma correção e ele lê as duas juntas.
Trabalha nos seus computadoresOs agentes rodam onde estão seu código e arquivos e continuam depois que você fecha a aba.
Volta para perguntarO pedido de um agente só é aprovado por uma mensagem sua, nunca pelo relatório de um agente.

Na prática

Sua mensagem
POST /api/v1/agent/bots/chief/messagesResponde 202 com message_id, state e turn_id; state: queued enquanto o Bot está ocupado.
Resposta do Bot
GET /api/v1/agent/bots/chief/streamSSE: um frame state, depois um row por linha de log; retome com Last-Event-ID.
Parar um agente
POST /api/v1/agent/bots/chief/delegates/{sid}/stopPara na hora o trabalho desse agente, nunca o Bot. {"close": true} também encerra a sessão dele.
Diga em voz alta
POST /api/v1/agent/bots/chief/messages/audioUma gravação wav ou mp3 é transcrita e enviada como sua mensagem.
hoody / api

Dê ao seu Bot uma URL pública. Conecte pessoas, apps e IAs de confiança.

Uma URL, três formas de acesso: como modelo para apps e SDKs que aceitam uma URL base (formato OpenAI ou Anthropic), como servidor MCP ou por HTTP puro, a partir de um script.

chief · URL do Bot

https://<label>.hoody.bot
QR code de um Bot, com a marca do Bot no meio, como o Hub o desenha: um celular que o escaneia abre a página de chat do Bot. Este exemplo abre hoody.com/bots.

1Em um app

Seu appIDs de exemplo
Formato
URL base<Bot URL>/v1
Modelobot:global/chief
Chave de APIsua chave hbk_
URL base<Bot URL>
Modelobot:global/chief
Chave de APIsua chave hbk_
URL do servidor<Bot URL>/mcp
TransporteHTTP, POST em cada requisição
Chave de APIsua chave hbk_

Chat completions, responses e models. Só a última mensagem do usuário é enviada; o prompt de sistema e as configurações do próprio app ficam de fora.

Messages e models, na URL sem /v1. Só a última mensagem do usuário é enviada; o prompt de sistema e as configurações do próprio app ficam de fora.

Seu Bot como servidor MCP: respostas JSON-RPC, sem sessão para manter e sem stream de eventos.

2De um script

HTTP puro

  • POST /bots/chief/messages

    Dê uma tarefa a ele a partir de um script, de uma tarefa cron ou de outra IA.

  • GET /bots/chief/stream

    Acompanhe as respostas prontas e os eventos dos agentes. O stream da sessão do Bot mostra o texto da resposta conforme é escrito.

  • POST /bots/chief/delegates/{sid}/stop

    Pare um agente; o Bot continua.

3Quem entra

Dê a cada pessoa ou app de confiança uma chave com nome. Pause-a, defina validade ou restrição de IPv4, ou revogue-a em separado.

Todos com uma chave compartilham uma só conversa. Compartilhe só com pessoas e IAs em que você confia.

Limite um Bot a um realm: os agentes dele veem só os computadores desse realm.

Na prática

Base do Bot
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}A OpenAI usa <base>/v1, a Anthropic usa a base e o MCP usa <base>/mcp. {realm} é global ou um id hex de 24 caracteres. GET /bots/{id} lista os Bots em urls. Bot compartilhado: https://<label>.hoody.bot/v1/chat/completions com uma chave Bearer.
Enviar uma mensagem
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'No máximo 64 KiB de texto; responde 202.
Parar um agente
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}Faz um agente delegado parar, mas não o Bot.
hoody / guardrails

Em português claro. Essa é toda a configuração.

Escreva o que seu Bot nunca deve fazer, com suas palavras. Salve. Pronto.

  • Sem sintaxe
  • Todo agente recebe
  • Tarefas arriscadas são verificadas antes de começar

chief · regrasExemplo

nunca faça push na main, abra um PR e espere por mim não mexa em cobrança, DNS nem pagamentos o banco de dados de produção é somente leitura se uma tarefa custar mais de US$ 20, pare e pergunte em dúvida? pergunte, não adivinhe

Na prática

Substituir as regras
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}Um campo de texto; o Bot recebe cada linha marcada com [guardrails updated] antes da próxima mensagem.
Nível de rigor
"guardrail_check": "strict"strict (padrão), lenient ou off. docs / api / agent / bots ↗

Na prática

Enviar de qualquer lugar
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Responde com 202; queued enquanto o Bot está ocupado. Adicione Idempotency-Key para repetir com segurança.
Retome o stream
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events; o id de cada frame de linha é o seq, então Last-Event-ID retoma sozinho.
Entradas de voz
…/bots/{id}/voice · …/bots/{id}/realtimeUma conexão de voz ativa por Bot por vez; takeover=true substitui a atual. docs / api / agent / bots ↗
Mais: o log
Exemplo: quatro dispositivos, um Bot, um log

Quatro dispositivos, um celular, um notebook, um terminal e um app de IA, estão conectados ao mesmo Bot. O celular e o notebook enviam no mesmo momento, às 22h31; as mensagens chegam como #152 e depois #153, e o Bot responde como #154. Todos os dispositivos veem a mesma ordem. Os turnos antigos viram um resumo curto, as linhas #1 a #120; os turnos mais recentes, #121 a #154, ficam na íntegra. O log completo guarda todas as linhas.

Todos os dispositivos, uma conversa. Seu celular, notebook, terminal e apps de IA ficam abertos no mesmo Bot ao mesmo tempo, e todos veem a mesma ordem. Quem tem a chave entra na mesma conversa, então compartilhe a chave só com pessoas de confiança.

Cada mensagem recebe o próximo número. Duas enviadas no mesmo momento entram como #152 e depois #153. Uma enviada enquanto o Bot está ocupado espera pelo próximo turno do Bot.

A conversa nunca fica sem espaço. Quando a janela do modelo enche, os turnos antigos viram um resumo curto, os mais recentes ficam na íntegra e o Bot segue em frente. O log guarda todas as linhas; ao esquecer, elas vão para o arquivo.

O que uma linha guarda
Cada linha tem seq, at, role (user, bot, event ou system) e text. Também pode ter session_id. O log é paginado por seq; o stream envia cada nova linha assim que ela é escrita.
Trocar de modelo
Um novo modelo começa na próxima sessão do Bot: ao redefinir, o log vai para o arquivo e a nova sessão é aberta. O arquivo continua legível até você limpá-lo.
Memória que seus agentes mantêm
Os agentes também salvam e buscam uma memória própria (por palavra-chave, significado e links entre itens), que não fica presa a um só app de IA. docs / api / agent / memory ↗

Na prática

Leia o log
GET /api/v1/agent/bots/chief/logLinhas em ordem, paginadas por seq.
Acompanhe
GET /api/v1/agent/bots/chief/streamUm frame state, depois as linhas; um cursor que foi para o arquivo responde lagged.
Esquecer
POST /api/v1/agent/bots/chief/forgetLeia depois com GET …/archive; apague com POST …/purge.
Mais: hooks

Adicione um hook. Seu script vê a chamada primeiro e a resposta por último.

Um hook envia as chamadas HTTP que combinam para o Bot, ou para a maioria dos outros serviços nos seus computadores, passando primeiro por um dos seus scripts Exec. Upgrades de WebSocket em um caminho que combina são recusados, então deixe fora da regra caminhos como as entradas de voz do Bot. Na entrada, ele pode observar, verificar, alterar, responder ou bloquear as chamadas. Na saída, pode ler a resposta e alterá-la antes de quem chamou recebê-la. Nenhum patch necessário.

Um ciclo que vai de quem chama até o Bot ou a maioria dos outros serviços nos seus computadores. As chamadas entram por cima e as respostas voltam por baixo. Um script Exec fica entre os dois caminhos, então vê cada chamada na entrada e cada resposta na saída. Cada hook tem um limite de tempo, 500 ms por padrão.

IdaNa entrada

  • ObservarRegistre quem chamou e o que pediu, depois repasse a chamada.Ver scriptOcultar script

    Regra: POST /api/v1/agent/bots/* → /bot-audit

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const ip = req.headers['x-real-ip'];
      console.log(metadata.hook.auditId,
        metadata.hook.origPath, ip);
      await metadata.hook.forward(req, res);
    };

    O script vê o IP real do cliente. Se for chamado sem um hook, metadata.hook fica vazio e ele responde 404. forward() repassa a chamada ao Bot como ela chegou.

  • VerificarDeixe passar só quem entrou na conta. Um limite de requisições fica no mesmo lugar.Ver scriptOcultar script

    Regra: any method except OPTIONS /api/v1/agent/bots/* → /identity-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const user = verifyClaim(
        req.headers['x-hoody-claim']);
      if (!user) {
        res.writeHead(401);
        return res.end();
      }
      await metadata.hook.forward(req, res,
        { headers: {
          'x-hoody-claim': null,
          'x-hoody-user': user.username,
        } });
    };

    verifyClaim verifica um claim de login do Hoody assinado com ED25519; a documentação tem o script completo. Quem não tiver um recebe 401 e nunca chega ao Bot. Essa regra também recusaria os caminhos de voz por WebSocket; restrinja-a para deixá-los de fora.

  • AlterarReescreva o método, o caminho, os cabeçalhos ou o corpo antes de chegar.
  • BloquearRecuse arquivos enviados que falhem na verificação de vírus ou chamadas acima do seu limite.
  • ResponderResponda direto, como “Já volto”, e o Bot nunca vê a chamada.Ver scriptOcultar script

    Regra: POST /api/v1/agent/bots/* → /bot-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      if (process.env.MAINTENANCE) {
        res.writeHead(503);
        return res.end('Back soon');
      }
      await metadata.hook.forward(req, res,
        { headers: { cookie: null } });
    };

    Uma resposta enviada pelo script nunca chega ao Bot. forward() também pode alterar o método, o caminho, os cabeçalhos ou o corpo; um cabeçalho definido como null é removido.

VoltaNa saída

  • Ler a respostaVeja o status, os cabeçalhos e o corpo antes de quem chamou.
  • ReescreverEnvie a resposta como está ou envie a sua.Ver scriptOcultar script

    Regra: any method except OPTIONS /api/v1/agent/bots/* → /bot-answer

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const up = await metadata.hook.fetchUpstream(req);
      if (up.status === 401) {
        res.writeHead(401);
        return res.end('Please sign in again');
      }
      res.setHeader('x-hoody-hook-audit', metadata.hook.auditId);
      await metadata.hook.pipeResponse(up, res,
        { method: req.method });
    };

    fetchUpstream() pega a resposta do Bot sem enviá-la, então o script a lê antes; pipeResponse() a envia adiante. Uma resposta em stream termina no limite de tempo do hook, no máximo 30.000 ms.

  • Limpar cabeçalhosRemova cabeçalhos privados das respostas e adicione uma CSP.

Cada hook tem um limite de tempo, 500 ms por padrão. Se o script falhar ou estourar o tempo, a chamada para aí. docs / proxy / hooks ↗

Na prática

Adicione um hook
POST /api/v1/computers/{id}/proxy/hooks/agent · If-Match: file:v<N> {"match":{"method":["POST"],"path":"/api/v1/agent/bots/*"},"script":{"path":"/bot-audit"},"timeout":500}O servidor dá um id ao hook. As regras rodam em ordem e vale a primeira que combinar.
Leia a versão
GET /api/v1/computers/{id}/proxy/hooks/agentToda alteração nos hooks exige If-Match: file:v<N> com a versão atual.
O script
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}O corpo do script aqui é só o formato: coloque seu código de auditoria no lugar de { … }. script.path nomeia um script no seu próprio hoody-exec. Escreva-o no seu link exec; /bot-audit serve bot-audit.js. docs / api / exec / script-management ↗

Comece grátis, em uma linha.

Comece no plano Free, sem cartão: o Hoody AI já vem integrado, e a IA que você já usa também funciona.

Sem código
Código
Sua IA@https://hoody.com Connect to Hoody

Funciona no ChatGPT, no Claude ou em qualquer IA que acesse uma página. Copie e cole.

Sua IA
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
Navegador
https://hub.hoody.com
docs / kit / agent
Terminal
ssh hoody.comQualquer computador com um cliente ssh, em um terminal interativo. Não precisa instalar nada.
docs / kit / agent
Skill
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkO segundo adiciona todas as páginas da documentação ao disco, para uso offline.
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shO segundo é para Linux e macOS. Sem instalar: npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript. Node.js 20.19 ou mais recente, Bun, Deno.
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
SDK web
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>Expõe window.HoodySDK. Fixe uma versão para produção e dê às páginas tokens de curta duração e com escopo definido.
docs / getting-started / quickstart

Desde 2021

Da privacidade à infraestrutura de agentes

hoody / kit

O que vem nos seus computadores

Cada serviço tem o próprio link. Abra, compartilhe ou passe para sua IA. Qualquer pessoa com o link pode acessá-lo até você protegê-lo. Os links do Kit têm este formato https://{p}-{c}-<kit>-1.{node}.computers.hoody.com: {p} é o seu projeto, {c} um dos seus computadores e {node} o servidor dele.

Computadores

Bots

API