任务结果-Qoder CN 系列(Lingma)-阿里云帮助中心

Outcomes 机制允许你为 Agent 定义明确的成功标准（Rubric），Agent 会参照 Rubric 内容迭代工作，直至满足预期结果。

核心概念

术语	说明
Outcome	一次任务的预期最终结果描述
Rubric	成功标准文本，Agent 据此判断自身输出是否达标

当你需要 Agent 按特定质量标准完成一项任务时，通过 user.define_outcome 事件将 Rubric 发送给 Session，Agent 会在后续处理中持续参考该标准。

事件格式

{
  "events": [
    {
      "type": "user.define_outcome",
      "rubric": "生成的报告必须包含：1) 执行摘要不超过 200 字 2) 至少 3 条可执行建议 3) 数据来源标注"
    }
  ]
}

字段说明

字段	类型	必填	说明
type	string	是	固定值 `user.define_outcome`
rubric	string	是	成功标准描述文本

典型用法

创建 Session 并发送初始消息
通过 user.define_outcome 告知 Agent 成功标准
Agent 按照 Rubric 迭代工作
收到 session.status_idle 后检查输出

Rubric 应尽量具体、可衡量。避免模糊描述如”写得好一点”，改为”代码覆盖率不低于 80%“。

curl 示例

# 向已有 Session 发送 Outcome 定义
curl -X POST https://api.qoder.com.cn/api/v1/cloud/sessions/sess_019e392c0d1e74e095d21ea4c6b41def/events \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      {
        "type": "user.define_outcome",
        "rubric": "重构后的函数：1) 单元测试全部通过 2) 圈复杂度 ≤ 10 3) 无 lint 警告"
      }
    ]
  }'

成功响应 (202 Accepted)

{
  "data": [
    {
      "id": "evt_019e4a1b2c3d4e5f6a7b8c9d0e1f2a3b",
      "type": "user.define_outcome",
      "rubric": "重构后的函数：1) 单元测试全部通过 2) 圈复杂度 ≤ 10 3) 无 lint 警告",
      "session_id": "sess_019e392c0d1e74e095d21ea4c6b41def",
      "schema_version": "1.0",
      "created_at": "2026-05-18T16:00:00.000Z",
      "processed_at": "2026-05-18T16:00:00.000Z"
    }
  ]
}

与普通消息的区别

维度	user.message	user.define_outcome
用途	发送对话消息	定义成功标准
触发行为	Agent 回复消息	Agent 按标准迭代工作
关键字段	content	rubric
发送时机	任意时刻	通常在任务开始前或初始消息后

最佳实践

在发送任务指令（user.message）前或同时发送 Outcome
Rubric 使用编号列表，便于 Agent 逐项检查
对于复杂任务，拆分为多个可测量的验收条件
Rubric 长度建议控制在 500 字以内