Skip to main content
快速开始

应用集成

按应用场景选择 SDK 运行形态与调用身份，完成基础接入，再按需配置业务能力。

通过 Qoder Agent SDK，可以在自有应用、内部工具或自动化服务中接收任务、调用业务工具并交付结果。SDK 能力与执行机制见概述和工作原理。

集成场景

根据你的需求，选择接入方式并进入对应操作说明：
你的需求接入方式操作入口
开发自有 Agent 应用，或为现有产品增加 Agent 能力在桌面应用、Web 后端或研发工具中集成 SDK确定调用身份、接入步骤
将 Agent 接入业务流程，自动执行任务由脚本、任务服务或流水线调用 SDK接入步骤、按需增加业务能力
统计用户消耗，或按权限、套餐及余额限制使用关联业务用量，按需增加任务启动前检查用量统计与任务准入
以上能力可按需组合，无需全部接入。

确定调用身份

个人调用

个人访问令牌（PAT）代表一个 Qoder 用户，适合使用该用户权限和数据的脚本、CI 或应用。开发工作站也可以复用本机 Qoder CLI 登录态；自动化服务应显式配置凭证。

组织应用

服务账号（Service Account，SA）是组织下的独立应用身份，适用于不应依赖个人账号的后端服务、CI 和定时任务。业务用户继续登录你的应用，无需分别创建 Qoder 账号；应用负责用户认证与任务授权。组织管理见成员和角色及服务账号。

根据部署位置管理 SA 凭证

  • 可信后端运行 SDK：后端保管 SA Key，直接传入 SDK，由 SDK 获取并刷新短期令牌 SAT。
  • 终端应用或集中提供凭证：可信服务端保管 SA Key，校验业务用户后换取 SAT，由宿主应用提供并刷新 SAT。SA Key 不放入分发给用户的客户端。
SA 调用示例：由可信服务端提供 SAT

开始以服务账号集成

按以下顺序完成配置，已有配置可复用。订阅、计费、服务账号和凭证须对应同一目标组织。

步骤 1：确认组织与订阅渠道

确认目标组织具有有效的 Teams 或 Enterprise 订阅，且通过云市场兑换码渠道创建。使用 SA 模式需满足使用前提；组织创建与采购见兑换码说明，版本与价格见计费说明。

步骤 2：购买并兑换 SA 专属 Credits

  1. 按购买与兑换说明，在阿里云国际站云市场购买服务账号专属 Credits 资源包。
  2. 由组织管理员进入 Organization Settings > Organization Usage > Redeem credits pack，兑换到目标组织，并确认余额可用。
专属 Credits 先购买、兑换，再按调用消耗扣减，不能使用席位 Credits 或组织共享资源包。兑换前核对目标组织与有效期。

步骤 3：创建服务账号与凭证

  1. 由组织管理员为应用创建服务账号，并按需设置专属 Credits 可用额度。
  2. 按 SA 认证的准备要求生成 SA Key，并保存在可信服务端的密钥管理工具中。

步骤 4：安装 SDK 并配置 SA 认证

选择 JavaScript/TypeScript（Node.js）、Python 或 Java SDK，按快速开始的安装说明安装。认证配置使用以下两种方式之一： 具体接口见 TypeScript 参考、Python 参考和 Java 参考，能力差异见 SDK 参考。

步骤 5：运行任务并核对用量

  1. 按快速开始运行首个任务，使用步骤 4 的 SA 认证配置，并指定工作区与工具权限。
  2. 收到最终结果后，按错误处理与错误码确认任务状态，并查看成本和用量。
  3. 在组织用量中核对 SA 消耗与专属 Credits 余额，按企业计费说明在云市场账号中核对订单与付款记录。
上线前验证权限、超时、取消和会话恢复。调用异常见问题排查；SA 调用失败时，检查组织渠道、专属 Credits 余额与账号额度，并核对认证配置。

按业务需要增加能力

以下能力可按需组合，配置细节见对应文档：
业务需求接入方式与文档
访问业务数据、调用内部系统自定义工具、MCP
提供业务职责、团队规范和工作方法系统提示词、Skills
拆分专门职责、统一分发扩展Subagents、Plugins
操作前审批、执行前后校验与审计权限控制、Hooks
跨实例恢复会话外置会话存储
复用历史经验、恢复文件状态记忆、文件快照与回滚
配置模型策略、检查代码安全模型选择、安全扫描
按用户或客户统计消耗保存用户、任务与会话的对应关系，读取成本和用量并在业务侧记账
根据权限、套餐或余额限制使用在应用侧检查业务权益，通过后启动任务，未通过则返回原因；Qoder 仍校验调用凭证与平台限额

常见问题

每位业务用户都需要 Qoder 账号吗？

使用 SA 集成时不需要。业务用户继续使用应用自己的账号，SA 代表应用访问 Qoder。用户登录、数据访问权限和任务授权仍由应用负责，见组织应用。

买了组织订阅，就可以直接使用 SA 调用吗？

还需确认组织符合使用前提，购买并兑换服务账号专属 Credits，确认余额可用后，再创建服务账号和凭证并配置 SDK。具体步骤见开始以服务账号集成。

任务启动前检查通过，后续模型调用就一定成功吗？

不一定。任务启动前的业务检查只决定是否启动任务；后续调用仍需满足凭证、专属 Credits 余额与账号额度要求。

保存了会话，就能在另一台机器继续任务吗？

还需保证项目文件可访问，并使用一致的项目目录语义。外置会话存储不会迁移工作区。

记录了用户消耗，平台就会按用户分别出账吗？

不会。平台仍按服务账号及所属组织记录消耗，应用自行关联业务用户并分摊记账；业务归属不会自动改变平台用量或资源包订单归属。