HybridInference Cloud Agent
English 简体中文

快速上手

  • 完整的本地环境
    • 运行
      • 端口与多套环境并行
      • 沙箱网络
      • 通过本地代理构建
      • 冒烟测试测了什么
      • 在轮次进行中试试各种交互
  • 开发者指南
    • 准备本地仓库
    • 找到改动该落在哪里
    • 守住依赖边界
    • 选择要跑的检查
      • 在本地跑 CI
    • 修改 API
    • 打包与文档
  • 代码结构
    • 先看部署边界
    • 跟着一个控制平面请求走
    • API schema 按领域划分
    • 跟着一次主机执行走
    • 共用的操作性能剖析
    • 跟着一次浏览器操作走
    • 加功能时别把结构弄乱
  • 贡献指南
    • 一句话流程
    • 提交评审前的检查
    • 持续集成
    • 契约
  • 翻译文档
    • 改了英文页面之后
    • 中文文风
    • 中文里的坑
    • 中文术语

概念

  • 原生会话的上下文记忆
    • 上下文状态
    • 共享边界上的原生会话身份
    • 其他原生 CLI
    • 这次发布解决了什么，还剩什么
    • 上线验收前的检查
  • Agent 准入策略
    • 权限与请求检查
    • 出错时的表现
    • 基础设施凭据
    • 验证网关契约
    • 上线步骤
  • Agent 只保存最少的身份信息
    • 令牌与会话
    • 数据库身份边界
    • 升级现有部署
      • 回滚和恢复时的限制
  • 本服务依赖的网关契约
    • 这些文档是什么，不是什么
    • 来源 commit
    • 这些文档没有覆盖的内容
    • 这里唯一属于我们自己的文档
    • 怎样检查
  • 安全
    • 报告漏洞
    • 受理范围
    • 部署时不能想当然的地方
  • 面向所有者的 Web 应用
    • 侧边栏和对话列表
      • 创建仓库
      • 新手引导
      • 对话列表 API
    • 对话视图
      • 轮次导航条
      • 阅读位置
      • 任务和子代理
      • 工作区面板的键盘操作
      • 在浏览器里检查
    • 工具审批
    • 记忆、头像和首页建议
      • 记忆
      • 头像和首页建议
    • 工作区文件
    • 其他小功能

