Langsung ke konten
AI Anda@https://hoody.com Connect to Hoody

Mode developer

Tetap sederhana. Inilah Hoody secara konkret.

Setiap bagian kini menampilkan panggilan API Bot yang tepat di baliknya, lengkap dengan tombol Salin. Daftar lengkap panggilan ada di bagian akhir.

Buka panggilan API

hoody / bots

Bots

Bicara dengan Bots Anda.
Bots yang menjalankan agen.

Bot adalah asisten yang terus berjalan, dengan satu chat yang menyimpan seluruh percakapan. Minta apa saja: ia membuka agen di komputer Anda, memantau pekerjaannya, lalu melaporkan apa yang sudah dikerjakan. Beri ia URL .hoody.bot, lalu bagikan ke orang tepercaya dan AI yang memakai kunci bernama.

Bot pertama Anda, chief, sudah ada sejak awal. Hoody AI (gratis) sudah tersedia. Atau masuk dengan ChatGPT. Agen pembantu Bot dapat memakai Claude Pro atau Max lewat Claude Code jika Anda mengizinkan.

SusunanContoh
Anda

Perbaiki typo di Situs saya dan harga di Toko, lalu rapikan foto baru.

Bot Anda

chiefsatu chat · bagian lama diringkas · batas Anda

Agen

selesaiPerbaiki typo di Situs saya

butuh jawabanPerbaiki harga di Toko

bekerjaRapikan foto baru

Komputer Anda
Situs saya Toko Foto

Setiap agen adalah sesi Hoody Agent lengkap di salah satu komputer Anda.

Secara konkret

Bot pertama Anda
GET /api/v1/agent/bots/chiefchief dibuat saat pertama dipakai, jadi daftar Bot tidak pernah kosong.
Tempat Bot berjalan
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsBot berjalan di Hoody Agent (agent-1), bukan layanan aplikasi chat di /api/bot/.
hoody / how it flows

Satu pesan sampai tuntas. Laporan kembali ke Anda.

Anda

lewat salah satu ini

LaporanSelesai. Toko sudah diperbaiki.

Komputer Anda

Bot Anda

menerima pesan Anda langsung, melapor saat selesai

Agent

agen bantu

Agent

agen bantu

  • Situs sayaperbarui
  • Tokoperbaiki
  • Fotobackup

ContohSemuanya berjalan di komputer Anda. Bot Anda mengenal tiap komputer.

Secara konkret

Agen Bot
GET /api/v1/agent/bots/chief/delegates?state=openSetiap agen bantu adalah sesi biasa, yang dibaca atau disambungkan lewat rute /sessions. Sesi yang terbuka memuat capability dan current_step.
Giliran live tersendiri
GET /api/v1/agent/sessions/{session_id}/streamTeks balasan dan proses berpikir saat ditulis, panggilan tool, dan akhir setiap giliran. session_id berasal dari GET /bots/{id} setelah Bot menerima pesan pertama.
Selengkapnya: tonton satu giliran penuh, satu Bot demi satu

Anda minta sekali. Ia membagi pekerjaan.

Ia membalas, membuka agen untuk bagian yang memakan waktu, lalu kembali kepada Anda dengan pertanyaan dan hasil dari agen.

Giliran contoh

Anda, 09:12

Perbaiki typo harga di Situs saya. Lalu cari tahu mengapa checkout di Toko melambat.

Chief, 09:12

Saya kerjakan. Membuka dua agen: satu di Situs saya untuk perbaikan, satu di Toko untuk mengukur waktu checkout. Nanti saya lapor.

dibuka 2 agen · Situs saya, Toko

Chief, 09:19

Agen Situs saya memperbaiki typo dan ingin menjalankan ini. Izinkan?

bash: ./publish.sh

Anda, 09:20

Ya, lanjut.

[laporan] Agen Situs saya selesai: typo diperbaiki, situs diperbarui.

Chief, 09:31

Selesai di Situs saya: perbaikan sudah live. Checkout menunggu satu pencarian yang lambat; agen Toko sudah menyiapkan perbaikan untuk dicoba.

Tulis kapan sajaPesan yang dikirim saat Bot sibuk menunggu gilirannya. Kirim koreksi, dan ia membaca keduanya sekaligus.
Bekerja di komputer AndaAgen berjalan di tempat kode dan file Anda berada, dan terus bekerja setelah Anda menutup tab.
Kembali untuk bertanyaPermintaan agen hanya disetujui lewat pesan yang Anda kirim, tidak pernah lewat laporan agen.

