跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

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) 数据来源标注"
    }
  ]
}

​
字段说明

字段类型必填说明
typestring是固定值 user.define_outcome
rubricstring是成功标准描述文本

​
典型用法

  1. 创建 Session 并发送初始消息
  2. 通过 user.define_outcome 告知 Agent 成功标准
  3. Agent 按照 Rubric 迭代工作
  4. 收到 session.status_idle 后检查输出
Rubric 应尽量具体、可衡量。避免模糊描述如”写得好一点”，改为”代码覆盖率不低于 80%“。

​
curl 示例

# 向已有 Session 发送 Outcome 定义
curl -X POST https://openapi.qoder.sh/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",
      "turn_id": "turn_019e4a1b2c3d4e5f6a7b8c9d0e1f2a3c",
      "schema_version": "1.0",
      "created_at": "2026-05-18T16:00:00.000Z",
      "processed_at": "2026-05-18T16:00:00.000Z"
    }
  ]
}

​
与普通消息的区别

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

​
最佳实践

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