本文へスキップ
AI@https://hoody.com Connect to Hoody

開発者モード

飾らずに書きました。Hoodyの中身を具体的に示します。

各セクションに、裏で使うBot APIの呼び出しをそのまま表示します。コピーもできます。呼び出しの全一覧は最後にあります。

呼び出しを開く

hoody / bots

Bots

Botに話しかける。
エージェントはBotが動かす。

Botは、1つのチャットで会話全体を保持しながら使い続けられるアシスタントです。何でも頼めます。コンピューターでエージェントを立ち上げ、作業を見守り、何をしたかを報告します。Botに.hoody.botのURLを付けると、名前付きのキーで、信頼できる人やAIと共有できます。

最初のBotのchiefは、最初から使えます。Hoody AI(無料)が組み込まれています。ChatGPTでログインすることもできます。Botのサブエージェントは、許可した場合に、Claude Codeを通してClaude ProやMaxを使えます。

構成例
自分

マイサイトの誤字とショップの価格を直してください。そのあと、新しい写真を整理してください。

Bot

chiefチャットは1つ · 古い部分は要約 · 設定した制限

エージェント

完了マイサイトの誤字を直す

確認待ちショップの価格を直す

作業中新しい写真を整理

コンピューター
マイサイト ショップ 写真

各エージェントは、コンピューター1台で動く、Hoody Agentの完全なセッションです。

具体的に

最初のBot
GET /api/v1/agent/bots/chiefchiefは初回の利用時に作成されるので、Botの一覧が空になることはありません。
動作する場所
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsBotはHoody Agent(agent-1)で動きます。/api/bot/にあるチャットアプリのサービスではありません。
hoody / how it flows

1通のメッセージで最後まで進む。報告が返ってくる。

自分

次のどれからでも

レポート完了しました。ショップを直しました。

コンピューター

Bot

メッセージをすぐ受け取り、完了したら報告する

エージェント

サブエージェント

エージェント

サブエージェント

  • マイサイト更新
  • ショップ修正
  • 写真バックアップ

例すべてコンピューターで動きます。Botは1台ずつ把握しています。

具体的に

Botのエージェント
GET /api/v1/agent/bots/chief/delegates?state=open委任先はどれも通常のセッションです。/sessionsルートで読み取りや接続ができます。開いているものにはcapabilityとcurrent_stepが付きます。
進行中のターン
GET /api/v1/agent/sessions/{session_id}/stream返信の文章と思考は、書かれるそばから表示されます。ツール呼び出しと、各ターンの終了も確認できます。session_idは、Botに最初のメッセージが届いたあと、GET /bots/{id}から得られます。
さらに:Botごとに、1回のやり取りを最後まで見る

頼むのは1回だけ。仕事はBotが割り振る。

Botは返信し、時間のかかる部分ではエージェントを立ち上げます。エージェントからの質問と結果は、Botが報告します。

ターンの例

自分、09:12

マイサイトの価格の誤字を直してください。それと、ショップのチェックアウトが遅くなった原因を調べてください。

Chief、09:12

取りかかります。エージェントを2つ立ち上げます。マイサイトで修正する1つと、ショップでチェックアウトの所要時間を測る1つです。結果は報告します。

立ち上げエージェント2つ · マイサイト、ショップ

Chief、09:19

マイサイトのエージェントが誤字を直し、これを実行しようとしています。許可しますか?

bash: ./publish.sh

自分、09:20

はい、進めてください。

[レポート]マイサイトのエージェントが完了しました。誤字を修正し、サイトを更新しました。

Chief、09:31

マイサイトは完了です。修正は公開されています。チェックアウトは、遅い検索1件を待っています。ショップのエージェントが、試せる修正を用意しています。

いつでも書ける作業中に送ったメッセージは、順番を待ちます。訂正を送ると、両方をまとめて読みます。
コンピューターで動くエージェントは、コードとファイルのある場所で動きます。タブを閉じても動き続けます。
確認のために戻るエージェントからの依頼は、送信したメッセージでのみ承認されます。エージェントのレポートでは承認されません。

