Skip to content

完全云托管:网关与托管任务 ​

大多数团队把 Agent 留在自己的环境里,用 SDK 接入。不想自己运行任何东西的团队,Guard 有两种完全云托管的方式。

SDK(默认方式)云托管网关托管任务
你们要做的安装 SDK,或运行 MCP 代理把 MCP 客户端、模型 base URL 或 HTTP 调用指向网关,用专用凭据提交容器镜像、启动参数、任务输入和要取回的文件
调用在哪里执行你们的环境我们运行的网关机器,每个部署一台我们运行的机器,每个任务一台,在非 root 容器里
Guard 管到哪里你们接入的工具、MCP 服务和 HTTP 调用经过网关已注册路由的调用。你们自己机器上的文件、进程和直连请求不在此列任务的临时工作区、容器权限,以及它的工具和网络出口
我们处理什么只有脱敏事件这些路由上的请求和响应,以及你们的上游凭据任务输入、结果和日志

托管方式会处理你们的数据,所以需要你们明确同意。没有勾选「同意」(data_hosting_consent)时,任何网关部署和托管任务都会被拒绝。

控制台里对应的页面是「网关」「托管任务」和「上游凭据」。策略和审批还在原来的「策略」和「审批」页。

云托管网关 ​

  1. 发布一份强制执行模式的策略。只观察或建议模式下,网关拒绝接入。
  2. 在「网关」页新建部署,填入你们的公网 HTTPS 上游。路由可以是:
    • 固定的 HTTP 路由。
    • 模型接口:/v1/chat/completions、/v1/responses 或 /v1/embeddings。只支持由你们的应用自己执行的 function tools,不支持模型厂商代为执行的工具或后台任务。
    • 走 Streamable HTTP 或 SSE 的 MCP 服务。每个允许的工具都要有批准过的 manifest,不会因为第一次见到就自动批准。
  3. 在「上游凭据」页保存上游凭据(Authorization 值、OAuth client secret、镜像仓库凭据)。浏览器在上传前先加密。之后在新的配置版本里用 secret_id 引用。
  4. 生成网关凭据,下载客户端配置。凭据只显示一次。它不包含上游密钥、执行器凭据或云身份,可以轮换和撤销。
  5. 调用路由,或者修改模型、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 会话需要重新连接。正在进行的调用不会被重放。