让数字员工，进入你的业务系统。

CHOOSE YOUR PATH

从你要完成的事情开始

开发接口与产品操作说明都保留在同一中心，但不需要从头阅读。选择当前目标即可进入对应章节。

账户与 API Key

个人资料、安全设置和第三方登录属于账户功能。只有通过程序调用数字员工时才需要 API Key，普通工作台对话不需要创建密钥。登录后进入“开发与集成 → API 凭证”创建、设置权限、查看使用次数或撤销密钥。

复制Authorization: Bearer cbk_your_api_key

工作台与创建

工作台用于创建数字员工、选择当前员工，并通过真实对话验证效果。建议先完成名称、头像和模型设置，再逐步增加人格、Skill、知识库与工具，方便判断每次修改带来的变化。

1. 1点击“新建员工”，填写名称和用途。
2. 2在基本设置选择当前模型并保存。
3. 3发送几条典型任务，确认基础回答正常。
4. 4再加入人格、知识和能力，逐项测试。

后台任务与任务中心

数字员工任务由服务器保存并交给 Worker 执行，不依赖当前浏览器页面持续打开。发送任务后可以切换员工、进入其他页面或关闭浏览器；任务不会因为离开聊天页而中断，完成结果仍归属原员工和原会话。

1. 1发送任务后确认聊天中出现排队或执行状态。
2. 2需要离开时直接切换页面，无需保持标签页前台运行。
3. 3从“任务中心”按员工或任务 ID 找回进度。
4. 4完成后回到原员工会话查看回答，或在“工作成果”下载文件。

打开任务中心 →

定时任务

定时任务用于让数字员工在指定时间自动工作。调度由主站 API 持续触发，实际任务进入与普通对话相同的 Worker 队列，因此不需要浏览器保持打开。入口位于会员中心侧栏“知识库”之后的“定时任务”。

打开定时任务 →

聊天附件

在员工工作室中可以把文件直接拖入聊天框、粘贴剪贴板文件，或点击附件按钮选择文件。附件先上传到对象存储，再以受控引用交给当前任务；文件正文不会直接塞入 PostgreSQL，也不会自动写入长期记忆或知识库。

数字员工中枢

数字员工中枢用于管理员工在正式人格与 Skill 之外逐步掌握的内容，包括长期记忆、个人偏好、工作规则、学习建议和 Skill 版本草稿。进入“控制台 → 数字员工 → 数字员工中枢”，或在对话保存成功后的学习提示中点击“查看中枢”。

从对话中让员工记住

1. 1在正式工作台使用明确表达，例如“你要记住：回复客户前先确认订单号”或“记一下：周报先写风险”。
2. 2发送后查看聊天区提示。只有出现“已记住”绿色回执，才表示内容已经写入中枢；普通模型回答不代表保存成功。
3. 3点击回执中的“查看中枢”，在“记忆与偏好”确认内容、类型和生效范围。
4. 4开启一个新对话，用相同业务场景验证员工是否按已确认内容执行。

学习模式

生效范围与权限

打开数字员工中枢 →

数字员工中枢规则与生命周期

本页是数字员工中枢的行为契约。它说明哪些内容可以被记住、谁可以修改、什么时候会进入任务上下文，以及员工发布后如何保持稳定。产品界面、工作台、API 和后台服务都应遵守这些规则。

一、记忆分层

二、写入与回执

1. 1只有“请记住”“记一下”“以后都……”等明确表达，才会触发直接记忆写入；普通纠正默认只作为上下文。
2. 2系统先做权限、敏感信息和重复内容检查。密码、Token、API Key、私钥、数据库连接串和完整凭据禁止写入。
3. 3写入成功必须在对话区显示“已写入员工中枢”回执，并标出记忆类型、范围和摘要；没有回执就不能视为保存成功。
4. 4相同规则再次写入应更新原记录或增加版本，不应无限生成重复记忆。暂停、删除和过期内容不得继续注入任务。

三、学习模式与 Skill 生命周期

四、所有权、试用与购买权限

五、知识库、连接与调用

知识库由发布者维护并绑定到员工。使用者只获得授权后的检索能力，不直接看到知识库原文。数据库、HTTP、邮件、日历和其他外部连接属于实际使用者的连接配置，发布者不能读取使用者密钥或业务数据。每次任务加载记忆前，都必须同时检查记忆状态、范围、过期时间、员工授权和当前版本。

六、API 契约与部分可用

七、多语言表达

