Bots
Parla con i tuoi Bot.
Loro gestiscono gli agenti.
Un Bot è un assistente che resta attivo nel tempo, con una sola chat che conserva tutta la conversazione. Chiedigli qualsiasi cosa: apre agenti sui tuoi computer, segue il loro lavoro e ti riferisce cosa hanno fatto. Dagli un URL .hoody.bot e condividilo con persone e AI di fiducia usando chiavi con nome.
Il tuo primo Bot, chief, c'è fin dall'inizio. Hoody AI (gratis) è già integrata. Oppure accedi con ChatGPT. Gli aiutanti del Bot possono usare Claude Pro o Max con Claude Code quando lo consenti.
Correggi il refuso su Mio sito e il prezzo di Negozio, poi ordina le nuove foto.
chiefuna chat · le parti più vecchie riassunte · i tuoi limiti
fattoCorreggi il refuso su Mio sito
ti chiedeCorreggi il prezzo di Negozio
in corsoOrdina le nuove foto
Ogni agente è una sessione completa di Hoody Agent su uno dei tuoi computer.
In concreto
- Il tuo primo Bot
GET /api/ v1/ agent/ bots/ chief chiefsi crea al primo uso, quindi l'elenco dei Bot non è mai vuoto.- Dove gira
https://I Bot girano su Hoody Agent ({p}-{c}-agent-1.{node}.computers.hoody.com/ api/ v1/ agent/ bots agent-1). Non sul servizio di app di chat su/api/bot/.
Un messaggio arriva fino in fondo. Torna un report.
Tu
da uno qualsiasi di questi
ReportFatto. Negozio è sistemato.
I tuoi computer
Il tuo Bot
prende subito il tuo messaggio e riferisce quando ha finito
Agent
i suoi aiutanti
Agent
i suoi aiutanti
- Mio sitoaggiorna
- Negoziocorreggi
- Fotofai il backup
EsempioTutto gira sui tuoi computer. Il tuo Bot li conosce uno per uno.
In concreto
- I suoi agenti
GET /Ogni agente delegato è una sessione normale, che puoi leggere o collegare con le routeapi/ v1/ agent/ bots/ chief/ delegates ?state=open /sessions. Quelle aperte riportanocapabilityecurrent_step.- Il suo turno in diretta
GET /Testo della risposta e ragionamento mentre si scrivono, chiamate agli strumenti e fine di ogni turno.api/ v1/ agent/ sessions/ {session_id}/ stream session_idarriva daGET /bots/{id}dopo che il Bot ha ricevuto il primo messaggio.
Altro: guarda un turno completo, un Bot alla volta
Chiedi una volta. Il Bot assegna il lavoro.
Risponde, apre agenti per le parti lunghe e torna da te con le loro domande e i loro risultati.
Tu, 09:12
Correggi il refuso nel prezzo su Mio sito. E scopri perché il checkout di Negozio è diventato lento.
Chief, 09:12
Ci penso io. Apro due agenti: uno su Mio sito per la correzione, uno su Negozio per misurare il checkout. Ti aggiorno.
Chief, 09:19
L'agente di Mio sito ha corretto il refuso e vuole eseguire questo comando. Lo autorizzi?
bash: ./publish.sh
Tu, 09:20
Sì, vai.
Chief, 09:31
Fatto su Mio sito: la correzione è online. Il checkout aspetta una query lenta; l'agente di Negozio ha pronta una correzione da provare.
Tu, 09:12
Correggi il refuso nel prezzo su Mio sito. E scopri perché il checkout di Negozio è diventato lento.
Chief, 09:12
Ci penso io. Apro due agenti: uno su Mio sito per la correzione, uno su Negozio per misurare il checkout. Ti aggiorno.
Chief, 09:19
L'agente di Mio sito ha corretto il refuso e vuole eseguire questo comando. Lo autorizzi?
bash: ./publish.sh
Tu, 09:20
Sì, vai.
Chief, 09:31
Fatto su Mio sito: la correzione è online. Il checkout aspetta una query lenta; l'agente di Negozio ha pronta una correzione da provare.
Correggi il refuso nel prezzo
in corsoti chiedefattosu Mio sitomodello: Hoody AI (gratis)
ora: modifica la pagina dei prezziin attesa di: bash: ./publish.shha riferito
Misura il checkout
in corsoti chiedefattosu Negoziomodello: Hoody AI (gratis)
ora: misura il checkoutha riferito
Tu, 10:02
Aggiungi a Negozio il nuovo menu autunnale e controlla che i test degli ordini passino ancora.
Negoziante, 10:02
Ci penso io. Un agente aggiunge il menu, un altro esegue i test degli ordini. Ti dico quando hanno finito entrambi.
Negoziante, 10:14
L'agente del menu è pronto a mettere online il menu autunnale. Lo autorizzi?
bash: ./menu.sh
Tu, 10:15
Sì, pubblicalo.
Negoziante, 10:21
Fatto: il menu autunnale è online su Negozio e tutti i 48 test degli ordini passano.
Aggiungi il menu autunnale
in corsoti chiedefattosu Negoziomodello: Hoody AI (gratis)
ora: aggiunge 12 nuovi piattiin attesa di: bash: ./menu.shha riferito
Esegui i test degli ordini
in corsoti chiedefattosu Negoziomodello: Hoody AI (gratis)
ora: esegue 48 test degli ordiniha riferito
Tu, 21:40
Foto è quasi piena. Elimina i duplicati e controlla il backup.
Archivista foto, 21:40
Ci penso io. Un agente cerca i duplicati, un altro controlla il backup. Ti aggiorno.
Archivista foto, 21:52
L'agente di pulizia ha trovato 1.240 duplicati. Vuoi eliminarli?
bash: ./clean.sh
Tu, 21:53
Sì, eliminali.
Archivista foto, 22:05
Fatto: 1.240 duplicati eliminati, di nuovo 18 GB liberi. Il backup di ieri notte è completo.
Rimuovi i duplicati
in corsoti chiedefattosu Fotomodello: Hoody AI (gratis)
ora: confronta le fotoin attesa di: bash: ./clean.shha riferito
Controlla il backup
in corsoti chiedefattosu Fotomodello: Hoody AI (gratis)
ora: legge il backupha riferito
Tu, 08:03
Il mio sito è attivo? Qualcuno dice che il modulo di contatto non funziona.
Guardiano del sito, 08:03
Controllo subito. Un agente prova il sito, un altro guarda il modulo. Ti aggiorno io.
Guardiano del sito, 08:11
L'agente del modulo ha trovato il bug e ha pronta una correzione. La pubblico?
bash: ./publish.sh
Tu, 08:12
Sì, pubblicala.
Guardiano del sito, 08:19
Fatto: il mio sito è attivo e il modulo di contatto funziona di nuovo. L'agente del modulo l'ha provato dopo la correzione.
Correggi il modulo di contatto
in corsoti chiedefattosu Mio sitomodello: Hoody AI (gratis)
ora: legge gli errori del moduloin attesa di: bash: ./publish.shha riferito
Controlla ogni pagina
in corsoti chiedefattosu Mio sitomodello: Hoody AI (gratis)
ora: apre 40 pagineha riferito
Tu, 15:30
Quale di tre strumenti per newsletter costa meno per 5.000 lettori?
Aiuto ricerche, 15:30
Ci penso io. Due agenti studiano gli strumenti. Torno da te con una sola scelta.
Aiuto ricerche, 15:41
L'agente dei prezzi vuole salvare le sue note su Negozio. Glielo permetti?
write: notes/tools.md
Tu, 15:42
Sì, salvale.
Aiuto ricerche, 15:47
Fatto: lo strumento B è il più economico per 5.000 lettori. Le note su Negozio elencano tutti e tre i prezzi.
Confronta i prezzi
in corsoti chiedefattosu Negoziomodello: Hoody AI (gratis)
ora: legge tre pagine di prezziin attesa di: write: notes/tools.mdha riferito
Confronta le funzioni
in corsoti chiedefattosu Negoziomodello: Hoody AI (gratis)
ora: elenca le funzioniha riferito
In concreto
- Il tuo messaggio
POST /Risponde aapi/ v1/ agent/ bots/ chief/ messages 202conmessage_id,stateeturn_id;state: queuedmentre il Bot è occupato.- La sua risposta
GET /SSE: un frameapi/ v1/ agent/ bots/ chief/ stream state, poi unrowper ogni riga di log; riprendi conLast-Event-ID.- Ferma un agente
POST /Ferma subito il lavoro di quell'agente, mai il Bot.api/ v1/ agent/ bots/ chief/ delegates/ {sid}/ stop {"close": true}chiude anche la sua sessione.- Dillo a voce
POST /Una registrazione wav o mp3 è trascritta e inviata come tuo messaggio.api/ v1/ agent/ bots/ chief/ messages/ audio
Dai al tuo Bot un URL pubblico. Collega persone, app e AI di cui ti fidi.
Un solo URL, tre modi per entrare: come modello per app e SDK che accettano un URL di base (formato OpenAI o Anthropic), come server MCP o con HTTP semplice da uno script.
chief · Bot URL
https://<label>.hoody.bot 1In un'app
Completamenti chat, risposte e modelli. Al Bot arriva solo l'ultimo messaggio dell'utente; il prompt di sistema e le impostazioni dell'app restano fuori.
Messaggi e modelli, sull'URL senza /v1. Al Bot arriva solo l'ultimo messaggio dell'utente; il prompt di sistema e le impostazioni dell'app restano fuori.
Il tuo Bot come server MCP: risposte JSON-RPC, nessuna sessione da mantenere e nessuno stream di eventi.
Esempio Usa un Bot come modello
Parla con il tuo Bot chief come con qualsiasi modello AI, da qualsiasi app che usa il formato OpenAI.
Usa il mio Bot chief come modello nella mia 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=transparent2Da uno script
HTTP semplice
POST /bots/ chief/ messages Assegnagli un'attività da uno script, da un cron job o da un'altra AI.
GET /bots/ chief/ stream Segui le risposte complete e gli eventi degli agenti. Lo stream della sessione del Bot mostra il testo della risposta man mano che il Bot lo scrive.
POST /bots/ chief/ delegates/ {sid}/ stop Ferma un agente; il Bot va avanti.
Esempio Assegna un'attività a un Bot
Chiede al tuo Bot chief di controllare che il negozio sia attivo.
Chiedi al mio Bot chief di controllare che il negozio sia attivo.
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=transparent3Chi può entrare
Dai a ogni persona o app fidata una chiave con un nome. Mettila in pausa, imposta una scadenza o una restrizione IPv4, oppure revocala singolarmente.
Chiunque abbia una chiave condivide una sola conversazione. Condividi solo con persone e AI di cui ti fidi.
Limita un Bot a una sola area: i suoi agenti vedono solo i computer di quell'area.
In concreto
- Base del Bot
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI usa<base>/v1, Anthropic la base, MCP<base>/mcp.{realm}èglobalo un ID esadecimale di 24 caratteri.GET /bots/{id}li elenca inurls. Bot condiviso:https://<label>.hoody.bot/v1/chat/completionscon una chiave Bearer.- Invia un messaggio
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'Al massimo 64 KiB di testo; risponde 202.- Ferma un agente
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}Ferma un delegato, mai il Bot.
In parole semplici. La configurazione finisce qui.
Scrivi con parole tue cosa il Bot non deve mai fare. Salva. Fatto.
- Nessuna sintassi
- Ogni agente la riceve
- Le attività rischiose sono controllate prima di partire
chief · limitiEsempio
In concreto
- Sostituisci le regole
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}Un solo campo di testo; il Bot riceve ogni riga contrassegnata con[guardrails updated]prima del messaggio successivo.- Livello di rigore
"guardrail_check": "strict"strict(predefinito),lenientooff. docs / api / agent / bots ↗
In concreto
- Invia da ovunque
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Risponde 202;queuedmentre il Bot è occupato. AggiungiIdempotency-Keyper riprovare in sicurezza.- Riprendi lo stream
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events; l'id di ogni frame di riga è il suoseq, quindiLast-Event-IDriprende in automatico.- Accessi vocali
…/bots/{id}/voice · …/bots/{id}/realtimeUna sola connessione vocale attiva per Bot alla volta;takeover=truela sostituisce. docs / api / agent / bots ↗
Altro: il log
Quattro dispositivi (un telefono, un portatile, un terminale e un'app AI) sono aperti sullo stesso Bot. Il telefono e il portatile inviano nello stesso momento, alle 22:31; i messaggi arrivano come #152 e poi #153, e il Bot risponde come #154. Ogni dispositivo vede lo stesso ordine. I turni più vecchi diventano un breve riassunto, le righe da #1 a #120; i turni più recenti, da #121 a #154, restano parola per parola. Il log completo conserva ogni riga.
Ogni dispositivo, una conversazione. Telefono, portatile, terminale e app AI sono collegati allo stesso Bot in contemporanea e ogni dispositivo vede lo stesso ordine. Anche chi ha la chiave partecipa alla conversazione, quindi dai la chiave solo a persone fidate.
Ogni messaggio riceve il numero successivo. Due messaggi inviati nello stesso momento arrivano come #152 e poi #153. Uno inviato mentre il Bot è occupato aspetta il turno successivo.
Non resta mai senza spazio. Quando la finestra del modello si riempie, i turni più vecchi diventano un breve riassunto, i più recenti restano parola per parola e il Bot va avanti. Il log conserva ogni riga; forget le sposta nell'archivio.
Cosa contiene una riga
seq, at, role (user, bot, event o system) e text. Può avere anche session_id. Il log usa seq per la paginazione; lo stream invia ogni nuova riga al momento della scrittura.Cambiare modello
La memoria dei tuoi agenti
In concreto
- Leggi il log
GET /api/v1/agent/bots/chief/logRighe in ordine, paginate conseq.- Seguilo
GET /api/v1/agent/bots/chief/streamPrima un framestate, poi le righe; un cursore spostato nell'archivio risponde conlagged.- Dimentica
POST /api/v1/agent/bots/chief/forgetLeggilo più tardi conGET …/archive; eliminalo conPOST …/purge.- Documentazione
- docs / api / agent / bots ↗
Altro: hook
Inserisci un hook. Il tuo script vede la chiamata per primo e la risposta per ultimo.
Un hook fa passare prima per uno dei tuoi script Exec le chiamate HTTP corrispondenti, dirette al Bot o alla maggior parte degli altri servizi sui tuoi computer. Gli upgrade WebSocket su un percorso corrispondente sono rifiutati, quindi tieni fuori dalla corrispondenza percorsi come gli ingressi vocali del Bot. In ingresso può osservarle, controllarle, modificarle, rispondere o bloccarle. In uscita può leggere la risposta e modificarla prima che arrivi a chi ha chiamato. Nessuna patch da applicare.
AndataIn ingresso
OsservaRegistra chi ha chiamato e per cosa, poi inoltra la chiamata.Mostra lo scriptNascondi lo script
Regola:
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); };Lo script vede l'IP reale del client. Se lo chiami senza hook,
metadata.hookè vuoto, quindi risponde 404.forward()inoltra la chiamata al Bot così com'era.ControllaLascia passare solo chi ha fatto l'accesso. Qui c'è anche un limite di richieste.Mostra lo scriptNascondi lo script
Regola:
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 un claim di accesso Hoody firmato con ED25519; lo script completo è nella documentazione. Chi non ne ha uno riceve un 401 e non raggiunge mai il Bot. Questa regola rifiuterebbe anche i percorsi vocali WebSocket: restringila per escluderli.- ModificaRiscrivi metodo, percorso, header o corpo prima che la chiamata arrivi.
- BloccaRespingi i caricamenti che non superano una scansione antivirus, o le chiamate oltre il tuo limite.
RispondiRispondi tu, ad esempio “Torno subito”, e il Bot non vede mai la chiamata.Mostra lo scriptNascondi lo script
Regola:
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 } }); };Una risposta inviata dallo script non arriva mai al Bot.
forward()può anche modificare metodo, percorso, header o corpo; un header impostato sunullviene rimosso.
RitornoIn uscita
- Leggi la rispostaVedi stato, header e corpo prima di chi ha chiamato.
RiscriviInoltra la risposta così com'è, oppure invia la tua.Mostra lo scriptNascondi lo script
Regola:
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()riceve la risposta del Bot senza inviarla, così lo script la legge per primo;pipeResponse()la inoltra. Una risposta in streaming termina al limite di tempo dell'hook, 30.000 ms al massimo.- Pulisci gli headerRimuovi gli header privati dalle risposte, aggiungi una CSP.
Ogni hook ha un limite di tempo, 500 ms per impostazione predefinita. Se lo script fallisce o scade il tempo, la chiamata si ferma lì. docs / proxy / hooks ↗
In concreto
- Aggiungi un 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}L'id dell'hook lo assegna il server. Le regole si eseguono in ordine e vince la prima che corrisponde.- Leggi la versione
GET /api/v1/computers/{id}/proxy/hooks/agentOgni modifica agli hook richiedeIf-Match: file:v<N>con la versione corrente.- Lo script
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}Il corpo dello script qui è solo la struttura: al posto di{ … }inserisci il tuo codice di audit.script.pathindica uno script nel tuo hoody-exec. Scrivilo sul tuo link exec;/bot-auditesponebot-audit.js. docs / api / exec / script-management ↗- Documentazione
- docs / foundation / proxy / hooks ↗
Inizia gratis, in una riga.
Inizia gratis, senza carta. Hoody AI è integrata e funziona anche l'AI che usi già.
Funziona in ChatGPT, Claude o in qualsiasi AI che sappia recuperare una pagina. Copialo e incollalo.
- Terminal
ssh hoody.comQualsiasi computer con un client SSH, in un terminale interattivo. Non c'è nulla da installare.- docs / kit / agent
- Skill
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkIl secondo aggiunge sul disco ogni pagina della documentazione, per l'uso offline.- docs / foundation / agent-skill-bundle
- CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shIl secondo è per Linux e macOS. Senza installare:npx hoody-sdk <command>- docs / foundation / cli
- SDK
npm install hoody-sdkTypeScript. Node.js 20.19 o più 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 per browser
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>Esponewindow.HoodySDK. In produzione fissa una versione e dai alle pagine token di breve durata e con autorizzazioni limitate.- docs / getting-started / quickstart