完全云托管:网关与托管任务
大多数团队把 Agent 留在自己的环境里,用 SDK 接入。不想自己运行任何东西的团队,Guard 有两种完全云托管的方式。
| SDK(默认方式) | 云托管网关 | 托管任务 | |
|---|---|---|---|
| 你们要做的 | 安装 SDK,或运行 MCP 代理 | 把 MCP 客户端、模型 base URL 或 HTTP 调用指向网关,用专用凭据 | 提交容器镜像、启动参数、任务输入和要取回的文件 |
| 调用在哪里执行 | 你们的环境 | 我们运行的网关机器,每个部署一台 | 我们运行的机器,每个任务一台,在非 root 容器里 |
| Guard 管到哪里 | 你们接入的工具、MCP 服务和 HTTP 调用 | 经过网关已注册路由的调用。你们自己机器上的文件、进程和直连请求不在此列 | 任务的临时工作区、容器权限,以及它的工具和网络出口 |
| 我们处理什么 | 只有脱敏事件 | 这些路由上的请求和响应,以及你们的上游凭据 | 任务输入、结果和日志 |
托管方式会处理你们的数据,所以需要你们明确同意。没有勾选「同意」(data_hosting_consent)时,任何网关部署和托管任务都会被拒绝。
控制台里对应的页面是「网关」「托管任务」和「上游凭据」。策略和审批还在原来的「策略」和「审批」页。
云托管网关
- 发布一份强制执行模式的策略。只观察或建议模式下,网关拒绝接入。
- 在「网关」页新建部署,填入你们的公网 HTTPS 上游。路由可以是:
- 固定的 HTTP 路由。
- 模型接口:
/v1/chat/completions、/v1/responses或/v1/embeddings。只支持由你们的应用自己执行的 function tools,不支持模型厂商代为执行的工具或后台任务。 - 走 Streamable HTTP 或 SSE 的 MCP 服务。每个允许的工具都要有批准过的 manifest,不会因为第一次见到就自动批准。
- 在「上游凭据」页保存上游凭据(
Authorization值、OAuth client secret、镜像仓库凭据)。浏览器在上传前先加密。之后在新的配置版本里用secret_id引用。 - 生成网关凭据,下载客户端配置。凭据只显示一次。它不包含上游密钥、执行器凭据或云身份,可以轮换和撤销。
- 调用路由,或者修改模型、MCP 客户端的地址。
python
import uuid, httpx
# credential 从客户自己的密钥管理读取。
response = httpx.post(endpoint + '/request',
headers={'Authorization': 'Bearer ' + credential,
'Idempotency-Key': str(uuid.uuid4())},
json={'route': 'business', 'payload': {'query': '财务摘要'}})- 写操作的路由必须带
Idempotency-Key。同样的键和参数再提交一次,返回已记录的状态,不会重复调用上游。 - 需要审批的调用,网关把原始参数存成加密快照。审核员批准后,用
GET /pending取回待处理的调用,再用POST /pending/{id}/resume恢复执行。只使用保存的那份参数。 - 说不准有没有到达上游的调用(进程重启、传输出错、开始执行之后失败)会停在「需核对业务结果」。先核对你们的系统,再决定要不要重试。
- 带 OAuth 的 MCP 上游,由项目所有者在控制台发起授权。访问令牌和刷新令牌只存在这个网关的加密 vault 里。只支持预注册的 OAuth 客户端。
- 每个项目最多 5 个网关。
托管任务
托管任务是一次性的:一个按 digest(@sha256:…)指定的 linux/amd64 容器镜像,加一个参数数组。Guard 从不替你们拼 shell 命令。
- 容器以 UID/GID 10001 运行,根文件系统只读,没有 capabilities、sudo、Docker socket,也不挂载宿主机目录。
- 输入是只读的
/run/guard/task.json。/workspace是可写的临时目录。任务必须生成/workspace/result.json。其他要取回的文件在提交时列为产物。符号链接和工作区以外的路径一律拒绝。 - Agent 只能访问内部网络里一个固定的转发器,由它加上任务的凭据。环境里已设置
OPENAI_BASE_URL、MCP_GATEWAY_URL和GUARD_HTTP_URL。OPENAI_API_KEY只是占位值,实际鉴权由转发器完成。Agent 拿不到控制面、上游或云平台的任何凭据。 - 提交任务必须带
Idempotency-Key。
| 上限 | 数值 |
|---|---|
| 每个项目的任务 | 同时只运行 1 个,排队和运行中的合计最多 30 个 |
| 时长 | 默认 900 秒,最长 3,600 秒 |
| 容器 | 2 CPU、4 GiB、128 个进程 |
| 输入 / 结果 / 产物 / 日志 | 1 MiB / 3 MiB / 合计 100 MiB / 1 MiB |
- 收集日志时,已知的平台凭据和常见的密钥字段会被遮盖。
- 取消、超时或机器失联时,任务的访问权限被撤销,机器被删除。不会自动替你们重新开一个任务。
- 机器结束时删除工作区。结果加密保存。下载链接只能用一次,5 分钟内有效。7 天后拒绝下载并删除结果。你们也可以提前删除。
限制
- 网关只保护经过它路由的调用。
- 客户端用专用的 bearer 凭据接入。客户端登录、通用的 OAuth 客户端发现和动态客户端注册都不支持。
- 网关更新后 MCP 会话需要重新连接。正在进行的调用不会被重放。