Bots
Botに話しかける。
エージェントはBotが動かす。
Botは、1つのチャットで会話全体を保持しながら使い続けられるアシスタントです。何でも頼めます。コンピューターでエージェントを立ち上げ、作業を見守り、何をしたかを報告します。Botに.hoody.botのURLを付けると、名前付きのキーで、信頼できる人やAIと共有できます。
最初のBotのchiefは、最初から使えます。Hoody AI(無料)が組み込まれています。ChatGPTでログインすることもできます。Botのサブエージェントは、許可した場合に、Claude Codeを通してClaude ProやMaxを使えます。
マイサイトの誤字とショップの価格を直してください。そのあと、新しい写真を整理してください。
chiefチャットは1つ · 古い部分は要約 · 設定した制限
完了マイサイトの誤字を直す
確認待ちショップの価格を直す
作業中新しい写真を整理
各エージェントは、コンピューター1台で動く、Hoody Agentの完全なセッションです。
具体的に
- 最初のBot
GET /api/ v1/ agent/ bots/ chief chiefは初回の利用時に作成されるので、Botの一覧が空になることはありません。- 動作する場所
https://BotはHoody Agent({p}-{c}-agent-1.{node}.computers.hoody.com/ api/ v1/ agent/ bots agent-1)で動きます。/api/bot/にあるチャットアプリのサービスではありません。
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つです。結果は報告します。
Chief、09:19
マイサイトのエージェントが誤字を直し、これを実行しようとしています。許可しますか?
bash: ./publish.sh
自分、09:20
はい、進めてください。
Chief、09:31
マイサイトは完了です。修正は公開されています。チェックアウトは、遅い検索1件を待っています。ショップのエージェントが、試せる修正を用意しています。
自分、09:12
マイサイトの価格の誤字を直してください。それと、ショップのチェックアウトが遅くなった原因を調べてください。
Chief、09:12
取りかかります。エージェントを2つ立ち上げます。マイサイトで修正する1つと、ショップでチェックアウトの所要時間を測る1つです。結果は報告します。
Chief、09:19
マイサイトのエージェントが誤字を直し、これを実行しようとしています。許可しますか?
bash: ./publish.sh
自分、09:20
はい、進めてください。
Chief、09:31
マイサイトは完了です。修正は公開されています。チェックアウトは、遅い検索1件を待っています。ショップのエージェントが、試せる修正を用意しています。
価格の誤字を直す
作業中確認待ち完了マイサイトモデル:Hoody AI(無料)
現在:価格ページを編集中待機中:bash: ./publish.sh報告済み
チェックアウトの所要時間を測る
作業中確認待ち完了ショップモデル:Hoody AI(無料)
現在:チェックアウトを計測中報告済み
自分、10:02
ショップに秋の新メニューを追加してください。注文テストが引き続き通ることも確認してください。
店長、10:02
取りかかります。1つのエージェントがメニューを追加し、もう1つが注文テストを実行します。どちらも終わったら知らせます。
店長、10:14
メニューのエージェントが、秋のメニューを公開する準備を終えました。許可しますか?
bash: ./menu.sh
自分、10:15
はい、公開してください。
店長、10:21
完了しました。秋のメニューがショップで公開され、注文テスト48件がすべて通りました。
秋のメニューを追加
作業中確認待ち完了ショップモデル:Hoody AI(無料)
現在:新しい料理12品を追加中待機中:bash: ./menu.sh報告済み
注文テストを実行
作業中確認待ち完了ショップモデル:Hoody AI(無料)
現在:注文テスト48件を実行中報告済み
自分、21:40
写真の空き容量が残りわずかです。重複を整理して、バックアップを確認してください。
写真司書、21:40
取りかかります。1つのエージェントが重複を探し、もう1つがバックアップを確認します。結果は報告します。
写真司書、21:52
整理担当のエージェントが重複を1,240件見つけました。削除しますか?
bash: ./clean.sh
自分、21:53
はい、削除してください。
写真司書、22:05
完了しました。重複1,240件を削除し、空き容量が18GBに戻りました。昨夜のバックアップは完了しています。
重複を削除
作業中確認待ち完了コンピューター:写真モデル:Hoody AI(無料)
現在:写真を比較中待機中:bash: ./clean.sh報告済み
バックアップを確認
作業中確認待ち完了コンピューター:写真モデル:Hoody AI(無料)
現在:バックアップを読み取り中報告済み
自分、08:03
マイサイトは動いていますか?問い合わせフォームが壊れていると言われました。
サイト監視役、08:03
確認します。1つのエージェントがサイトをテストし、別のエージェントがフォームを調べます。結果は報告します。
サイト監視役、08:11
フォームを調べたエージェントが不具合を見つけ、修正を用意しました。反映しますか?
bash: ./publish.sh
自分、08:12
はい、反映してください。
サイト監視役、08:19
完了しました。マイサイトは稼働中で、問い合わせフォームも再び動いています。修正後にフォームのエージェントが動作を確認しました。
問い合わせフォームを修正
作業中確認待ち完了マイサイトモデル:Hoody AI(無料)
現在:フォームのエラーを確認中待機中:bash: ./publish.sh報告済み
全ページを確認
作業中確認待ち完了マイサイトモデル:Hoody AI(無料)
現在:40ページを開いています報告済み
自分、15:30
3つのニュースレターツールのうち、読者5,000人でいちばん安いのはどれですか?
リサーチ相棒、15:30
取りかかります。2つのエージェントがツールを調べます。1つに絞って報告します。
リサーチ相棒、15:41
料金を調べるエージェントが、ショップにノートを保存しようとしています。許可しますか?
write: notes/tools.md
自分、15:42
はい、保存してください。
リサーチ相棒、15:47
完了しました。読者5,000人でいちばん安いのはツールBです。ショップのノートに、3つの料金をまとめています。
料金を比較
作業中確認待ち完了ショップモデル:Hoody AI(無料)
現在:3つの料金ページを読み取り中待機中:write: notes/tools.md報告済み
機能を比較
作業中確認待ち完了ショップモデル:Hoody AI(無料)
現在:機能を一覧化中報告済み
具体的に
- メッセージ
POST /api/ v1/ agent/ bots/ chief/ messages 202にはmessage_id、state、turn_idを返します。Botが作業中はstate: queuedを返します。- Botの返信
GET /SSE:api/ v1/ agent/ bots/ chief/ stream stateフレームに続き、ログ1行につきrowを1つ送ります。再開はLast-Event-IDで行います。- エージェントを1つ停止
POST /そのエージェントの作業をすぐに停止します。Botは停止しません。api/ v1/ agent/ bots/ chief/ delegates/ {sid}/ stop {"close": true}はセッションも閉じます。- 音声で話しかける
POST /wavまたはmp3の録音を文字に起こし、メッセージとして投稿します。api/ v1/ agent/ bots/ chief/ messages/ audio
Botに公開URLを付けます。信頼できる人、アプリ、AIを接続できます。
URLは1つで、入り口は3つです。ベースURLを受け取るアプリやSDKでは、OpenAI形式またはAnthropic形式のモデルとして使えます。MCPサーバーとして使うことも、スクリプトから通常のHTTPで呼ぶこともできます。
chief · Bot URL
https://<label>.hoody.bot 1アプリで使う
チャット補完、レスポンス、モデル。最後のユーザーメッセージだけが投稿され、アプリ側のシステムプロンプトと設定は含まれません。
メッセージとモデル。/v1を付けないURLで使います。最後のユーザーメッセージだけが投稿され、アプリ側のシステムプロンプトと設定は含まれません。
BotをMCPサーバーとして使います。応答はJSON-RPCで、維持するセッションもイベントストリームもありません。
例 Botをモデルとして使う
OpenAI形式に対応するアプリから、chief BotをほかのAIモデルと同じように呼び出せます。
自分のアプリで、chief Botをモデルとして使ってください。
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=transparent2スクリプトから
通常のHTTP
POST /bots/ chief/ messages スクリプト、cronジョブ、ほかのAIから、タスクを渡せます。
GET /bots/ chief/ stream 完成した返信とエージェントのイベントを追えます。Botのセッションストリームには、返信の文章が書き込まれるたびに表示されます。
POST /bots/ chief/ delegates/ {sid}/ stop エージェントを1つ停止しても、Botは動き続けます。
例 Botにタスクを渡す
ショップが稼働しているか確認するよう、chief Botに頼みます。
chief Botに、ショップが稼働しているか確認するよう頼んでください。
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=transparent3アクセスできる人
信頼できる人やアプリごとに、名前付きのキーを発行します。一時停止、有効期限や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は止まりません。
ふだんの言葉で書きます。設定はそれだけです。
Botにさせたくないことを、自分の言葉で入力します。保存すれば完了です。
- 構文は不要
- すべてのエージェントに届く
- 危険な作業は、開始前に確認が入る
chief · ガードレール例
具体的に
- ガードレールを置き換える
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台の端末(スマートフォン、ノートパソコン、ターミナル、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でページ分けされます。ストリームは、新しい行を書き込むと同時に送ります。モデルの切り替え
エージェントが保持するメモリ
具体的に
- ログを読む
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の音声の入口のようなパスは、条件の対象外にしてください。入るときは、呼び出しの監視、確認、変更、応答、ブロックができます。出るときは、応答を読み、呼び出し元に届く前に変更できます。パッチを当てる必要はありません。
行き呼び出しが入るとき
監視誰が何を呼び出したかを記録し、そのまま通します。スクリプトを見るスクリプトを隠す
ルール:
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); };スクリプトには、実際のクライアントIPが見えます。フックなしで呼ばれた場合、
metadata.hookは空なので404を返します。forward()は、呼び出しをそのままBotに渡します。確認ログイン済みの人だけを通します。レート制限も同じ位置に置けます。スクリプトを見るスクリプトを隠す
ルール:
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, } }); };verifyClaimは、ED25519で署名されたHoodyのログインクレームを確認します。スクリプトの全文はドキュメントにあります。クレームがない場合は401を返し、Botには届きません。このルールはWebSocketの音声パスも拒否するため、対象から外れるように絞り込んでください。- 変更届く前に、メソッド、パス、ヘッダー、ボディを書き換えます。
- ブロックウイルススキャンに通らないアップロードや、制限を超えた呼び出しを断ります。
応答「すぐ戻ります」のように自分で返信すると、Botには呼び出しが届きません。スクリプトを見るスクリプトを隠す
ルール:
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 } }); };スクリプトが返した応答は、Botには届きません。
forward()では、メソッド、パス、ヘッダー、ボディの変更もできます。nullに設定したヘッダーは削除されます。
帰り応答が出るとき
- 応答を読む呼び出し元より先に、ステータス、ヘッダー、ボディを確認します。
書き換え応答をそのまま通すことも、自分の応答を返すこともできます。スクリプトを見るスクリプトを隠す
ルール:
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()は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も使えます。
- スキル
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