Zum Inhalt springen
Deine KI@https://hoody.com Connect to Hoody

Dev-Modus

Wir haben es schlicht gehalten. Hier ist Hoody, konkret.

Jeder Abschnitt zeigt jetzt die genauen Bot-API-Aufrufe dahinter, mit einem Kopieren-Button. Alle Aufrufe stehen am Ende.

Aufrufe öffnen

hoody / bots

Bots

Sprich mit deinen Bots.
Deine Bots steuern die Agenten.

Ein Bot ist ein dauerhafter Assistent mit einem Chat, der die ganze Unterhaltung behält. Frag ihn, was du willst: Er öffnet Agenten auf deinen Computern, verfolgt ihre Arbeit und berichtet, was sie getan haben. Gib ihm eine .hoody.bot-URL und teile sie über benannte Schlüssel mit vertrauenswürdigen Personen und KIs.

Dein erster Bot, chief, ist von Anfang an da. Hoody AI (kostenlos) ist eingebaut. Oder melde dich mit ChatGPT an. Die Helfer des Bots können Claude Pro oder Max über Claude Code nutzen, wenn du es erlaubst.

So passt es zusammenBeispiel
du

Behebe den Tippfehler auf My site und den Preis in Shop, dann sortiere die neuen Fotos.

Dein Bot

chiefein Chat · ältere Teile zusammengefasst · deine Limits

Agenten

fertigTippfehler auf My site beheben

fragt dichPreis in Shop beheben

arbeitetNeue Fotos sortieren

Deine Computer
My site Shop Photos

Jeder Agent ist eine vollständige Hoody-Agent-Sitzung auf einem deiner Computer.

Konkret

Dein erster Bot
GET /api/v1/agent/bots/chiefchief wird bei der ersten Nutzung angelegt, daher ist die Liste der Bots nie leer.
Wo er läuft
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsBots laufen auf dem Hoody Agent (agent-1), nicht im Chat-App-Dienst unter /api/bot/.
hoody / how it flows

Eine Nachricht geht bis ans Ziel. Ein Bericht kommt zurück.

du

über einen dieser Wege

BerichtFertig. Shop ist repariert.

Deine Computer

Dein Bot

nimmt deine Nachricht sofort an und meldet sich, wenn er fertig ist

Agent

seine Helfer

Agent

seine Helfer

  • My siteaktualisieren
  • Shopbeheben
  • Photossichern

BeispielAlles läuft auf deinen Computern. Dein Bot kennt jeden einzelnen.

Konkret

Seine Agenten
GET /api/v1/agent/bots/chief/delegates?state=openJeder Delegat ist eine gewöhnliche Sitzung, die über die /sessions-Routen gelesen oder angehängt wird. Offene Sitzungen tragen capability und current_step.
Sein eigener Live-Durchgang
GET /api/v1/agent/sessions/{session_id}/streamAntworttext und Gedankengang, während sie geschrieben werden, Tool-Aufrufe und das Ende jedes Durchgangs. session_id kommt von GET /bots/{id}, sobald der Bot seine erste Nachricht bekommen hat.
Mehr: einen ganzen Durchgang ansehen, Bot für Bot

Frag einmal. Er verteilt die Arbeit.

Er antwortet, öffnet Agenten für die langen Teile und meldet sich bei dir mit deren Fragen und Ergebnissen.

Beispiel-Durchgang

du, 09:12

Behebe den Tippfehler beim Preis auf My site. Und finde heraus, warum der Checkout in Shop langsam wurde.

Chief, 09:12

Bin dran. Ich öffne zwei Agenten: einen auf My site für die Korrektur, einen auf Shop, um den Checkout zu messen. Ich berichte dir danach.

geöffnet 2 Agenten · My site, Shop

Chief, 09:19

Der Agent auf My site hat den Tippfehler behoben und will das ausführen. Erlauben?

bash: ./publish.sh

du, 09:20

Ja, los.

[Bericht] Agent auf My site abgeschlossen: Tippfehler behoben, Website aktualisiert.

Chief, 09:31

Auf My site erledigt: Die Korrektur ist live. Der Checkout wartet auf eine langsame Abfrage; der Agent auf Shop hat einen Fix zum Ausprobieren bereit.

Schreib jederzeitEine Nachricht, die ankommt, während der Bot beschäftigt ist, wartet, bis sie dran ist. Schickst du eine Korrektur, liest er beide zusammen.
Arbeitet auf deinen ComputernAgenten laufen dort, wo dein Code und deine Dateien liegen, und arbeiten weiter, wenn du den Tab schließt.
Fragt bei dir nachDie Anfrage eines Agenten wird nur durch eine Nachricht von dir freigegeben, nie durch den Bericht eines Agenten.

