智能体Your Agent Gets a Body
Every Kit service is an HTTPS endpoint. Spawn a container, get 14 HTTP tools. Your agent already knows HTTP — that's the whole point.
$ ws connect wss://proj-1-abc.srv.containers.hoody.com/api/v1/agent/ws
[tool_use] { tool: "terminal_exec", command: "npm install" }
[tool_use] { tool: "write_file", path: "/app/src/auth.ts" }
[tool_result] { output: "3 tests passed" }
[tool_use] { tool: "daemon_start", service: "api-server" }
[completed] 任务在 4 分 12 秒内完成
一次 POST。三种模式。
提交任务、观看 WebSocket 流、失败时回滚——全部通过标准 HTTP 调用。
提交任务并流式传输事件
POST 自然语言描述来创建任务，然后打开 WebSocket 来实时流式传输每个工具调用和结果。
# 1. 创建任务
POST /api/v1/agent/tasks
'{'
"description": "Install deps, write auth.ts, run tests",
"mode": "code"
'}'
→ '{' "id": "task-abc123", "status": "running" '}'
# 2. 打开 WebSocket 流
WS wss://.../api/v1/agent/ws
> '{' "type": "tool_use", "tool": "terminal_exec", "command": "npm install" '}'
> '{' "type": "tool_use", "tool": "write_file", "path": "/app/src/auth.ts" '}'
> '{' "type": "tool_result", "output": "3 tests passed" '}'
> '{' "type": "tool_use", "tool": "daemon_start", "service": "api-server" '}'
> [completed] 任务在 4 分 12 秒内完成
Give Every Agent a Complete Computer
One container creation call provisions 14 HTTP services. No setup, no driver management, no auth ceremony beyond a bearer token.
智能体生成智能体。无需协调器。
智能体 A 通过 HTTP 创建智能体 B 的容器，通过智能体服务 URL 分配任务，直接读取其文件。只是 URL 与 URL 对话。
// Agent A spawns Agent B and assigns work
const worker = await client.api.containers.create(PROJECT_ID, {
name: "ai-worker-backend",
server_id: "us-east-1",
container_image: "hoody-kit:latest",
hoody_kit: true,
});
await fetch(
`https://${PROJECT_ID}-${worker.id}-agent-1.${SRV}/api/v1/agent/tasks`,
{ method: "POST", body: JSON.stringify({
description: "Build payment module", mode: "code"
})}
);
网络拓扑
智能体是对等的。任何容器通过 HTTP 调用任何其他容器。无总线，无协调器。
并行工作
同时分派 10 个专家智能体。前端、后端、测试——全部并行。
跨容器读取
智能体 A 通过 Kit 文件服务读取智能体 B 的文件。无需停止工作者即可检查。
隔离故障
一个智能体的崩溃仅销毁其自身沙箱。故障无法传播。
控制每一个 Prompt，无需代理代码。
七个事件钩子，五种动作类型，声明式 JSON 规则。规则引擎在 hoody-agent 内部运行——零延迟，零代理。
chat.system.transform
在 LLM 看到之前，将安全规则附加到每个生产会话的系统提示中。
tool.execute.before
在任何智能体运行 bash 之前通知人类审批。在循环中，无需代理。
session.error
当整个机群中任意会话失败时，向 PagerDuty 触发 Webhook。
{
"mitm": {
"rules": [
{
"id": "safety-guardrail",
"enabled": true,
"trigger": {
"event": "chat.system.transform",
"tags": ["prod"]
},
"action": {
"type": "prompt-inject",
"position": "append",
"target": "system"
}
}
]
}
}
300+ 个模型，一次配置变更即可切换。
将任意 AI 客户端指向 https://ai.hoody.com/api/v1。使用 container-X 作为密钥——它只在你的基础设施内有效。删除容器即可即时撤销。
@hoody.com Skill Discovery
Any AI agent with web access sends @hoody.com and receives a Skill describing your entire HTTP API — no plugin, no SDK, no custom endpoint.
每次智能体运行前创建快照
永远不要让智能体在没有快照的情况下修改容器。一次 API 调用，即时回滚。
hoody snapshots create-snapshot $AGENT_ID \
--alias "before-experiment"
6 Endpoints. Full Agent Control.
Task lifecycle, real-time monitoring, and MCP attachment — all standard HTTP and WebSocket.
Tasks
{count, plural, =1 {# endpoint} other {# endpoints}'}POST /api/v1/agent/tasks
Monitor
{count, plural, =1 {# endpoint} other {# endpoints}'}wss://.../api/v1/agent/ws
MCP + Web UI
{count, plural, =1 {# endpoint} other {# endpoints}'}POST /api/v1/agent/mcp/servers
代理真正能做什么
再多的提示工程也给不了你的三种能力——它们就在平台里。
5 种任务模式，会话中可切换
code、architect、debug、ask、orchestrator — 每种模式针对不同意图调优。通过 PATCH /api/v1/agent/tasks/{id}/mode 切换，无需停止任务。
MCP 运行时工具发现
在运行时挂载任何兼容 MCP 的服务器——GitHub、Slack、Jira。代理会发现并即时将新工具合并到当前会话中。
终端侧面板嵌入
通过 ?panel=AGENT_URL 将代理嵌入任意 hoody-terminal URL 作为侧面板。代理与终端共享容器的文件系统和进程状态。
Your First Agent is One Container Away
Spawn a container with hoody-kit. 14 HTTP services wake up instantly when the agent does. Hand the URL to Claude, Codex, or any agent that speaks HTTP.