Qoder CN 系列：Forward Mode

Forward Mode 在 Managed Mode 之上封裝了三級配置體系與 IM / 定時 / 身份等業務能力，協助業務方把 Agent 快速、穩定地交付到終端使用者。管理員預設好 Agent 形態與可用資源後，調用方只需傳入 template_id 與 identity_id 即可拿來即用，無需關注底層 Agent 運行時細節。

Forward Mode 內建 IM 渠道接入（飛書、DingTalk、微信、企微）、定時觸發（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"
  }
}