Konkret

Deine Nachricht
POST /api/v1/agent/bots/chief/messagesAntwortet 202 mit message_id, state und turn_id; state: queued, solange der Bot beschäftigt ist.
Antwort des Bots
GET /api/v1/agent/bots/chief/streamSSE: ein state-Frame, dann pro Log-Zeile ein row; fortsetzen mit Last-Event-ID.
Einen Agenten stoppen
POST /api/v1/agent/bots/chief/delegates/{sid}/stopStoppt die Arbeit dieses Agenten sofort, nie die des Bots. {"close": true} schließt auch seine Sitzung.
Sag es laut
POST /api/v1/agent/bots/chief/messages/audioEine wav- oder mp3-Aufnahme wird transkribiert und als deine Nachricht gesendet.
hoody / api

Gib deinem Bot eine öffentliche URL. Verbinde Personen, Apps und KIs, denen du vertraust.

Eine URL, drei Zugänge: als Modell für Apps und SDKs, die eine Basis-URL annehmen (im Format von OpenAI oder Anthropic), als MCP-Server oder per einfachem HTTP aus einem Skript.

chief · Bot-URL

https://<label>.hoody.bot
QR-Code eines Bots mit dem Bot-Zeichen in der Mitte, so wie der Hub ihn zeichnet: Ein Smartphone, das ihn scannt, öffnet die Chatseite des Bots. Dieses Beispiel öffnet hoody.com/bots.

1In einer App

Deine AppBeispiel-IDs
Format
Basis-URL<Bot URL>/v1
Modellbot:global/chief
API-Schlüsseldein hbk_-Schlüssel
Basis-URL<Bot URL>
Modellbot:global/chief
API-Schlüsseldein hbk_-Schlüssel
Server-URL<Bot URL>/mcp
TransportHTTP, jede Anfrage per POST
API-Schlüsseldein hbk_-Schlüssel

Chat Completions, Responses und Modelle. Nur die letzte Nutzernachricht wird gesendet; der System-Prompt der App und ihre eigenen Einstellungen bleiben außen vor.

Messages und Modelle, auf der URL ohne /v1. Nur die letzte Nutzernachricht wird gesendet; der System-Prompt der App und ihre eigenen Einstellungen bleiben außen vor.

Dein Bot als MCP-Server: JSON-RPC-Antworten, keine Sitzung, die offen bleiben muss, und kein Event-Stream.

2Aus einem Skript

Einfaches HTTP

  • POST /bots/chief/messages

    Gib ihm eine Aufgabe aus einem Skript, einem Cronjob oder einer anderen KI.

  • GET /bots/chief/stream

    Verfolge fertige Antworten und Ereignisse der Agenten. Der Sitzungs-Stream des Bots zeigt den Antworttext, während er entsteht.

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

    Stoppe einen Agenten; der Bot arbeitet weiter.

3Wer Zugang bekommt

Gib jeder vertrauten Person und jeder App einen benannten Schlüssel. Pausiere ihn, lege ein Ablaufdatum oder eine IPv4-Beschränkung fest oder widerrufe ihn einzeln.

Alle mit einem Schlüssel teilen sich eine Unterhaltung. Gib Zugang nur an Personen und KIs weiter, denen du vertraust.

Beschränke einen Bot auf ein Realm: Seine Agenten sehen nur die Computer dieses Realms.

Konkret

Bot-Basis
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI nutzt <base>/v1, Anthropic die Basis, MCP <base>/mcp. {realm} ist global oder eine 24-stellige Hex-ID. GET /bots/{id} listet sie unter urls auf. Geteilter Bot: https://<label>.hoody.bot/v1/chat/completions mit einem Bearer-Schlüssel.
Nachricht senden
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'Höchstens 64 KiB Text; antwortet mit 202.
Einen Agenten stoppen
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}Stoppt einen untergeordneten Agenten, nie den Bot.
hoody / guardrails

Einfach in Alltagssprache. Das ist die ganze Einrichtung.

Schreib in deinen eigenen Worten, was dein Bot nie tun darf. Speichern. Fertig.

  • Keine Syntax
  • Jeder Agent bekommt sie
  • Riskante Aufgaben werden vor dem Start geprüft

chief · LeitplankenBeispiel

nie auf main pushen, einen PR öffnen und auf mich warten Abrechnung, DNS und Zahlungen nicht anfassen Prod-Datenbank ist schreibgeschützt kostet ein Job mehr als 20 $, stoppen und nachfragen unsicher? frag mich, nicht raten

Konkret