具体的に

メッセージ
POST /api/v1/agent/bots/chief/messages202にはmessage_id、state、turn_idを返します。Botが作業中はstate: queuedを返します。
Botの返信
GET /api/v1/agent/bots/chief/streamSSE:stateフレームに続き、ログ1行につきrowを1つ送ります。再開はLast-Event-IDで行います。
エージェントを1つ停止
POST /api/v1/agent/bots/chief/delegates/{sid}/stopそのエージェントの作業をすぐに停止します。Botは停止しません。{"close": true}はセッションも閉じます。
音声で話しかける
POST /api/v1/agent/bots/chief/messages/audiowavまたはmp3の録音を文字に起こし、メッセージとして投稿します。
hoody / api

Botに公開URLを付けます。信頼できる人、アプリ、AIを接続できます。

URLは1つで、入り口は3つです。ベースURLを受け取るアプリやSDKでは、OpenAI形式またはAnthropic形式のモデルとして使えます。MCPサーバーとして使うことも、スクリプトから通常のHTTPで呼ぶこともできます。

chief · Bot URL

https://<label>.hoody.bot
BotのQRコード。中央にBotのマークがあり、Hubが描画したものです。スマートフォンで読み取ると、Botのチャットページが開きます。このサンプルはhoody.com/botsを開きます。

1アプリで使う

アプリIDの例
形式
ベースURL<Bot URL>/v1
モデルbot:global/chief
APIキーhbk_キー
ベースURL<Bot URL>
モデルbot:global/chief
APIキーhbk_キー
サーバーURL<Bot URL>/mcp
トランスポートHTTP、リクエストごとにPOST
APIキーhbk_キー

チャット補完、レスポンス、モデル。最後のユーザーメッセージだけが投稿され、アプリ側のシステムプロンプトと設定は含まれません。

メッセージとモデル。/v1を付けないURLで使います。最後のユーザーメッセージだけが投稿され、アプリ側のシステムプロンプトと設定は含まれません。

BotをMCPサーバーとして使います。応答はJSON-RPCで、維持するセッションもイベントストリームもありません。

2スクリプトから

通常のHTTP

  • POST /bots/chief/messages

    スクリプト、cronジョブ、ほかのAIから、タスクを渡せます。

  • GET /bots/chief/stream

    完成した返信とエージェントのイベントを追えます。Botのセッションストリームには、返信の文章が書き込まれるたびに表示されます。

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

    エージェントを1つ停止しても、Botは動き続けます。

3アクセスできる人

信頼できる人やアプリごとに、名前付きのキーを発行します。一時停止、有効期限やIPv4制限の設定、無効化は、キーごとに個別に行えます。

キーを持つ全員が、1つの会話を共有します。信頼できる人とAIにだけ共有してください。

Botを1つのレルム(コンピューターのグループ)に限定できます。そのBotのエージェントには、そのレルムのコンピューターだけが見えます。

具体的に

Botのベース
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAIは<base>/v1、AnthropicはベースURL、MCPは<base>/mcpを使います。{realm}はglobalまたは24桁の16進IDです。GET /bots/{id}はurlsの下にそれらを一覧で返します。共有Bot:https://<label>.hoody.bot/v1/chat/completionsにBearerキーを付けます。
メッセージを投稿
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'テキストは最大64KiBまでです。応答コードは202です。
エージェントを1つ停止
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}停止するのは委任先で、Botは止まりません。
hoody / guardrails

ふだんの言葉で書きます。設定はそれだけです。

Botにさせたくないことを、自分の言葉で入力します。保存すれば完了です。

  • 構文は不要
  • すべてのエージェントに届く
  • 危険な作業は、開始前に確認が入る

chief · ガードレール例

mainにはpushせず、PRを作成して確認を待つ 請求、DNS、支払いには触れない 本番データベースは読み取り専用 ジョブの費用が20ドルを超える場合は、停止して確認する 迷ったら推測せず、確認する

具体的に

