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.
Corrija o erro de digitação no Meu site e o preço da Loja, depois organize as fotos novas.
chiefum chat · partes antigas resumidas · seus limites
feitoCorrigir erro de digitação no Meu site
perguntaCorrigir preço da Loja
em andamentoOrganizar fotos novas
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/ chief chiefé criado no primeiro uso, então a lista de Bots nunca fica vazia.- Onde roda
https://Os Bots rodam no Hoody Agent ({p}-{c}-agent-1.{node}.computers.hoody.com/ api/ v1/ agent/ bots agent-1). Não no app de chat em/api/bot/.
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 /Cada agente delegado é uma sessão comum, lida ou conectada pelas rotasapi/ v1/ agent/ bots/ chief/ delegates ?state=open /sessions. As sessões abertas trazemcapabilityecurrent_step.- Turno ao vivo próprio
GET /Texto da resposta e raciocínio conforme são escritos, chamadas de ferramentas e o fim de cada turno.api/ v1/ agent/ sessions/ {session_id}/ stream session_idvem deGET /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.
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.
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.
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.
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.
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.
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.
Corrigir erro de digitação no preço
em andamentoperguntafeitono Meu sitemodelo: Hoody AI (grátis)
agora: edita a página de preçosaguarda: bash: ./publish.shrelatório enviado
Medir o tempo do checkout
em andamentoperguntafeitona Lojamodelo: Hoody AI (grátis)
agora: mede o tempo do checkoutrelatório enviado
Você, 10:02
Adicione o novo cardápio de outono à Loja e confirme que os testes de pedido ainda passam.
Lojista, 10:02
Já estou nisso. Um agente adiciona o cardápio e outro executa os testes de pedido. Aviso quando os dois terminarem.
Lojista, 10:14
O agente do cardápio está pronto para colocar o cardápio de outono no ar. Permitir?
bash: ./menu.sh
Você, 10:15
Sim, pode publicar.
Lojista, 10:21
Pronto: o cardápio de outono está no ar na Loja e os 48 testes de pedido passam.
Adicionar o cardápio de outono
em andamentoperguntafeitona Lojamodelo: Hoody AI (grátis)
agora: adiciona 12 pratos novosaguarda: bash: ./menu.shrelatório enviado
Executar os testes de pedido
em andamentoperguntafeitona Lojamodelo: Hoody AI (grátis)
agora: executa 48 testes de pedidorelatório enviado
Você, 21:40
O computador Fotos está quase cheio. Limpe as duplicatas e confira o backup.
Arquivista de fotos, 21:40
Já estou nisso. Um agente procura duplicatas e outro confere o backup. Volto com o resultado.
Arquivista de fotos, 21:52
O agente de limpeza achou 1.240 duplicatas. Apagar todas?
bash: ./clean.sh
Você, 21:53
Sim, pode apagar.
Arquivista de fotos, 22:05
Pronto: 1.240 duplicatas removidas, 18 GB livres de novo. O backup de ontem à noite está completo.
Remover duplicatas
em andamentoperguntafeitoem Fotosmodelo: Hoody AI (grátis)
agora: comparando fotosaguarda: bash: ./clean.shrelatório enviado
Verificar o backup
em andamentoperguntafeitoem Fotosmodelo: Hoody AI (grátis)
agora: lendo o backuprelatório enviado
Você, 08:03
Meu site está no ar? Alguém disse que o formulário de contato está quebrado.
Vigia do site, 08:03
Vou verificar. Um agente testa o site, outro examina o formulário. Volto com o resultado.
Vigia do site, 08:11
O agente do formulário achou o bug e tem uma correção. Publicar?
bash: ./publish.sh
Você, 08:12
Sim, publique.
Vigia do site, 08:19
Pronto: seu site está no ar e o formulário de contato voltou a funcionar. O agente do formulário testou depois da correção.
Corrigir o formulário de contato
em andamentoperguntafeitono Meu sitemodelo: Hoody AI (grátis)
agora: lendo erros do formulárioaguarda: bash: ./publish.shrelatório enviado
Verificar todas as páginas
em andamentoperguntafeitono Meu sitemodelo: Hoody AI (grátis)
agora: abrindo 40 páginasrelatório enviado
Você, 15:30
Qual das três ferramentas de newsletter é a mais barata para 5.000 leitores?
Parceiro de pesquisa, 15:30
Pode deixar. Dois agentes pesquisam as ferramentas. Volto com uma só recomendação.
Parceiro de pesquisa, 15:41
O agente de preços quer salvar as notas dele na Loja. Permitir?
write: notes/tools.md
Você, 15:42
Sim, salve.
Parceiro de pesquisa, 15:47
Pronto: a ferramenta B é a mais barata para 5.000 leitores. As notas na Loja listam os três preços.
Comparar os preços
em andamentoperguntafeitona Lojamodelo: Hoody AI (grátis)
agora: lendo três páginas de preçosaguarda: write: notes/tools.mdrelatório enviado
Comparar funcionalidades
em andamentoperguntafeitona Lojamodelo: Hoody AI (grátis)
agora: listando as funcionalidadesrelatório enviado
Na prática
- Sua mensagem
POST /Respondeapi/ v1/ agent/ bots/ chief/ messages 202commessage_id,stateeturn_id;state: queuedenquanto o Bot está ocupado.- Resposta do Bot
GET /SSE: um frameapi/ v1/ agent/ bots/ chief/ stream state, depois umrowpor linha de log; retome comLast-Event-ID.- Parar um agente
POST /Para na hora o trabalho desse agente, nunca o Bot.api/ v1/ agent/ bots/ chief/ delegates/ {sid}/ stop {"close": true}também encerra a sessão dele.- Diga em voz alta
POST /Uma gravação wav ou mp3 é transcrita e enviada como sua mensagem.api/ v1/ agent/ bots/ chief/ messages/ audio
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 1Em um app
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.
Exemplo Use um Bot como modelo
Conversa com seu Bot chief como com qualquer modelo de IA, em qualquer app que use o formato OpenAI.
Use meu Bot chief como modelo no meu próprio app.
import OpenAI from 'openai';
const chief = new OpenAI({
baseURL: 'https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1',
apiKey: 'any',
});
const res = await chief.chat.completions.create({
model: 'bot:global/chief',
messages: [{ role: 'user', content: 'Is the shop up?' }],
});import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions",
json={
"model": "bot:global/chief",
"messages": [{"role": "user", "content": "Is the shop up?"}],
},
)
print(r.json())BASE="https://{p}-{c}-agent-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/agent/bots/global/chief/v1/chat/completions" \
-H "Content-Type: application/json" \
-d '{"model": "bot:global/chief", "messages": [{"role": "user", "content": "Is the shop up?"}]}'curl -X POST "https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions" \
-H "Content-Type: application/json" \
-d '{"model": "bot:global/chief", "messages": [{"role": "user", "content": "Is the shop up?"}]}'import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions",
json={
"model": "bot:global/chief",
"messages": [{"role": "user", "content": "Is the shop up?"}],
},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions&method=POST&json={"model":"bot:global/chief","messages":[{"role":"user","content":"Is%20the%20shop%20up?"}]}&response=transparent2De 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.
Exemplo Dê uma tarefa a um Bot
Pede ao seu Bot chief que confira se a loja está no ar.
Peça ao meu Bot chief que confira se a loja está no ar.
hoody -c {c} agent bots messages send \
--id chief \
--text "Check that the shop is up"import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
const result = await box.agent.bots.sendMessage('chief', { text: 'Check that the shop is up' });
console.log(result.state);import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages",
json={"text": "Check that the shop is up"},
)
print(r.json())BASE="https://{p}-{c}-agent-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/agent/bots/chief/messages" \
-H "Content-Type: application/json" \
-d '{"text": "Check that the shop is up"}'curl -X POST "https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages" \
-H "Content-Type: application/json" \
-d '{"text": "Check that the shop is up"}'import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages",
json={"text": "Check that the shop is up"},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages&method=POST&json={"text":"Check%20that%20the%20shop%20is%20up"}&response=transparent3Quem 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}églobalou um id hex de 24 caracteres.GET /bots/{id}lista os Bots emurls. Bot compartilhado:https://<label>.hoody.bot/v1/chat/completionscom 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.
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
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),lenientouoff. 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;queuedenquanto o Bot está ocupado. AdicioneIdempotency-Keypara 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 é oseq, entãoLast-Event-IDretoma sozinho.- Entradas de voz
…/bots/{id}/voice · …/bots/{id}/realtimeUma conexão de voz ativa por Bot por vez;takeover=truesubstitui a atual. docs / api / agent / bots ↗
Mais: o 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
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
Memória que seus agentes mantêm
Na prática
- Leia o log
GET /api/v1/agent/bots/chief/logLinhas em ordem, paginadas porseq.- Acompanhe
GET /api/v1/agent/bots/chief/streamUm framestate, depois as linhas; um cursor que foi para o arquivo respondelagged.- Esquecer
POST /api/v1/agent/bots/chief/forgetLeia depois comGET …/archive; apague comPOST …/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.
IdaNa entrada
ObservarRegistre quem chamou e o que pediu, depois repasse a chamada.Ver scriptOcultar script
Regra:
POST /api/v1/agent/bots/*→/bot-auditmodule.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.hookfica 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-gatemodule.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, } }); };verifyClaimverifica 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-gatemodule.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 comonullé 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-answermodule.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 exigeIf-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.pathnomeia um script no seu próprio hoody-exec. Escreva-o no seu link exec;/bot-auditservebot-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.
Funciona no ChatGPT, no Claude ou em qualquer IA que acesse uma página. Copie e cole.
- 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õewindow.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