自主工作

​

打开自主工作

​

创建前检查

• 执行对象： Waker 已启用且能够正常对话；使用 WakerFlow 时，流程已至少手动成功运行一次，人工确认节点和输出符合预期。
• 模型： Waker 使用的模型当前可用。需要稳定复现结果时选择明确模型；希望跟随系统推荐时使用 Auto。
• 工作空间： Waker 能访问所需目录或项目。使用本地目录时，对应设备、QoderWake 和目录在触发时都必须可用。
• 能力与权限： 任务依赖的 Skill、连接器、网络和外部账号已在普通对话中验证，不要把正式自动任务当作首次授权测试。
• 任务边界： 仍需反复讨论目标的工作先在普通对话中完成；包含多阶段分工、固定审批或人工确认的工作优先使用 WakerFlow。

​

选择触发方式

​

创建自动任务

1. 点击「新建自动任务」。
2. 填写名称。建议采用“对象 + 动作 + 频率或来源”，例如“官网每日界面巡检”或“新 Issue 分类处理”。
3. 添加触发条件。一个任务最多可以添加 5 个触发方式，页面会显示已添加数量。
4. 选择执行方式：
   • 交给 Waker： 适合单一职责、输入输出稳定的任务。
   • 运行 WakerFlow： 适合多阶段、并行处理、固定分工或结构化输入。
5. 选择具体执行对象，确认该 Waker 或 WakerFlow 已启用并在当前环境可用。
6. 响应方式为 Waker 时，选择 Auto 或一个明确模型。模型不可用或被移除后，应重新编辑并测试任务。
7. 填写任务描述。写清每次触发都要执行的固定目标、输入范围、输出和禁止事项，不要把只适用于一次运行的数据写死。
8. 选择工作空间：默认工作空间、本地目录或项目。使用本地目录时，对应设备在触发时必须在线。
9. 展开「高级设置」，配置最大运行次数和截止日期。
10. 保存后先手动运行一次，验证成功再保留正式触发。

目标：每次触发要完成什么。
输入：允许读取的数据、时间范围和对象。
处理规则：必须执行的步骤、判断条件和异常处理。
输出：返回格式、文件名称、保存位置或外部动作。
完成标准：如何判断业务结果正确，而不只是运行状态为“已完成”。
禁止操作：不得修改、删除、发布或发送的内容。

​

配置定时触发

1. 选择「定时」。
2. 选择周期运行或一次性运行，并设置日期、时间和重复规则。
3. 检查页面显示的下一次运行时间，确认时区与业务时区一致。
4. 首次验证时把时间设为几分钟后；运行成功后再改为正式周期。

• 任务被暂停、达到最大运行次数或超过截止日期后，不再自动触发。
• 本地 Waker 或本地目录在计划时间不可用时，任务可能启动失败。
• 高频任务要确认上一次运行能在下一次触发前结束，避免并发覆盖同一产物。

​

配置事件触发

1. 选择「事件」。
2. 选择事件来源并完成授权。
3. 选择关联仓库或对象，再选择 Issue、Pull Request 等事件类型。
4. 按事件来源提供的选项配置变化类型和过滤条件，例如新建、编辑、仓库、分支、标签或对象范围。不同来源显示的字段可能不同。
5. 保存后在外部系统制造一条安全的测试事件。
6. 回到任务详情查看「事件活动」或运行记录，先确认事件已被接收，再确认只启动了预期任务。

​

配置定时拉取（页面提供时）

1. 选择来源并完成授权。
2. 选择对象范围、筛选条件和拉取频率。
3. 明确首次运行从何时或哪个游标开始，避免一次处理全部历史数据。
4. 配置稳定的对象 ID 或更新时间作为去重依据。
5. 使用测试对象验证“发现变化 → 创建任务 → 更新游标”的完整链路。

​

配置 API 触发

​

创建个人访问令牌

1. 登录 Qoder 控制台，打开头像或用户菜单。
2. 进入「个人设置」→「服务集成」。
3. 创建个人访问令牌，并使用能够识别调用方和环境的名称，例如“工单系统-生产环境”。
4. 创建后立即复制令牌。令牌通常只完整显示一次，应保存到调用系统的凭据管理或 CI Secret 中。
5. 先用测试环境完成调用验证，再为正式环境单独创建令牌。轮换令牌后，确认新令牌生效再撤销旧令牌。

​

创建任务并取得调用地址