Secara konkret

Pesan Anda
POST /api/v1/agent/bots/chief/messagesMenjawab 202 dengan message_id, state, dan turn_id; state: queued saat Bot sibuk.
Balasan Bot
GET /api/v1/agent/bots/chief/streamSSE: satu frame state, lalu satu row per baris log; lanjutkan dengan Last-Event-ID.
Hentikan satu agen
POST /api/v1/agent/bots/chief/delegates/{sid}/stopLangsung menghentikan pekerjaan agen itu, bukan Bot. {"close": true} juga menutup sesi agen.
Ucapkan
POST /api/v1/agent/bots/chief/messages/audioRekaman wav atau mp3 diubah menjadi teks, lalu dikirim sebagai pesan Anda.
hoody / api

Beri Bot Anda URL publik. Hubungkan orang, aplikasi, dan AI yang tepercaya.

Satu URL, tiga jalur masuk: sebagai model untuk aplikasi dan SDK yang menerima URL dasar (format OpenAI atau Anthropic), sebagai server MCP, atau lewat HTTP biasa dari skrip.

chief · Bot URL

https://<label>.hoody.bot
Kode QR Bot, dengan logo Bot di tengah, seperti yang digambar Hub: ponsel yang memindai kode ini membuka halaman chat Bot. Contoh ini membuka hoody.com/bots.

1Di aplikasi

Aplikasi AndaID contoh
Format
URL dasar<Bot URL>/v1
Modelbot:global/chief
API keykey hbk_ Anda
URL dasar<Bot URL>
Modelbot:global/chief
API keykey hbk_ Anda
URL server<Bot URL>/mcp
TransportHTTP, POST setiap request
API keykey hbk_ Anda

Chat completions, responses, dan models. Hanya pesan pengguna terakhir yang dikirim; system prompt dan pengaturan milik aplikasi tidak ikut dikirim.

Messages dan models, di URL tanpa /v1. Hanya pesan pengguna terakhir yang dikirim; system prompt dan pengaturan milik aplikasi tidak ikut dikirim.

Bot Anda sebagai server MCP: balasan JSON-RPC, tanpa sesi yang harus dipertahankan dan tanpa event stream.

2Dari skrip

HTTP biasa

  • POST /bots/chief/messages

    Beri tugas ke Bot dari skrip, cron job, atau AI lain.

  • GET /bots/chief/stream

    Pantau balasan yang sudah selesai dan event agen. Stream sesi Bot menampilkan teks balasan saat ditulis.

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

    Hentikan satu agen; Bot tetap berjalan.

3Siapa yang masuk

Beri setiap orang atau aplikasi tepercaya satu key bernama. Setiap key dapat dijeda, diberi masa berlaku atau batasan IPv4, atau dicabut tersendiri.

Semua pemegang key berbagi satu percakapan. Bagikan hanya ke orang dan AI yang Anda percaya.

Batasi Bot ke satu ranah: agen Bot hanya melihat komputer di ranah itu.

Secara konkret

URL dasar Bot
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI memakai <base>/v1, Anthropic memakai URL dasar, MCP memakai <base>/mcp. {realm} berupa global atau id 24 hex. GET /bots/{id} menampilkannya di urls. Bot yang dibagikan: https://<label>.hoody.bot/v1/chat/completions dengan key Bearer.
Kirim pesan
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'Maksimal 64 KiB teks; menjawab 202.
Hentikan satu agen
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}Menghentikan satu agen, bukan Bot.
hoody / guardrails

Cukup bahasa biasa. Hanya itu pengaturannya.

Tulis hal yang tidak boleh dilakukan Bot, dengan bahasa Anda sendiri. Simpan. Selesai.

  • Tanpa sintaks
  • Semua agen menerimanya
  • Pekerjaan berisiko diperiksa dulu sebelum dimulai

chief · batasanContoh

jangan pernah push ke main, buka PR dan tunggu saya jangan sentuh penagihan, DNS, atau pembayaran database prod hanya dapat dibaca jika satu pekerjaan berbiaya lebih dari US$20, berhenti dan tanya ragu? tanya saya, jangan menebak

Secara konkret

