> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用指引

一分钟内选对你该用的那一种模式——面向新用户的入门概览。

## 关于 Qoder Cloud Agents

Qoder Cloud Agents——Agent as a Service。让企业不必再自建一整套 Agent 基础设施：从 Agent 的构建、部署、运行，到 API 被集成、IM 渠道触达、身份隔离，全部由 Qoder 全托管交付。我们把"研发一个 Agent"到"真正上线服务终端用户"的距离，从数周压到几小时，让每一家企业都能快速拥有属于自己的 AI Agent 产品。

对外的 API 由两种模式 + 一层共享资产组成，覆盖了 Agent 从制造到交付的完整链路。

## Forward Mode

更低门槛把 Agent 落地到业务场景。基于"企业 / 模板 / 用户"三级配置体系，由管理员预设好 Agent 形态与可用资源，调用方拿来即用；同时自带 IM 渠道接入、定时任务、终端用户身份等业务必需的周边生态。

## Build Mode

提供全托管的 Agent 定义与运行能力的原子模式。无需自建 agent loop、工具执行沙箱，只需通过 API 定义 Agent、启动 Session，并在 Session 启动时动态挂载所需的沙箱环境、Skill、文件等资源，即可在云端运行复杂任务并实时接收结果。

## Resources 层

共享资产目录。环境、Skill、凭证、文件、记忆库、模型清单等被 Forward Mode 与 Build Mode 共同复用，一处维护、处处生效。

## Forward Mode vs Build Mode 对比

| 维度        | Forward Mode                                                          | Build Mode                                    |
| --------- | --------------------------------------------------------------------- | --------------------------------------------- |
| 定位        | 在 Build Mode 之上封装三级配置体系与 IM / 定时 / 身份等业务能力，帮助业务方把 Agent 快速、稳定地交付到终端用户 | 提供全托管的 Agent 定义与运行能力，开放原子化的运行时接口              |
| 适合谁       | SaaS 产品方、业务集成方、面向 C 端或大量调用方的团队                                        | 研发能力强、希望自主掌控 Agent 形态、自建上层业务体系的开发者 / 企业       |
| 配置模式      | 企业 / 模板 / 用户三级配置体系，管理员预设，调用方只传 `template_id` + `identity_id`          | 调用方在 Session 启动时显式指定 environment / Skill / 文件 |
| 调用方复杂度    | 较低——由 Forward Mode 承载业务复杂度                                            | 高——灵活度高，每次调用需自行决定挂载内容                         |
| 终端用户身份    | 内建 Identity，每个 C 端用户一个身份，记忆与权限自动隔离                                    | 不内建，需调用方自行管理隔离                                |
| IM 渠道接入   | 内建飞书 / 钉钉 / 微信 / 企微，扫码绑定                                              | 自行实现                                          |
| 定时 / 触发执行 | 内建 Schedules，cron / 一次性，配置即生效                                         | 通过 Build Mode 的 Deployments 自行编排              |

如果你的目标是将 Agent 能力快速交付给终端用户或业务系统，推荐从 Forward Mode 开始；如果你需要完全掌控 Agent 的运行时行为并自建上层产品逻辑，请使用 Build Mode。无论选择哪种模式，均可通过 Resources 统一管理组织级共享资产。

## 下一步

<CardGroup cols={3}>
  <Card title="Forward Mode" icon="share-from-square" href="/zh/cloud-agents/api/forward/overview">
    Templates · Identities · Sessions · Schedules · Channels
  </Card>

  <Card title="Build Mode" icon="cube" href="/zh/cloud-agents/api/agents/list">
    Agents · Sessions · Deployments · Dreams
  </Card>

  <Card title="Resources" icon="layer-group" href="/zh/cloud-agents/api/environments/list">
    Environments · Skills · Vaults · Files · Memory Stores · Models
  </Card>
</CardGroup>