1. 新建自动任务并添加「API」触发方式。
2. 选择 Waker 或 WakerFlow，填写任务描述，配置工作空间和运行限制。
3. 保存任务。在任务详情中复制系统生成的 POST 地址、认证方式和请求示例。
4. 将完整调用地址与 PAT 一样作为敏感凭据保存，不要手工拼接，也不要放入公开日志或截图。

​

设计任务描述和请求体

处理工单 {{ticket.id}}。
优先级：{{ticket.severity}}
问题：{{ticket.summary}}
输出：给出原因、处理建议和需要人工确认的风险。

curl -X POST 'https://api.qoder.com/v1/qoderwake/automation/invoke/<GENERATED_INVOKE_KEY>' \
  --header 'Authorization: Bearer <YOUR_PAT>' \
  --header 'Content-Type: application/json' \
  --data '{
    "wakeSessionUniqueId": "ticket-1001",
    "ticket": {
      "id": "1001",
      "severity": "high",
      "summary": "支付回调持续超时"
    }
  }'

• 使用 {{field}} 读取顶层字段，使用 {{ticket.id}} 读取嵌套字段，也可以用 {{items[0].name}} 读取数组元素。
• 字段名区分大小写；找不到字段时，占位符会保留在任务描述中，便于定位字段路径错误。
• 字符串直接写入；对象、数组、数字、布尔值和 null 会转换成 JSON 文本。
• 如果任务描述没有占位符，固定任务描述仍会保留，完整请求体会作为本次输入附加给执行对象。

​

一次性调用与连续聊天

• 相同用户、自动任务和 wakeSessionUniqueId 的请求会沿用同一聊天，并按顺序处理。
• 不传该字段或更换该值，会开始新的聊天。
• 该字段用于延续上下文，不是防止重复提交的幂等键。调用方仍需自行设计重试和去重机制。
• 不同客户、项目、数据权限或安全范围必须使用不同的值，避免上下文串联。

​

验证调用结果

1. 使用不含敏感数据的小范围请求进行首次调用。
2. 检查 HTTP 响应。请求被接受只表示已经进入执行流程，不表示业务任务已经完成。
3. 回到「自主工作」的运行记录，确认触发来源为 API，并核对输入、执行对象、工作空间和当前状态。
4. 等待运行结束，检查最终回复、生成文件和外部系统中的实际结果。
5. 验证无误后，再把完整地址和 PAT 配置到正式调用系统。

​

API 触发排错

​

选择 WakerFlow 作为执行方式

1. 选择已经手动验证成功的 WakerFlow。
2. 检查流程包含的阶段和人工确认节点；自动触发后仍可能在确认节点等待人工处理。
3. 为每个运行参数选择覆盖方式并填写值。固定值适合长期不变的配置；由触发数据提供的值要与字段类型一致。
4. 检查必填参数没有留空，输出字段仍能满足下游系统或业务验收。

​

配置工作空间

​

配置高级设置

• 最大运行次数： 选择无限制或自定义次数。达到上限后任务自动暂停，适合阶段性迁移或有限批次处理。
• 截止日期： 选择永不截止或指定日期。到达截止日期后不再触发，适合活动、版本或短期项目。

​

测试并上线

1. 使用「立即运行」验证执行对象、任务描述、工作空间和能力。
2. 使用真实触发方式做一次小范围验证：等待一次定时、制造一条测试事件或发送测试 API 请求。
3. 打开运行记录，核对触发来源、输入、当前节点、最终结果和实际产物。
4. 确认高风险动作仍会等待人工授权。
5. 清理测试数据，再启用正式计划或事件。

​

查看运行记录

​

编辑、暂停、复制和删除

• 编辑既有任务时，响应方式以及已选的 Waker 或 WakerFlow 会被锁定。需要更换执行对象时，使用「复制」创建新任务，验证成功后再暂停或删除旧任务。
• 修改触发方式、模型、工作空间、权限或连接器后，重新测试再恢复。
• 复制任务不会复制累计运行次数和运行历史。复制后检查名称、触发范围、项目、模型和令牌，不要让新旧任务重复处理同一事件。
• 暂停只阻止新的自动触发，不会停止已经运行中的任务。
• 并非所有事件触发任务都支持「立即运行」；应使用对应外部系统的安全测试事件验证。
• 删除前保存需要保留的运行记录和产物，并确认没有外部系统继续调用 API 地址。

​

常见问题