Ganti aturan
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}Satu kolom teks; Bot menerima setiap baris dengan tanda [guardrails updated] sebelum pesan berikutnya.
Seberapa ketat
"guardrail_check": "strict"strict (default), lenient, atau off. docs / api / agent / bots ↗

Secara konkret

Kirim dari mana saja
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Membalas 202; queued saat Bot sedang sibuk. Tambahkan Idempotency-Key agar dapat mencoba ulang dengan aman.
Lanjutkan stream
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events; id setiap frame baris adalah seq, jadi Last-Event-ID melanjutkan sendiri.
Pintu suara
…/bots/{id}/voice · …/bots/{id}/realtimeSatu koneksi suara aktif per Bot dalam satu waktu; takeover=true menggantikannya. docs / api / agent / bots ↗
Selengkapnya: log
Contoh: empat perangkat, satu Bot, satu rekaman

Empat perangkat, yaitu ponsel, laptop, terminal, dan aplikasi AI, terbuka di Bot yang sama. Ponsel dan laptop mengirim pada saat yang sama, pukul 22.31; pesan masuk sebagai #152, lalu #153, dan Bot membalas sebagai #154. Setiap perangkat melihat urutan yang sama. Giliran lama dirangkum menjadi ringkasan singkat, baris #1 sampai #120; giliran terbaru, #121 sampai #154, tetap kata demi kata. Log lengkap menyimpan setiap baris.

Semua perangkat, satu percakapan. Ponsel, laptop, terminal, dan aplikasi AI Anda terbuka di Bot yang sama sekaligus, dan setiap perangkat melihat urutan yang sama. Pemegang kunci juga ikut berbagi, jadi bagikan hanya dengan orang yang Anda percaya.

Setiap pesan mendapat nomor berikutnya. Dua pesan yang dikirim bersamaan masuk sebagai #152, lalu #153. Pesan yang dikirim saat Bot sibuk menunggu giliran berikutnya.

Ruangnya tidak pernah habis. Saat jendela model penuh, giliran lama dirangkum menjadi ringkasan singkat, giliran terbaru tetap kata demi kata, dan Bot terus berjalan. Log menyimpan setiap baris; forget memindahkannya ke arsip.

Isi satu baris
Setiap baris memiliki seq, at, role (user, bot, event, atau system), dan text. Baris juga dapat memiliki session_id. Log dibagi per halaman menurut seq; stream mengirim setiap baris baru saat ditulis.
Mengganti model
Model baru berlaku mulai sesi Bot berikutnya: reset memindahkan log ke arsip dan membuka sesi baru. Arsip tetap dapat dibaca sampai Anda menghapusnya permanen.
Memori yang disimpan agen Anda
Agen juga menyimpan dan mencari memori sendiri (kata kunci, makna, dan hubungan antaritem), tidak terkunci di satu aplikasi AI. docs / api / agent / memory ↗

Secara konkret

Baca log
GET /api/v1/agent/bots/chief/logBaris berurutan, dibagi per halaman oleh seq.
Ikuti
GET /api/v1/agent/bots/chief/streamFrame state, lalu baris; cursor yang sudah pindah ke arsip dijawab lagged.
Forget
POST /api/v1/agent/bots/chief/forgetBaca nanti dengan GET …/archive; hapus dengan POST …/purge.
Selengkapnya: hook

Pasang hook. Script Anda melihat panggilan lebih dulu dan jawaban paling akhir.

Hook mengirim panggilan HTTP yang cocok ke Bot, atau ke sebagian besar layanan lain di komputer Anda, lewat salah satu script Exec Anda lebih dulu. Upgrade WebSocket pada path yang cocok ditolak, jadi letakkan path seperti pintu suara Bot di luar pola yang cocok. Saat masuk, script dapat memantau, memeriksa, mengubah, menjawab, atau memblokir panggilan. Saat keluar, script dapat membaca jawaban dan mengubahnya sebelum sampai ke pemanggil. Tidak perlu patch apa pun.

Satu putaran dari pemanggil ke Bot atau sebagian besar layanan lain di komputer Anda. Panggilan masuk lewat jalur atas dan jawaban kembali lewat jalur bawah. Satu script Exec berada di kedua jalur, sehingga melihat setiap panggilan saat masuk dan dapat melihat setiap jawaban saat keluar. Setiap hook punya batas waktu, 500 ms secara default.