ガードレールを置き換える
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}テキストフィールドは1つです。Botは次のメッセージの前に、各行に[guardrails updated]の印を付けた形で受け取ります。
厳しさ
"guardrail_check": "strict"strict(デフォルト)、lenient、またはoff。docs / api / agent / bots ↗

具体的に

どこからでも投稿
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}202を返します。Botが処理中の間はqueuedです。安全に再試行するには、Idempotency-Keyを付けます。
ストリームを再開
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Eventsです。各行フレームのidがseqなので、Last-Event-IDだけで自動的に再開できます。
音声の入り口
…/bots/{id}/voice · …/bots/{id}/realtimeBotごとに、同時に使える音声接続は1つです。takeover=trueで置き換えます。docs / api / agent / bots ↗
詳細:ログ
例:4台の端末、1つのBot、1本のログ

4台の端末(スマートフォン、ノートパソコン、ターミナル、AIアプリ)が、同じBotを開いています。スマートフォンとノートパソコンが22:31に同時に送信し、メッセージは#152、#153の順に入り、Botは#154で返信します。どの端末にも同じ順序で表示されます。古いターンは、#1〜#120の行が短い要約にまとめられます。新しい#121〜#154のターンは、原文のまま残ります。ログにはすべての行が残ります。

すべての端末で、1つの会話。スマートフォン、ノートパソコン、ターミナル、AIアプリを同じBotで同時に開けます。どの端末にも同じ順序で表示されます。キーを持つ人も同じ会話を共有するため、共有は信頼できる人だけにしてください。

メッセージには順に番号が付きます。同時に送った2件は、#152、#153の順に入ります。Botの処理中に送ったメッセージは、次のターンまで待ちます。

長い会話は要約して続けます。モデルのウィンドウがいっぱいになると、古いターンは短い要約にまとめられ、新しいターンは原文のまま残り、Botは作業を続けます。ログはすべての行を保持します。forgetを使うと、行はアーカイブに移ります。

行の内容
各行には、seq、at、role(user、bot、event、systemのいずれか)、textがあります。session_idが付く行もあります。ログはseqでページ分けされます。ストリームは、新しい行を書き込むと同時に送ります。
モデルの切り替え
新しいモデルは、Botの次のセッションから使われます。resetを実行すると、ログはアーカイブに移り、新しいセッションが始まります。アーカイブは、purgeで削除するまで読めます。
エージェントが保持するメモリ
エージェントは、独自のメモリも保存して検索できます(キーワード、意味、項目間のリンク)。特定のAIアプリに縛られません。docs / api / agent / memory ↗

具体的に

ログを読む
GET /api/v1/agent/bots/chief/log行を順に返し、seqでページ分けします。
追う
GET /api/v1/agent/bots/chief/stream最初にstateフレーム、続いて行を返します。アーカイブに移ったカーソルにはlaggedで応答します。
忘れる
POST /api/v1/agent/bots/chief/forget後からGET …/archiveで読み、POST …/purgeで削除します。
詳細:フック

フックを組み込む。スクリプトは呼び出しを最初に、応答を最後に確認する。

フックは、条件に合うHTTP呼び出しをまずExecスクリプトに通してから、Bot、またはコンピューター上のほかのほとんどのサービスに届けます。条件に合うパスでは、WebSocketのアップグレードが拒否されます。Botの音声の入口のようなパスは、条件の対象外にしてください。入るときは、呼び出しの監視、確認、変更、応答、ブロックができます。出るときは、応答を読み、呼び出し元に届く前に変更できます。パッチを当てる必要はありません。

呼び出し元から、Bot、またはコンピューター上のほかのほとんどのサービスまでを結ぶ往復の経路です。呼び出しは上の線を通って入り、応答は下の線を通って戻ります。Execスクリプト1つが両方にまたがるため、入るときは各呼び出しを見られ、出るときは各応答を見られます。フックごとに制限時間があり、既定は500msです。

