Bots
跟你的 Bots 说话。
它们负责运行智能体
Bot 是长期运行的助手,只有一个聊天,整段对话都会保留。想做什么直接说:它会在你的电脑上启动智能体,跟进它们的工作,并汇报它们做了什么。给它一个 .hoody.bot URL,再用带名称的密钥分享给你信任的人和 AI。
你的第一个 Bot chief 从一开始就在。内置 Hoody AI(免费)。也可以用 ChatGPT 登录。经你允许后,Bot 的帮手可以通过 Claude Code 使用 Claude Pro 或 Max。
修正我的网站上的错别字和商店的价格,再整理新照片。
chief一个聊天 · 较早内容已总结 · 你设定的限制
已完成修正我的网站上的错别字
待你确认修正商店价格
处理中整理新照片
每个智能体都是你某台电脑上的一个完整 Hoody Agent 会话。
具体说明
- 你的第一个 Bot
GET /api/ v1/ agent/ bots/ chief chief在首次使用时创建,所以 Bots 列表不会为空。- 运行位置
https://Bots 运行在 Hoody Agent ({p}-{c}-agent-1.{node}.computers.hoody.com/ api/ v1/ agent/ bots agent-1) 上,不是/api/bot/的聊天应用服务。
一条消息一路送达,报告会回到你手上。
你
从以下任一方式发起
报告完成。商店已修复。
你的电脑
你的 Bot
立刻接收你的消息,做完后汇报
智能体
它的帮手
智能体
它的帮手
- 我的网站更新
- 商店修复
- 照片库备份
示例这一切都在你的电脑上运行。你的 Bot 认得每一台。
具体说明
- 它的智能体
GET /每个受委派的智能体都是一个普通会话,用api/ v1/ agent/ bots/ chief/ delegates ?state=open /sessions路由读取或接入。已打开的会话带有capability和current_step。- 它自己的实时回合
GET /回复文本和思考内容会边写边出现,还有工具调用和每个回合的结束。Bot 收到第一条消息后,api/ v1/ agent/ sessions/ {session_id}/ stream session_id来自GET /bots/{id}。
更多:一次一个 Bot,看完整的一个回合
你只提问一次,它来分派工作
它先回复,把耗时的部分交给新启动的智能体,再带着智能体的提问和结果回来找你。
你,09:12
修正我的网站上价格的错别字。再查一下商店的结账为什么变慢了。
Chief,09:12
收到。我来启动两个智能体:一个在我的网站上修正,一个在商店测量结账耗时。做完我向你汇报。
Chief,09:19
我的网站智能体改好了错别字,想运行这个操作。允许吗?
bash: ./publish.sh
你,09:20
可以,执行。
Chief,09:31
我的网站已完成:修复已上线。结账在等一次缓慢的查询,商店的智能体已有可试的修复方案。
你,09:12
修正我的网站上价格的错别字。再查一下商店的结账为什么变慢了。
Chief,09:12
收到。我来启动两个智能体:一个在我的网站上修正,一个在商店测量结账耗时。做完我向你汇报。
Chief,09:19
我的网站智能体改好了错别字,想运行这个操作。允许吗?
bash: ./publish.sh
你,09:20
可以,执行。
Chief,09:31
我的网站已完成:修复已上线。结账在等一次缓慢的查询,商店的智能体已有可试的修复方案。
修正价格错别字
处理中待你确认已完成在我的网站模型:Hoody AI(免费)
当前:正在编辑价格页等待:bash: ./publish.sh已汇报
测量结账耗时
处理中待你确认已完成在商店模型:Hoody AI(免费)
当前:正在测量结账耗时已汇报
你,10:02
把新的秋季菜单加到商店,并确认订单测试仍然通过。
商店管家,10:02
收到。一个智能体添加菜单,另一个运行订单测试。两个都完成后我告诉你。
商店管家,10:14
菜单智能体准备好上线秋季菜单了。允许吗?
bash: ./menu.sh
你,10:15
可以,发布。
商店管家,10:21
完成:秋季菜单已在商店上线,48 项订单测试全部通过。
添加秋季菜单
处理中待你确认已完成在商店模型:Hoody AI(免费)
当前:正在添加 12 道新菜等待:bash: ./menu.sh已汇报
运行订单测试
处理中待你确认已完成在商店模型:Hoody AI(免费)
当前:正在运行 48 项订单测试已汇报
你,21:40
照片库快满了。清理重复项,并检查备份。
照片管理员,21:40
收到。一个智能体查找重复项,另一个检查备份。做完我向你汇报。
照片管理员,21:52
清理智能体找到了 1,240 个重复项。要删除吗?
bash: ./clean.sh
你,21:53
可以,删除。
照片管理员,22:05
完成:删除了 1,240 个重复项,重新空出 18 GB。昨晚的备份已完成。
删除重复项
处理中待你确认已完成在照片库模型:Hoody AI(免费)
当前:正在对比照片等待:bash: ./clean.sh已汇报
检查备份
处理中待你确认已完成在照片库模型:Hoody AI(免费)
当前:正在读取备份已汇报
你,08:03
我的网站能正常访问吗?有人说联系表单坏了。
网站巡检员,08:03
正在检查。一个智能体测试网站,另一个查看表单。我会向你汇报。
网站巡检员,08:11
表单智能体找到了 bug,并给出了修复。要发布吗?
bash: ./publish.sh
你,08:12
可以,发布吧。
网站巡检员,08:19
完成:我的网站已恢复正常,联系表单又能用了。表单智能体在修复后做了测试。
修复联系表单
处理中待你确认已完成在我的网站模型:Hoody AI(免费)
当前:正在读取表单错误等待:bash: ./publish.sh已汇报
检查每个页面
处理中待你确认已完成在我的网站模型:Hoody AI(免费)
现在:正在打开 40 个页面已汇报
你,15:30
三个 newsletter 工具里,给 5,000 位读者发送最便宜的是哪个?
调研搭档,15:30
收到。两个智能体去研究这几个工具,我带着一个推荐结果回来。
调研搭档,15:41
价格智能体想把笔记保存到 Shop。允许吗?
write: notes/tools.md
你,15:42
可以,保存。
调研搭档,15:47
完成:工具 B 对 5,000 位读者最便宜。Shop 上的笔记列出了三者的价格。
对比价格
处理中待你确认已完成在商店模型:Hoody AI(免费)
现在:正在读取三个价格页面等待:write: notes/tools.md已汇报
对比功能
处理中待你确认已完成在商店模型:Hoody AI(免费)
现在:正在列出功能已汇报
具体说明
- 你的消息
POST /返回api/ v1/ agent/ bots/ chief/ messages 202,附带message_id、state和turn_id;Bot 忙时返回state: queued。- 它的回复
GET /SSE:先发一个api/ v1/ agent/ bots/ chief/ stream state帧,之后每条日志行发一个row;用Last-Event-ID续接。- 停止一个智能体
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,三种接入方式:作为模型,供接受 base URL 的应用和 SDK 使用(OpenAI 或 Anthropic 格式);作为 MCP 服务器;或在脚本中通过纯 HTTP 调用。
chief · Bot URL
https://<label>.hoody.bot 1在应用中
支持 chat completions、responses 和 models。只发送最后一条用户消息,应用自己的系统提示词和设置不会发送。
支持 messages 和 models,使用不带 /v1 的 URL。只发送最后一条用户消息,应用自己的系统提示词和设置不会发送。
把 Bot 当作 MCP 服务器:返回 JSON-RPC 响应,无需保持会话,也没有事件流。
示例 把 Bot 用作模型
在任何支持 OpenAI 格式的应用中,都能像用其他 AI 模型一样与你的 chief Bot 对话。
在我自己的应用里,用我的 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 停止一个智能体,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谁能进入
给每个可信的人或应用一个带名称的 Key。可以暂停它,设置过期时间或 IPv4 限制,也可以单独撤销。
所有持有 Key 的人共用同一个对话。只分享给你信任的人和 AI。
可以把 Bot 限定在一个领域:它的智能体只能看到该领域的电脑。
具体说明
- Bot 基础 URL
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 位十六进制 id。GET /bots/{id}在urls下列出它们。共享 Bot:https://<label>.hoody.bot/v1/chat/completions,带 Bearer Key。- 发送消息
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'文本最多 64 KiB;返回 202。- 停止一个智能体
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."}一个文本字段;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}/realtime每个 Bot 同一时间只有一个实时语音连接;takeover=true会替换它。docs / api / agent / bots ↗
更多:日志
四台设备同时打开同一个 Bot:手机、笔记本、终端和 AI 应用。手机和笔记本在同一时刻(22:31)发送消息,消息依次记为 #152、#153,Bot 的回复记为 #154。每台设备看到的顺序相同。较早的轮次折叠成一段简短摘要,涵盖 #1 至 #120 行;最新的轮次,#121 至 #154,逐字保留。完整日志保留每一行。
每台设备,同一个对话。手机、笔记本、终端和 AI 应用同时打开同一个 Bot,每台设备看到的顺序相同。持有 Key 的人也共用这个对话,所以只分享给你信任的人。
每条消息都会得到下一个编号。同一时刻发送的两条消息,依次记为 #152、#153。Bot 忙碌时发送的消息,会等到它的下一轮。
空间不会用完。模型的上下文窗口填满时,较早的轮次会折叠成简短摘要,最新的轮次逐字保留,Bot 继续工作。日志保留每一行;执行遗忘后,这些行会移到归档。
每行包含什么
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删除。
更多:Hook
接入 Hook:你的脚本最先看到调用,最后看到响应
Hook 会先把匹配的 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。没有经过 Hook 直接调用时,
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()再把它发出。流式响应在 Hook 的时间限制处结束,最长 30,000 ms。- 清理响应头去掉响应中的私有头,加上 CSP。
每个 Hook 都有时间限制,默认 500 ms。脚本出错或超时,调用就在这里停止。docs / proxy / hooks ↗
具体说明
- 添加 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}服务器会为 Hook 分配 id。规则按顺序执行,第一条匹配的生效。- 读取版本
GET /api/v1/computers/{id}/proxy/hooks/agent每次修改 Hook 都需要带上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 ↗
一行命令,免费开始
免费开始,不需要银行卡:内置 Hoody AI,你已经在用的 AI 也能用。
- 技能
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdk第二条会把所有文档页面保存到磁盘,供离线使用。- docs / foundation / agent-skill-bundle
- CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | sh第二条适用于 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