Vai al contenuto
La tua AI@https://hoody.com Connect to Hoody

Modalità sviluppatore

Abbiamo usato parole semplici. Ecco Hoody, in concreto.

Ogni sezione mostra le chiamate esatte all'API dei Bot che ci sono dietro, con il pulsante Copia. L'elenco completo è in fondo.

Apri le chiamate

hoody / bots

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.

Come si incastraEsempio
Tu

Correggi il refuso su Mio sito e il prezzo di Negozio, poi ordina le nuove foto.

Il tuo Bot

chiefuna chat · le parti più vecchie riassunte · i tuoi limiti

Agenti

fattoCorreggi il refuso su Mio sito

ti chiedeCorreggi il prezzo di Negozio

in corsoOrdina le nuove foto

I tuoi computer
Mio sito Negozio 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/chiefchief si crea al primo uso, quindi l'elenco dei Bot non è mai vuoto.
Dove gira
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsI Bot girano su Hoody Agent (agent-1). Non sul servizio di app di chat su /api/bot/.
hoody / how it flows

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 /api/v1/agent/bots/chief/delegates?state=openOgni agente delegato è una sessione normale, che puoi leggere o collegare con le route /sessions. Quelle aperte riportano capability e current_step.
Il suo turno in diretta
GET /api/v1/agent/sessions/{session_id}/streamTesto della risposta e ragionamento mentre si scrivono, chiamate agli strumenti e fine di ogni turno. session_id arriva da GET /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.

Turno di esempio

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.

aperti 2 agenti · Mio sito, Negozio

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.

[report] L'agente di Mio sito ha finito: refuso corretto, sito aggiornato.

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.

Scrivi quando vuoiUn messaggio inviato mentre è occupato aspetta il suo turno. Invia una correzione e li legge insieme.
Lavora sui tuoi computerGli agenti girano dove si trovano il tuo codice e i tuoi file e continuano anche dopo che chiudi la scheda.
Torna a chiedereApprovi la richiesta di un agente solo con un messaggio che invii tu, mai con il report di un agente.

In concreto

Il tuo messaggio
POST /api/v1/agent/bots/chief/messagesRisponde a 202 con message_id, state e turn_id; state: queued mentre il Bot è occupato.
La sua risposta
GET /api/v1/agent/bots/chief/streamSSE: un frame state, poi un row per ogni riga di log; riprendi con Last-Event-ID.
Ferma un agente
POST /api/v1/agent/bots/chief/delegates/{sid}/stopFerma subito il lavoro di quell'agente, mai il Bot. {"close": true} chiude anche la sua sessione.
Dillo a voce
POST /api/v1/agent/bots/chief/messages/audioUna registrazione wav o mp3 è trascritta e inviata come tuo messaggio.
hoody / api

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
Il codice QR di un Bot, con il simbolo del Bot al centro, come lo disegna l'Hub: un telefono che lo scansiona apre la pagina della chat del Bot. Questo esempio apre hoody.com/bots.

1In un'app

La tua appID di esempio
Formato
URL di base<Bot URL>/v1
Modellobot:global/chief
Chiave APIla tua chiave hbk_
URL di base<Bot URL>
Modellobot:global/chief
Chiave APIla tua chiave hbk_
URL del server<Bot URL>/mcp
TrasportoHTTP, POST a ogni richiesta
Chiave APIla tua chiave hbk_

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.

2Da 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.

3Chi 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} è global o un ID esadecimale di 24 caratteri. GET /bots/{id} li elenca in urls. Bot condiviso: https://<label>.hoody.bot/v1/chat/completions con 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.
hoody / guardrails

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

non fare mai push su main, apri una PR e aspettami non toccare fatturazione, DNS o pagamenti il database di produzione è in sola lettura se un lavoro costa più di 20 $, fermati e chiedi hai dubbi? chiedimi, non tirare a indovinare

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), lenient o off. docs / api / agent / bots ↗

In concreto

Invia da ovunque
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Risponde 202; queued mentre il Bot è occupato. Aggiungi Idempotency-Key per 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 suo seq, quindi Last-Event-ID riprende in automatico.
Accessi vocali
…/bots/{id}/voice · …/bots/{id}/realtimeUna sola connessione vocale attiva per Bot alla volta; takeover=true la sostituisce. docs / api / agent / bots ↗
Altro: il log
Esempio: quattro dispositivi, un Bot, un solo 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
Ogni riga ha 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
Un nuovo modello parte con la sessione successiva del Bot: reset sposta il log nell'archivio e apre la nuova sessione. L'archivio resta leggibile finché non lo svuoti.
La memoria dei tuoi agenti
Anche gli agenti salvano e cercano una memoria propria (parola chiave, significato e link tra elementi), non legata a una sola app AI. docs / api / agent / memory ↗

In concreto

Leggi il log
GET /api/v1/agent/bots/chief/logRighe in ordine, paginate con seq.
Seguilo
GET /api/v1/agent/bots/chief/streamPrima un frame state, poi le righe; un cursore spostato nell'archivio risponde con lagged.
Dimentica
POST /api/v1/agent/bots/chief/forgetLeggilo più tardi con GET …/archive; eliminalo con POST …/purge.
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.

Un percorso di andata e ritorno da chi chiama al Bot o alla maggior parte degli altri servizi sui tuoi computer. Le chiamate entrano dall'alto e le risposte tornano dal basso. Uno script Exec si trova su entrambi i percorsi: vede ogni chiamata in ingresso e può vedere ogni risposta in uscita. Ogni hook ha un limite di tempo, 500 ms per impostazione predefinita.

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-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);
    };

    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-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 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-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 } });
    };

    Una risposta inviata dallo script non arriva mai al Bot. forward() può anche modificare metodo, percorso, header o corpo; un header impostato su null viene 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-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() 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 richiede If-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.path indica uno script nel tuo hoody-exec. Scrivilo sul tuo link exec; /bot-audit espone bot-audit.js. docs / api / exec / script-management ↗

Inizia gratis, in una riga.

Inizia gratis, senza carta. Hoody AI è integrata e funziona anche l'AI che usi già.

Senza codice
Codice
La tua AI@https://hoody.com Connect to Hoody

Funziona in ChatGPT, Claude o in qualsiasi AI che sappia recuperare una pagina. Copialo e incollalo.

La tua AI
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
Browser
https://hub.hoody.com
docs / kit / agent
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>Espone window.HoodySDK. In produzione fissa una versione e dai alle pagine token di breve durata e con autorizzazioni limitate.
docs / getting-started / quickstart

Dal 2021

Dalla privacy all'infrastruttura per agenti

hoody / kit

Cosa trovi nei tuoi computer

Ogni servizio ha il suo link. Aprilo, condividilo o passalo alla tua AI. Chiunque abbia il link può aprirlo finché non lo proteggi. I link del Kit hanno questa forma: https://{p}-{c}-<kit>-1.{node}.computers.hoody.com. {p} è il tuo progetto, {c} uno dei tuoi computer, {node} il suo server.

Computer

Bots

API