行き呼び出しが入るとき

  • 監視誰が何を呼び出したかを記録し、そのまま通します。スクリプトを見るスクリプトを隠す

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

    スクリプトには、実際のクライアントIPが見えます。フックなしで呼ばれた場合、metadata.hookは空なので404を返します。forward()は、呼び出しをそのままBotに渡します。

  • 確認ログイン済みの人だけを通します。レート制限も同じ位置に置けます。スクリプトを見るスクリプトを隠す

    ルール: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は、ED25519で署名されたHoodyのログインクレームを確認します。スクリプトの全文はドキュメントにあります。クレームがない場合は401を返し、Botには届きません。このルールはWebSocketの音声パスも拒否するため、対象から外れるように絞り込んでください。

  • 変更届く前に、メソッド、パス、ヘッダー、ボディを書き換えます。
  • ブロックウイルススキャンに通らないアップロードや、制限を超えた呼び出しを断ります。
  • 応答「すぐ戻ります」のように自分で返信すると、Botには呼び出しが届きません。スクリプトを見るスクリプトを隠す

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

    スクリプトが返した応答は、Botには届きません。forward()では、メソッド、パス、ヘッダー、ボディの変更もできます。nullに設定したヘッダーは削除されます。

帰り応答が出るとき

  • 応答を読む呼び出し元より先に、ステータス、ヘッダー、ボディを確認します。
  • 書き換え応答をそのまま通すことも、自分の応答を返すこともできます。スクリプトを見るスクリプトを隠す

    ルール: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()はBotの応答を送らずに受け取るため、スクリプトが先に読めます。pipeResponse()で送り出します。ストリーム応答は、フックの制限時間で終了し、最大30,000msです。

  • ヘッダーの整理応答から非公開ヘッダーを取り除き、CSPを追加します。

フックごとに制限時間があり、既定は500msです。スクリプトが失敗するか時間切れになると、呼び出しはそこで止まります。docs / proxy / hooks ↗

具体的に

フックを追加
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}フックのidはサーバーが付けます。ルールは順に評価され、最初に一致したものが使われます。
バージョンを読む
GET /api/v1/computers/{id}/proxy/hooks/agentフックを変更するたびに、現在のバージョンを指定したIf-Match: file:v<N>が必要です。
スクリプト
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}ここのスクリプト本体は形だけです。{ … }の部分に、監査用のコードを入れてください。script.pathは、使っているhoody-execにあるスクリプトの名前です。execリンクに書き込みます。/bot-auditがbot-audit.jsを提供します。docs / api / exec / script-management ↗

無料で始める、1行で。

カード不要で、無料で始められます。Hoody AIは組み込み済みで、すでに使っているAIも使えます。

コード不要
コード
AI@https://hoody.com Connect to Hoody

ChatGPT、Claude、ページを取得できるAIで使えます。コピーして貼り付けます。

AI
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
ブラウザー
https://hub.hoody.com
docs / kit / agent
ターミナル
ssh hoody.comSSHクライアントがあるマシンなら、対話型のターミナルで使えます。インストールは不要です。
docs / kit / agent
スキル
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdk2つ目は、すべてのドキュメントページをディスクに追加し、オフラインで使えるようにします。
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | sh2つ目はLinuxとmacOS用です。インストールせずに使う場合:npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript用で、Node.js 20.19以降、Bun、Denoで使えます。
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
ブラウザーSDK
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>window.HoodySDKを使えるようにします。本番ではバージョンを固定し、ページには有効期間の短い、範囲を限定したトークンを渡してください。
docs / getting-started / quickstart

2021年から

プライバシーからエージェント向けインフラへ

hoody / kit

コンピューターに付属するもの

サービスにはそれぞれ専用のリンクがあります。開いたり、共有したり、AIに渡したりできます。リンクを知っている人は誰でも、ロックするまで開けます。Kitのリンクの形式はhttps://{p}-{c}-<kit>-1.{node}.computers.hoody.comです。{p}はプロジェクト、{c}はコンピューター1台、{node}はそのサーバーです。

コンピューター

Bots

API