Forward Mode

Forward Mode 在 Managed Mode 之上封装了三级配置体系与 IM / 定时 / 身份等业务能力，帮助业务方把 Agent 快速、稳定地交付到终端用户。管理员预设好 Agent 形态与可用资源后，调用方只需传入 template_id 与 identity_id 即可拿来即用，无需关注底层 Agent 运行时细节。

Forward Mode 自带 IM 渠道接入（飞书、钉钉、微信、企微）、定时触发（Schedules）和终端用户身份隔离（Identity），适合 SaaS 产品方、业务集成方以及面向 C 端或大量调用方的团队直接使用。

基础 URL

所有 Forward 端点均使用生产网关：

https://api.qoder.com.cn/api/v1/forward

认证

所有 Forward 端点都需要 Qoder PAT 认证：

头部	必选	说明
Authorization	是	Bearer <PAT>

有副作用的 POST 端点可接受 Idempotency-Key 头。

资源族

资源	说明
Templates	可复用的 Agent 形态基线，定义默认 Agent 与 Session 配置
Identities	终端用户身份，支持按身份的配置覆盖与隔离
Sessions	基于模板 + 身份发起的对话或任务运行
Schedules	Cron 或一次性触发的执行
Channels	接入外部 IM 渠道
Resources Registry	将共享资源注册到 Forward

错误信封

错误使用 Forward 错误信封：

{
  "type": "error",
  "request_id": "req_xxx",
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_request_body",
    "message": "invalid request body"
  }
}