记忆触发与规则说明支持简体中文、繁体中文、英语和日语。语言变化不改变权限和安全边界。

八、故障排查

打开数字员工中枢 →

人格设置

人格决定数字员工如何理解身份、目标、语气和行为边界。名称是正式身份，人格是执行规则；不要只把员工名称重复写进提示词。

Skill 编辑器

Skill 是可复用的任务说明，适合固定流程，例如整理会议纪要、检查合同字段或生成周报。写清触发条件、处理步骤、输出格式和异常处理，比堆叠背景介绍更有效。

知识库

知识库用于保存产品手册、制度、FAQ 等固定资料。文档导入后会经过解析和索引；只有绑定到当前员工的知识库才会参与检索。

能力与连接

能力让数字员工在需要时执行搜索、读取网页、查询数据库或调用外部系统。启用需要连接的工具时会打开配置弹窗；未启用的工具不会在运行时获得调用权限。

地图能力包

地图是数字员工可直接启用的平台能力，不需要新增后台管理页面。默认使用 OpenStreetMap、Nominatim、Overpass、OSRM 和时区公开服务，支持地点搜索、附近地点、地址解析、反向解析、路线、距离矩阵、时区和静态地图。公开服务不可用时，系统会返回清晰的失败原因，不会把密钥错误当作成功。

训练与评测

评测不是再次聊天，而是用一组固定用例重复检查当前版本。每条用例至少包括输入、期望结果或评分规则；运行评测集后再决定是否发布新版本。

版本管理

版本用于固定一次完整配置，包括模型、人格、Skill、知识库、能力和输出规则。发布或审核应引用明确版本，避免开发中的修改影响线上员工。

发布与访问

是否上架数字员工市场和是否开放 API 是两个独立选择。上架前填写类别、实习次数、聘用方式和使用说明并提交审核；审核中及已上架资料会锁定。

1. 1完成工作台测试和评测。
2. 2填写市场资料、实习次数和免费或周期价格。
3. 3提交审核，等待管理员通过或查看拒绝理由。
4. 4需要改价或修改公开资料时先下架，再重新提交审核。

输出设置

输出设置决定调用方可以收到什么，而不只是一段文字。可选择自然对话、结构化数据、报告与文件或混合输出，并设置字段、下载格式与使用权限。

数字员工市场

数字员工市场用于发现经过审核的公开员工。可以按名称、岗位类别、热门程度和排行筛选，并在员工档案中查看开发者、员工证、版本、能力说明、实习额度、聘用价格和授权状态。

实习与已聘员工

实习不会把发布者的内部配置复制给你。实习中的员工和已聘员工会显示剩余次数、授权周期、到期时间和员工证；使用入口位于“我的员工”和“员工工作室”。

员工资产与任务成果

“我的员工”集中展示自有、实习中和已聘用的数字员工；“工作成果”集中展示运行生成的文件、表格、图片和图表。员工授权与成果文件是两类数据：授权决定能否继续运行，成果则受文件保留和资源库容量规则管理。

会员、订阅与赠送算力

会员用于控制数字员工数量、并发任务、定时任务、API 请求频率、最长任务时间、记录保留和队列优先级。会员价格与权益由平台当前配置决定，前台同时显示美元参考价与按固定汇率换算的港币实际付款金额。

打开会员中心 →

充值、消费与员工收入

充值中心用于购买普通算力并查看支付订单；消费记录按模型、工具、联网、知识检索和资源用量等真实项目归类；员工收益中心仅面向发布了收费数字员工的开发者。

资源库、容量与结算规则

资源库用于保存数字员工可调用的轻量文件、模板、成果和加密连接引用，不是无限网盘。文件内容与员工输出默认存放在对象存储，网页服务器只保存元数据和临时任务状态；每个账户默认总容量为 1024 MB。

容量与文件限制

客户侧费用规则

资源费用统一按 1 USD = 1,000 算力点结算，实际扣费以资源库每日结算记录为准。

每日结算与欠费

1. 1系统按前一自然日汇总账户存储和实际下载流量，每天自动生成一条结算记录；GET、PUT、DELETE、List 仍保留在诊断明细中。
2. 2先计算“应扣算力”，再从账户余额扣除“实际扣除算力”；余额不足时只扣现有余额，剩余部分记录为“未结算”。
3. 3后续充值或余额恢复后，系统按最早日期优先补扣欠费，并在资源库账单和后台“系统结算记录”中保留明细。
4. 4管理员可以按日期、账户和状态查看应扣、实扣、未结、存储容量、请求量、下载流量和费用明细。