MasukSaat masuk

  • PantauCatat siapa memanggil apa, lalu teruskan.Lihat scriptSembunyikan script

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

    Script melihat alamat IP klien yang sebenarnya. Jika dipanggil tanpa hook, metadata.hook kosong, sehingga ia menjawab 404. forward() meneruskan panggilan ke Bot apa adanya.

  • PeriksaLoloskan hanya orang yang sudah masuk. Rate limit dapat dipasang di titik yang sama.Lihat scriptSembunyikan script

    Aturan: 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 memeriksa klaim login Hoody yang ditandatangani dengan ED25519; dokumentasi memuat script lengkapnya. Siapa pun tanpa klaim itu mendapat 401 dan tidak pernah sampai ke Bot. Aturan ini juga akan menolak path suara WebSocket; persempit cakupannya agar path itu tidak ikut.

  • UbahTulis ulang method, path, header, atau body sebelum panggilan tiba.
  • BlokirTolak unggahan yang gagal pindai virus, atau panggilan yang melewati batas Anda.
  • JawabBalas sendiri, misalnya “Segera kembali”, dan Bot tidak pernah melihat panggilan itu.Lihat scriptSembunyikan script

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

    Balasan dari script tidak pernah sampai ke Bot. forward() juga dapat mengubah method, path, header, atau body; header yang diatur ke null dihapus.

KeluarSaat keluar

  • Baca jawabanLihat status, header, dan body jawaban sebelum pemanggil melihatnya.
  • Tulis ulangTeruskan jawaban apa adanya, atau kirim jawaban Anda sendiri.Lihat scriptSembunyikan script

    Aturan: 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() mengambil jawaban Bot tanpa mengirimkannya, sehingga script membacanya lebih dulu; pipeResponse() meneruskannya. Jawaban stream berakhir pada batas waktu hook, paling lama 30.000 ms.

  • Bersihkan headerHapus header privat dari jawaban, tambahkan CSP.

Setiap hook punya batas waktu, 500 ms secara default. Jika script gagal atau kehabisan waktu, panggilan berhenti di situ. docs / proxy / hooks ↗

Secara konkret

Tambah 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}Server memberi id pada hook. Aturan dijalankan berurutan, dan yang dipakai adalah aturan pertama yang cocok.
Baca versi
GET /api/v1/computers/{id}/proxy/hooks/agentSetiap perubahan hook memerlukan If-Match: file:v<N> dengan versi saat ini.
Script
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}Isi script di sini hanya contoh bentuknya: ganti { … } dengan kode audit Anda. script.path menamai script di hoody-exec Anda sendiri. Tulis di link exec Anda; /bot-audit menyajikan bot-audit.js. docs / api / exec / script-management ↗

Mulai gratis, dalam satu baris.

Gratis untuk dimulai, tanpa kartu: Hoody AI sudah tersedia di dalamnya, dan AI yang sudah Anda pakai juga berfungsi.

Tanpa kode
Kode
AI Anda@https://hoody.com Connect to Hoody

Berfungsi di ChatGPT, Claude, atau AI apa pun yang dapat mengambil halaman. Salin lalu tempelkan.

AI Anda
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
Browser
https://hub.hoody.com
docs / kit / agent
Terminal
ssh hoody.comKomputer apa pun dengan klien SSH, di terminal interaktif. Tidak perlu instal apa pun.
docs / kit / agent
Skill
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkYang kedua menambahkan setiap halaman dokumentasi ke disk, untuk dipakai offline.
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shYang kedua untuk Linux dan macOS. Tanpa instal: npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript. Node.js 20.19 atau lebih baru, 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>Menyediakan window.HoodySDK. Tetapkan versi tertentu untuk produksi, dan beri halaman token berumur pendek dengan cakupan terbatas.
docs / getting-started / quickstart

Sejak 2021

Dari privasi ke infrastruktur agentik

hoody / kit

Bawaan komputer Anda

Setiap layanan punya link sendiri. Buka, bagikan, atau serahkan ke AI Anda. Siapa pun yang punya link dapat membukanya sampai Anda menguncinya. Link Kit berbentuk https://{p}-{c}-<kit>-1.{node}.computers.hoody.com: {p} adalah proyek Anda, {c} salah satu komputer Anda, {node} server komputer itu.

Komputer

Bots

API