将 AI Agent 作为云服务，接入你的应用与工作流。
官网（国际站） · 官网（中国站） · 官方文档 · 快速开始 · Web 个人助手 Demo 源码 · SDK · Skills · MCP
Qoder Cloud Agents（QCA）是面向企业开发者的云端 Agent Harness 全托管平台，以 Agent as a Service 提供生产级运行时。开发者可通过 API 或 SDK 将 Agent 嵌入现有产品与业务系统，通过 Skill、MCP 连接企业数据与工具，也可接入 IM 提供服务。QCA 托管任务编排、工具执行、会话状态与弹性调度，支持多智能体协同、跨会话记忆、定时与批量任务，并提供身份隔离、凭证管理、工具权限控制及运行观测。企业专注业务目标与交付标准，QCA 承接底层运行与规模运维，让 Agent 从一次调用走向持续服务。
你可以用 QCA：
- 执行研发任务：将代码分析、重构或测试生成等任务交给云端 Agent，持续查看执行过程。
- 为应用接入 Agent：通过 API 或 SDK 创建会话、发送任务和接收事件，将执行结果接入自己的产品流程。
- 构建个人助手：为用户提供 Web 或 IM 助手，结合工具、文件与个人记忆，完成多轮对话和任务执行。
- 自动化日常工作：结合调度与业务系统，完成周期性检查、报告生成和批量处理。
一次典型的使用流程是：定义 Agent → 配置运行环境 → 创建会话 → 发送任务 → 获取进度与结果。Agent 描述“由谁来做、能用什么工具”，会话承载一次具体的任务执行。详见核心概念与工作流程。
本仓库是 Qoder Cloud Agents 的公开接入与使用内容入口，集中维护两套独立 Skills、MCP 发布元数据、统一接入文档和更新记录，并汇总 Demo 与 SDK 资源。QCA 服务运行在云端；Demo 和各语言 SDK 的源码在独立仓库维护。
| 内容 | 用途 | 入口 |
|---|---|---|
| Web 个人助手 Demo | 体验面向终端用户的助手交互，参考 Forward API 的端到端集成流程 | forward-quickstart |
| SDK | 使用 TypeScript / JavaScript、Python 或 Go 将 QCA 接入应用与后端服务 | SDK 选型与接入 |
| Skills | 指导 Agent 如何使用 QCA，包括工具选择、任务执行、进度查询和结果处理 | Skills |
| MCP | 让支持 MCP 的客户端连接 QCA 的远程工具服务 | MCP 接入 |
| 文档 | 说明服务地址、区域选择、鉴权与接入方式，并提供 HTTP API 使用参考 | 统一接入指南 |
| Changelog | 记录本仓库中 Skills 和接入内容的变化 | 更新记录 |
Skill 提供使用指导，MCP 提供可调用的工具。使用方按自己的客户端配置连接，也可以独立安装 Skill。
Forward Quickstart 是基于 QCA Forward API 的 Web 用户端个人助手 Demo，提供可运行的源码，便于体验产品能力或作为自建助手的集成参考。
- 完整交互流程：接入应用侧用户身份、配置 Agent 模板、创建会话、发送消息，并通过 SSE 实时展示执行进度与结果。
- 个人助手能力：展示文件附件、工具调用审批、实时语音、会话历史、个人记忆及定时任务等交互；具体可用能力取决于部署版本与配置。
- 前后端参考实现：使用 React + Vite 构建前端，Express 提供 API / SSE 代理与语音 WebSocket 中继，支持 Global 与 CN 环境。
本地启动、环境配置与生产集成注意事项见 Demo README。Demo 用于体验和集成参考，生产应用应在受信服务端管理平台凭证，并实现自己的用户鉴权与授权。
在支持远程 MCP 的客户端中添加 QCA 连接，选择所属区域的服务地址，使用 Streamable HTTP 传输，并配置 Authorization: Bearer <PAT> 请求头。连接参数与验证步骤统一见MCP 接入指南。配置文件格式、设置入口和凭证存储方式由所用客户端决定。
连接成功后，可以先执行只读操作：
使用 Qoder Cloud Agents，列出我当前的云端 Agents。
配合本仓库的 Skill，客户端可以按 QCA 工作流程选择工具、执行任务并获取结果。
如果客户端支持 Skills，也可以直接安装独立 Skill。将选定的整个目录放入客户端支持的 Skills 位置，保留其中的引用文档和示例：
独立 Skill 优先使用已安装的对应区域 QCA MCP 工具，并通过 PAT 鉴权；没有对应 MCP，或你明确要求使用 HTTP 时，则按 Skill 中的说明使用 HTTP API，支持 PAT 或 Service Account Token（SAT）。HTTP 凭证需要单独配置，客户端的 MCP 凭证设置不会自动传给 HTTP 调用。
如果你要将 QCA 集成到自己的应用、后端服务或自动化流程，可以选择对应语言的 SDK，也可以直接调用 HTTP API，通过 PAT 或 SAT 鉴权。三种 SDK 均提供 Forward 与 Managed API 客户端。
| 语言 | SDK 源码 | 主要特性 |
|---|---|---|
| TypeScript / JavaScript | qoder-cloud-agents-sdk-ts | 类型化 API 访问，支持 CommonJS 与 ES modules，无第三方运行时依赖 |
| Python | qoder-cloud-agents-sdk-python | 同步与异步客户端、类型化请求与响应、自动分页、SSE 流式事件及文件传输 |
| Go | qoder-cloud-agents-sdk-go | 类型化请求参数、Context 取消、流式事件及逐请求配置 |
当前 SDK 为预发布版本，API 可能调整；安装方式、运行环境要求与示例以各 SDK 仓库的 README 为准。应用集成时请在受信服务端使用 SDK 和平台凭证，不要将 PAT、SAT 或其他密钥嵌入浏览器代码。
从官方快速开始了解如何创建 Agent、配置环境并运行第一个会话；本仓库还提供 HTTP API 参考和 curl 调用示例。区域地址与凭证配置见统一接入指南。
产品官网分为国际站（Global）与中国站（CN）。Demo、SDK 与客户端接入时，均应选择与账号及凭证匹配的服务区域。
本仓库统一使用以下命名：
qoder-cloud-agents：默认版本，连接 Global 服务。qoder-cloud-agents-cn：CN 版本，连接 CN 服务。
请根据自己的账号所属服务区域选择版本，并使用同一区域的凭证。中文文档不代表 CN 服务；使用中文客户端也不影响区域选择。Skill 不会在调用失败时自动切换区域。
cloud-agents/
├── skills/ 可独立安装的 Skills
│ ├── qoder-cloud-agents/ Global Skill、API 参考与调用示例
│ └── qoder-cloud-agents-cn/ CN Skill、API 参考与调用示例
├── mcp/ 远程 MCP 接入说明与 Registry 元数据
│ ├── README.md 统一接入指南
│ ├── qoder-cloud-agents/ Global server.json
│ └── qoder-cloud-agents-cn/ CN server.json
├── CHANGELOG.md 本仓库更新记录
└── CONTRIBUTING.md 内容贡献与维护说明
每个区域的 Skill 只维护一份，安装时保留整个 Skill 目录及引用文件。MCP 连接、鉴权和验证说明集中在 mcp/README.md。
- QCA 官方文档：产品概念、使用指南与 API 文档。
- 快速开始：运行第一个云端任务。
- 更新记录：查看本仓库的内容变化。
- GitHub Issues：反馈 Skill、MCP 接入或仓库文档的问题。
- 贡献说明：了解如何改进本仓库的公开内容。