运维

  • Cloud Agent 沙箱运维手册
    • Admin Settings
    • 沙箱归档存储
    • 数据库浏览器
    • pgAdmin
    • 一个任务会做什么
      • 临时工作区
      • 自动生成任务标题
      • 改写草稿提示词
      • 对话状态和运行历史
      • agent 的原生提问
    • 谁能对哪个仓库运行任务
    • 沙箱清单、资源用量与操作
      • 所有者的 Usage 页面
    • 查看任务记录下来的事件
    • 团队
    • MCP 服务器
      • 监听器与连接
      • 授权与路由
      • 端到端测试覆盖
      • Connector 的配置
      • 部署与回滚
      • 运行时边界
      • --strict-mcp-config 挡住的是什么
    • 任务真正跑起来之前
      • 0. 沙箱网络需要主机防火墙规则、一个 DNS 解析器和两个中继
      • 1. 只有已注册的沙箱主机才会运行任务
      • 2. 凭据
    • 自行部署运行
      • 主机配置参考
      • 在 runner 主机上配置 Kata
        • Guest 内的进程追踪与成员隔离
        • Guest 的网络
        • 已有的 runc 沙箱组与激活时的检查
        • 调度与运行时证明
      • 需要多少 runner
        • 清理成员进程
        • Fork 的兼容性与轮次顺序
        • 执行槽位
        • 移除服务器
        • 沙箱设置
        • 沙箱归档
        • 可恢复检查点
        • 恢复被移除主机上的沙箱
        • 环境安装快照
        • 启动失败与队列顺序
      • 沙箱组唯一的空闲计时（以及几个独立的安全看门狗）
        • attempt 租约丢失
        • 安全看门狗
        • Resume、Fork 与发布
      • 滚动部署顺序
        • 主机和控制平面何时就绪
        • 回滚的兼容性
        • 冷启动与部署失败
      • 保留旧迁移链的数据库
      • 重建 Agent 数据库
      • 执行不向后兼容的迁移
      • 主机上的保留 Docker 存储
      • 沙箱存储用了多少？
        • 这个读数测的是什么
        • 证实存储拓扑
        • 刷新或关闭这个指标
        • 测量的局限
      • 任务在哪台机器上跑
      • 在另一台机器上运行 runner
        • 在远端机器上授权隧道
        • 回程：控制平面如何访问这台主机的 sandbox manager
      • 这个拓扑里，三件看起来是细节、其实很要紧的事
      • 沙箱网络
        • 放行什么，拒绝什么
        • MCP 的前提条件，以及已接受的推理授权风险
        • 主机上的防火墙表
        • 地址池重叠
        • 选择解析器
        • 保护更多的地址
        • 被拒绝时怎么排查
      • 升级到单一网络时的一次性清理
    • 运行时验证
    • SSH 服务器
    • 可复用的云环境
      • 团队环境
  • 升级说明
    • 启动本次发布之前
    • 近期迁移
    • 新增迁移时
  • 环境变量清单
    • 设置与初始化配置
      • Sandbox Manager 的新旧名称兼容
    • 唯一的硬性规定
    • 开通状态
    • 本地开发工具
    • 控制平面（cloud_agent）
      • 本地和 CI 的权限回归测试
      • 本地和 CI 的恢复回归测试
      • 数据库
      • 用 pgAdmin 管理数据库
      • 网关契约
      • 本服务自己的 secret
      • 沙箱删除前的归档
      • 控制平面读取的行为开关
      • 代码托管
      • MCP
      • 在管理页面上设置的沙箱参数
      • 可选：计算资源管理
      • 仓库环境
    • 主机 agent（cloud_agent_host）
      • 这套主机服务自己的身份
      • 调度
      • Sandbox Manager、运行时与上报
      • 物理服务器和执行环境
    • 沙箱隔离（由主机 agent 读取，沙箱沿用）
      • Kata 运行时资格验证的代次
      • 完整本地环境的数据库恢复
      • Claude 推理请求的重试策略
      • Agent CLI 的版本固定（构建镜像时）
    • Web（apps/frontend/）
      • 构建时决定：镜像变体
      • 运行时决定：部署的身份信息
    • 在 HybridInference 那一侧设置，不在这里
    • 基础设施（不是环境变量）
    • 新增变量时
  • 计算资源与全局沙箱位置
    • 哪些东西必须放在稳定的基础设施上
    • 支持的初始部署方式
      • 优先选用的 CloudLab 节点类型
      • 沙箱存储路径
    • 准备一份受信任的部署配置
      • 自动安装
      • 手动安装和基于文件的安装
      • 三条隧道和 sandbox manager 路由
      • 自己登记主机密钥的 CloudLab 节点
    • 启用旧式的、基于文件的 profile
    • 日常操作流程
    • 恢复与释放的边界
    • 租期结束前把沙箱迁出去
    • CloudLab 节点自动替换
      • 对生产流量开放之前的验收
  • 发布
    • 生成器检查什么，又故意不检查什么
    • 生成发布
    • 光能构建还不够，还得能启动
    • 控制平面集成验收
    • 镜像仓库的目录布局不属于这份契约
    • 和设计文档不一样的地方
    • 部署 recipe
      • 按设计规定的顺序部署两台机器
    • 下游部署仍要自己负责的事
  • 部署失败检查与队列监控
    • 两次激活期间一直保持排空
    • 停掉正在服务的 runner 之前
      • 主机运行时的资格验证
      • 网络核实与启动阶段的工作
      • 队列为空时的等待，以及 CI 的证据
    • 旧进程对新 schema
    • 部署之后的检测
    • 恢复的边界
      • 快照发布失败
  • 备份与恢复
    • 初始的运维策略
    • 一套恢复集里要有什么
    • 采集一套彼此对应的恢复集
    • 恢复，并在重新开放前验证
    • 恢复到上一个产物发布
  • 主机运行时设置
  • 主机执行限制
  • Runner 租约失效
    • 租约时长与重试
    • 凭确切的证据下结论
    • 上报和确认失败
    • 保留对话什么时候还能继续
    • 可以安全释放的情况：子进程从没接下这个轮次
  • Staging 端到端冒烟测试
    • 跑通一次能证明什么
    • 0. 开始之前
    • 1. 配置
    • 2. 启动控制平面
    • 3. 登录：走一遍完整的身份流程
    • 4. 注册主机
    • 5. 跑通一个完整的任务
    • 6. 那些过一阵才会出问题的地方
    • 7. 收尾清理
    • 记录
HybridInference Cloud Agent
  • 搜索

© 版权所有 2026, The HybridInference contributors。

利用 Sphinx 构建，使用的 主题 由 Read the Docs 开发.