随着模型能力不断提升，AI 的角色也在拓展：从对话答疑、辅助编程，到持续执行长时复杂任务。要完成这些任务，Agent 需要持续运行，保存进度、调用工具，并在执行过程中反馈结果。通过云端托管，开发者可以将这些运行细节交给平台，把精力放在任务本身和业务实现上。与此同时，Agent 的运行框架也会随着模型的进步不断迭代，今天精心设计的复杂流程，明天可能就有更简单高效的替代实现。我们希望开发者能够通过稳定的接口使用 Agent，而底层运行架构能够持续演进；任务中积累的反馈，也能通过评测和配置优化，帮助 Agent 不断改进。
Qoder Cloud Agents，简称 QCA，是 Qoder 团队今年初推出的一个全托管的 Agent 平台，让复杂任务在云端运行，并实时返回进展与结果。本周 QCA 也将迎来 1.0 正式版本的发布。通过开放 API、多语言 SDK、CLI、Webhook、Skills 等丰富的集成方式，开发者可以将 Agent 接入自己的应用与工作流。QCA 提供两层产品能力：Managed 承接底层运行、会话状态与任务执行，提供精简的基础 API；Forward 在其上提供面向业务的快速搭建与集成能力。本文将重点介绍 QCA Forward，看看如何用 10 分钟快速搭建一个专属 Agent 原型。
开箱即用的 Agent 服务
将 Agent 交给云端托管，平台便可统一管理运行环境、会话状态与执行过程。面向实际应用，还需要处理用户身份、数据持久化和外部资源接入。QCA Forward 将这些常用能力组合起来，让开发者通过配置和集成，快速搭建面向业务的 Agent 服务。
- Template、Session、Env：Template 定义 Agent 的能力与默认配置，Session 承载任务中的多轮交互，Env 配置执行环境，让同一套能力可以在不同任务中复用。
- Identity、IM Channel：管理终端用户身份，并将 Agent 接入国内和海外主流的 IM 渠道，让用户在熟悉的入口发起任务、接收结果。
- Drive、Files、Skills、连接器：管理工作文件与任务产物，复用业务技能，连接获准访问的外部服务，为 Agent 提供完成工作所需的资料和工具。
- Realtime、Batch：分别支持实时交互与批量任务处理，适用于实时语音交流、同类任务集中执行等场景。
- Schedule：按计划启动任务，让周期性的重复工作自动执行。
- 评测观测：通过执行过程与结果了解 Agent 的工作情况，结合任务样例和评测检查效果，为排查问题、调整配置提供依据。
这些能力可以按业务需要选择组合。开发者可以保留自己的产品界面与业务流程，通过 Forward 管理 Agent 的配置、身份、资源和交互入口，将 Agent 服务集成到自己的应用中。
灵活集成，适配不同开发方式
QCA Forward 提供开放 API、多语言 SDK、CLI、Webhook、Skills 等集成方式，覆盖应用开发、流程衔接、脚本自动化和原型开发等场景。
- 开放 API：通过统一接口管理 Agent 相关配置、创建会话、提交任务并获取执行结果，适合需要自主设计产品界面和业务流程的应用。
- 多语言 SDK：提供 Python、TypeScript、Go 等语言的接入方式，帮助开发者在现有项目中调用 QCA，减少重复的接口对接工作。具体安装与使用方式以对应 SDK 文档为准。
- CLI：通过命令行操作 QCA，适合快速调试、任务执行及脚本集成，也便于在现有自动化流程中加入 Agent 能力。
- Webhook：将已支持的任务事件通知到业务系统，便于触发结果处理、用户通知等后续动作，适合需要与现有业务流程衔接的场景。
- Skills：为 Qoder 或支持 Skills 的 Coding 工具提供 QCA 接入指引，开发者可以用自然语言描述需求，由 Coding 工具辅助完成接入代码与应用原型。
不同方式可以配合使用。例如，通过 SDK 在应用中发起任务，通过 Webhook 衔接后续处理；也可以先借助 Skills 完成原型，再逐步整合进现有项目。
接口与能力说明：QCA 开发文档
以个人投资助手为例，快速搭建原型
以企业面向客户提供的投资助手为例：用户在移动端 App 或 Web 端上传研究资料、整理关注标的，通过文字或实时语音了解资讯、比较信息，也可以在 IM 中绑定助手继续交流。企业还需要识别每位客户、保存其工作资料、连接外部服务，并查询和管理终端用户的积分使用量。开发者可以通过 QCA Forward 的 API、SDK，将这些能力集成到自己的系统中。
每位客户都有自己的工作空间。用 Identity 关联企业应用中的终端用户，围绕该身份组织会话、资源与配置；通过 Drive 持久化保存用户上传的资料、关注清单和生成的研究报告。新开会话后，Agent 仍可按授权访问此前保存的资料，无需重复上传。
复用研究方法，连接业务数据。企业可以把财报阅读、资讯摘要、报告整理等方法封装为技能（Skills），用连接器接入获准使用的行情、新闻、公告或企业数据服务。技能描述 Agent 如何完成工作，连接器提供所需工具和数据，企业可以按业务需要组合使用。
在 App、Web、语音和 IM 中提供服务。企业开发者使用 API、SDK 集成 QCA Forward 能力，构建自己的移动端与 Web 应用，自主设计界面、交互和业务流程；Realtime 承接实时语音交互，IM 集成提供助手绑定与消息入口。不同入口中的用户需要映射到对应身份，再按授权访问其工作空间。
管理用户用量与服务成本。围绕终端用户查询和管理积分使用量，将用量信息接入企业自己的管理后台，方便查看服务消耗、开展用户运营。用户套餐、积分规则和商业服务流程由企业定义，结合 Forward 的身份、用量及开放管理能力实现。
从开源示例开始：GitHub：QoderAI/forward-quickstart。Forward Quickstart 开源项目提供 Identity、Template、Session、Skills、文件、MCP 配置及 IM 渠道等基础示例，可作为搭建自有应用的起点。先跑通用户接入、模板配置和一次任务执行，再按上述需求接入实时语音、工作空间、业务技能、外部服务与管理后台。
持续演进，扩展业务场景
从一个可运行的示例开始，通过 QCA Forward 开箱即用的搭建与集成能力，将 Agent 接入自己的产品和工作流，让开发者专注于任务与业务本身。
QCA 通过稳定、易用的接口，让已有应用更容易用上模型和底层运行能力演进带来的新能力。我们也将持续完善资源连接、任务协作与评测观测，丰富生态，并及时分享产品进展、开源示例和开发者实践，帮助企业与个人开发者更快地从原型走向实际应用。