调用与计费边界

员工读取知识库、企业资源或绑定文件时会记录读取事件；上传成果、删除文件、更新属性和列举目录会记录写入事件，但这些请求不向客户收费；向用户浏览器或外部系统传输文件时才记录下载外网流量并计费。

打开资源库 →

DIGITAL EMPLOYEE API

接口概览

API 面向需要把已授权数字员工接入网站、企业 OA、CRM 或自动化流程的开发者。调用前需要账户 API Key、员工证中的 Agent ID，且目标员工必须已经发布、运行正常并允许 API 访问。

最小接入清单

1. 1在“开发与集成 → API 凭证”创建 API Key，至少勾选 agent:run 和 run:read。
2. 2确认员工已发布并开启 API 输出；聘用他人员工时还需授权仍在有效期内。
3. 3使用 POST /v1/agents/{agentId}/responses 创建异步任务，并保存返回的 Run ID。
4. 4通过状态接口、SSE 或签名 Webhook 接收结果；文件下载还需 artifact:read 权限。

会员运行限制

会员页面中的 API 每分钟请求、最长任务、记录保留和队列优先级均已接入真实运行链路，不是展示字段。API 请求额度按调用时的有效会员等级执行；任务创建时会保存任务时长、记录保留和队列优先级快照，排队期间套餐变化不会改动已创建任务。

/v1/agents/{agentId}/responses

创建异步数字员工任务。平台按费率收取员工基础费、单次最低费用，并叠加模型 Token、工具、联网、知识检索和容器等实际资源用量。发布者获得员工订阅收入，不参与单次运行费用分成。

复制curl https://ai.cbapi.ai/v1/agents/AGENT_ID/responses \
  -H "Authorization: Bearer cbk_your_api_key" \
  -H "Idempotency-Key: order-20260813-001" \
  -H "Content-Type: application/json" \
  -d '{"input":"生成本月销售摘要和 CSV 文件","model":"developer-recommended-model","variables":{"department":"销售部"},"webhookEndpointId":"webhook_uuid"}'

请求字段

202 响应

复制{"id":"run_uuid","object":"agent.run","status":"queued","replayed":false}

/v1/runs/{runId}

读取任务状态、输出、用量和交付次数。任务在服务器端持续执行，与调用方页面是否打开无关；调用方应先判断 status，再处理 output.response.content。

复制{
  "status": "succeeded",
  "output": {
    "text": "本月销售额增长 18%。",
    "response": {
      "schemaVersion": "1.0",
      "content": [
        {"type":"markdown","text":"本月销售额增长 18%。"},
        {"type":"json","value":{"growth":18}},
        {"type":"file","name":"sales.csv","downloadUrl":"/api/agent-artifacts/.../download"}
      ],
      "validation": {"status":"valid"}
    }
  }
  }

事件流与 Webhook

短任务可轮询状态；需要实时进度时使用 SSE；企业系统需要可靠异步交付时，在“开发与集成 → API 凭证”创建 Webhook，并在创建任务时传入端点 ID。

验证签名

复制const signed = `${timestamp}.${rawRequestBody}`;
const expected = hmacSha256(webhookSecret, signed);
// 与 Cloudbridge-Signature 中的 v1=... 做恒定时间比较

同时检查 Cloudbridge-Timestamp 与当前时间差，建议超过 5 分钟拒绝，以降低重放风险。

请求追踪与故障排查

排查接口问题时，最重要的是保留任务标识和原始响应，而不是反复创建新任务。创建成功后以 Run ID 为主线，可以在状态接口、事件流、Webhook 投递记录和控制台任务中心交叉核对。

1. 1记录请求时间、环境、API Key 前缀、Agent ID、Idempotency-Key 和响应状态码；不要记录完整密钥。
2. 2创建成功后保存 Run ID。即使页面关闭或网络断开，Run ID 仍可用于查询服务器端任务。
3. 3在任务中心搜索 Run ID，核对数字员工、任务来源、实际模型、执行状态、费用和失败原因。
4. 4Webhook 未到达时，在 API 凭证页面检查端点是否启用、最近状态、重试次数和错误；同时确认公网 HTTPS 地址可访问。
5. 5联系支持时提供 Run ID、发生时间和错误码。密钥、Webhook Secret、数据库密码和第三方 Token 不应通过工单发送。

打开 API 参考 →

错误处理