Leitplanken ersetzen
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}Ein Textfeld; der Bot erhält jede Zeile mit der Markierung [guardrails updated] vor seiner nächsten Nachricht.
Wie streng
"guardrail_check": "strict"strict (Standard), lenient oder off. docs / api / agent / bots ↗

Konkret

Von überall senden
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Antwortet mit 202; queued, solange der Bot beschäftigt ist. Füge einen Idempotency-Key hinzu, dann kannst du sicher wiederholen.
Stream fortsetzen
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events; die ID jedes Zeilen-Frames ist sein seq, deshalb setzt Last-Event-ID von selbst fort.
Sprachzugänge
…/bots/{id}/voice · …/bots/{id}/realtimeJe Bot ist nur eine aktive Sprachverbindung offen; takeover=true ersetzt sie. docs / api / agent / bots ↗
Mehr: das Log
Beispiel: vier Geräte, ein Bot, ein Log

Vier Geräte sind mit demselben Bot verbunden: ein Smartphone, ein Laptop, ein Terminal und eine KI-App. Smartphone und Laptop senden im selben Moment, um 22:31 Uhr; die Nachrichten landen als #152, dann #153, und der Bot antwortet als #154. Jedes Gerät sieht dieselbe Reihenfolge. Ältere Runden werden kurz zusammengefasst, Zeilen #1 bis #120; die neuesten Runden, #121 bis #154, bleiben wortwörtlich erhalten. Das ganze Log behält jede Zeile.

Jedes Gerät, eine Unterhaltung. Dein Smartphone, dein Laptop, dein Terminal und deine KI-Apps sind gleichzeitig mit demselben Bot verbunden, und jedes Gerät sieht dieselbe Reihenfolge. Auch Personen mit einem Schlüssel haben Zugang zu dieser Unterhaltung. Teile den Bot deshalb nur mit Personen, denen du vertraust.

Jede Nachricht bekommt die nächste Nummer. Zwei Nachrichten im selben Moment landen als #152, dann #153. Eine Nachricht, die ankommt, während der Bot beschäftigt ist, wartet auf seine nächste Runde.

Es wird nie eng. Wenn das Kontextfenster des Modells voll ist, werden ältere Runden kurz zusammengefasst, die neuesten bleiben wortwörtlich erhalten, und der Bot arbeitet weiter. Das Log behält jede Zeile; beim Vergessen wandern sie ins Archiv.

Was eine Zeile enthält
Jede Zeile hat seq, at, role (user, bot, event oder system) und text. Sie kann auch session_id enthalten. Das Log wird per seq seitenweise gelesen; der Stream sendet jede neue Zeile, sobald sie geschrieben ist.
Modell wechseln
Ein neues Modell startet mit der nächsten Sitzung des Bots: Ein Reset verschiebt das Log ins Archiv und öffnet die neue Sitzung. Das Archiv bleibt lesbar, bis du es endgültig löschst.
Gedächtnis deiner Agenten
Agenten speichern und durchsuchen auch ein eigenes Gedächtnis (nach Stichwort, Bedeutung und Verknüpfungen zwischen Einträgen), unabhängig von einer einzelnen KI-App. docs / api / agent / memory ↗

Konkret

Log lesen
GET /api/v1/agent/bots/chief/logZeilen der Reihe nach, seitenweise per seq.
Verfolgen
GET /api/v1/agent/bots/chief/streamErst ein state-Frame, dann Zeilen; ein ins Archiv verschobener Cursor antwortet mit lagged.
Vergessen
POST /api/v1/agent/bots/chief/forgetLies es später mit GET …/archive; lösche es mit POST …/purge.
Mehr: Hooks

Klink dich ein. Dein Skript sieht den Aufruf zuerst und die Antwort zuletzt.

Ein Hook leitet passende HTTP-Aufrufe an den Bot oder an die meisten anderen Dienste auf deinen Computern zuerst durch eines deiner Exec-Skripte. WebSocket-Upgrades auf einem passenden Pfad werden abgelehnt, halte Pfade wie die Sprachzugänge des Bots daher aus dem Muster heraus. Auf dem Weg hinein kann es sie beobachten, prüfen, ändern, beantworten oder blockieren. Auf dem Weg hinaus kann es die Antwort lesen und ändern, bevor der Aufrufer sie bekommt. Nichts zu patchen.

Ein Kreislauf vom Aufrufer zum Bot oder zu den meisten anderen Diensten auf deinen Computern. Aufrufe laufen oben hinein, Antworten kommen unten zurück. Ein Exec-Skript sitzt über beiden Wegen, sieht also jeden Aufruf auf dem Weg hinein und kann jede Antwort auf dem Weg hinaus sehen. Jeder Hook hat ein Zeitlimit, standardmäßig 500 ms.

ReinAuf dem Weg hinein

  • BeobachtenHalte im Log fest, wer was aufgerufen hat, und gib es weiter.Skript anzeigenSkript ausblenden

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

    Das Skript sieht die echte Client-IP. Wird es ohne Hook aufgerufen, ist metadata.hook leer, und es antwortet mit 404. forward() gibt den Aufruf unverändert an den Bot weiter.

  • PrüfenLass nur angemeldete Personen durch. Ein Ratenlimit gehört an dieselbe Stelle.Skript anzeigenSkript ausblenden

    Regel: 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 prüft einen Hoody-Login-Claim, der mit ED25519 signiert ist; das vollständige Skript steht in der Dokumentation. Wer keinen hat, bekommt eine 401-Antwort und erreicht den Bot nie. Diese Regel würde auch die WebSocket-Sprachpfade ablehnen; grenze sie enger ein, damit diese Pfade nicht betroffen sind.

  • ÄndernSchreibe Methode, Pfad, Header oder Body um, bevor der Aufruf ankommt.
  • BlockierenWeise Uploads ab, die einen Virenscan nicht bestehen, und Aufrufe über deinem Limit.
  • AntwortenAntworte selbst, etwa mit „Gleich wieder da“, und der Bot sieht den Aufruf nie.Skript anzeigenSkript ausblenden

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

    Eine Antwort des Skripts erreicht den Bot nie. forward() kann auch Methode, Pfad, Header oder Body ändern; ein Header, der auf null gesetzt wird, wird entfernt.

RausAuf dem Weg hinaus

  • Antwort lesenSieh Status, Header und Body, bevor die aufrufende Stelle sie erhält.
  • UmschreibenGib die Antwort unverändert weiter oder sende deine eigene.Skript anzeigenSkript ausblenden

    Regel: 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() holt die Antwort des Bots, ohne sie zu senden, damit das Skript sie zuerst liest; pipeResponse() sendet sie weiter. Eine gestreamte Antwort endet beim Zeitlimit des Hooks, höchstens bei 30.000 ms.

  • Header bereinigenEntferne private Header aus Antworten, füge eine CSP hinzu.

Jeder Hook hat ein Zeitlimit, standardmäßig 500 ms. Schlägt das Skript fehl oder überschreitet es das Zeitlimit, endet der Aufruf dort. docs / proxy / hooks ↗

Konkret

Hook hinzufügen
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}Der Server vergibt die ID des Hooks. Regeln laufen der Reihe nach, der erste Treffer gewinnt.
Version lesen
GET /api/v1/computers/{id}/proxy/hooks/agentJede Änderung an Hooks braucht If-Match: file:v<N> mit der aktuellen Version.
Das Skript
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}Der Skript-Body zeigt hier nur die Form: Setze deinen Audit-Code an die Stelle von { … }. script.path benennt ein Skript in deinem eigenen hoody-exec. Schreibe es über deinen Exec-Link; /bot-audit liefert bot-audit.js aus. docs / api / exec / script-management ↗

Kostenlos starten, in einer Zeile.

Im Free-Tarif startest du ohne Zahlungskarte: Hoody AI ist integriert, und die KI, die du schon nutzt, funktioniert ebenfalls.

Ohne Code
Code
Deine KI@https://hoody.com Connect to Hoody

Funktioniert in ChatGPT, Claude und jeder KI, die eine Seite abrufen kann. Kopiere es und füge es ein.

Deine KI
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
Browser
https://hub.hoody.com
docs / kit / agent
Terminal
ssh hoody.comJedes Gerät mit einem SSH-Client, in einem interaktiven Terminal. Nichts zu installieren.
docs / kit / agent
Skill
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkDer zweite legt jede Seite der Dokumentation auf dem Datenträger ab, zur Offline-Nutzung.
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shDer zweite ist für Linux und macOS. Ohne Installation: npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript. Node.js 20.19 oder neuer, Bun, Deno.
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
Browser-SDK
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>Stellt window.HoodySDK bereit. Lege für die Produktion eine Version fest und gib Seiten kurzlebige Token mit begrenzten Berechtigungen.
docs / getting-started / quickstart

Seit 2021

Von Privatsphäre zu Infrastruktur für Agenten

hoody / kit

Was deine Computer mitbringen

Jeder Dienst hat seinen eigenen Link. Öffne ihn, teile ihn oder gib ihn deiner KI. Wer den Link kennt, kann ihn öffnen, bis du ihn sperrst. Kit-Links haben die Form https://{p}-{c}-<kit>-1.{node}.computers.hoody.com: {p} ist dein Projekt, {c} einer deiner Computer, {node} sein Server.

Computer

Bots

API