API 参考 / blueprints

读取当前方向集(三方向对比 2j)

GET /api/v1/orgs/{orgId}/blueprint-drafts/{draftId}/directions · getDirectionSet

返回草案的当前方向集(DirectionSet v{k}),含三个等权方向:稳健 / 差异化 / 探索。

- 探索方向恒带 highRiskVerification=true,永不呈现为推荐(设计稿 2j / 决议 7)。 - 每个分数维度挂引用的 Evidence IDs(100% 数据型结论引用证据,缺证据→定性或阻断)。 - 证据来自任务钉定的已发布 marketSnapshotId 的 approved Evidence(跨面契约 e4,只读)。 - 状态机(d2c):generated → under_review → selected;可 excluded(可撤销)。

仅 active Org Admin 可读;普通成员 404(零感知)。PAT 不可调用本端点。 尚无方向集(任务未完成)→ 404;任务处于 needs_review → 409 + needsReview=true 提示人工确认。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

orgId(必填)
string
draftId(必填)
string

响应字段 · 200

id(必填)
string
draftId(必填)
string
version(必填)
integer
status(必填)
enum;取值:generated / under_review / selected
marketSnapshotId
string
surveyVersionId
string
selectedDirectionId
string
needsReview
boolean
needsReviewReason
string
directions(必填)
CandidateDirection[] —— 三个等权方向(稳健 / 差异化 / 探索)。探索恒带 highRiskVerification=true。
directions[].id(必填)
string
directions[].type(必填)
enum —— solid=稳健(高适配低风险);differentiated=差异化(与稳健相似度低且独特);exploratory=探索(潜力高风险高 + 低成本验证)。探索方向永不呈现为推荐。;取值:solid / differentiated / exploratory
directions[].name(必填)
string
directions[].positioning(必填)
string
directions[].riskLevel(必填)
enum;取值:low / medium / high
directions[].highRiskVerification(必填)
boolean
directions[].excluded
boolean
directions[].selected
boolean
directions[].score(必填)
number
directions[].scoreBreakdown
ScoreBreakdownItem[]
directions[].scoreBreakdown[].dimension(必填)
string
directions[].scoreBreakdown[].score(必填)
number
directions[].scoreBreakdown[].reason
string
directions[].scoreBreakdown[].evidenceIds
string[]
directions[].risks
DirectionRisk[]
directions[].risks[].description(必填)
string
directions[].risks[].severity(必填)
enum;取值:low / medium / high
directions[].risks[].evidenceIds
string[]
directions[].coreLoop
string
directions[].visualRules
string
directions[].artBrief
string
directions[].evidenceRefs
string[]
directions[].numericClaims
NumericClaim[]
directions[].numericClaims[].claim(必填)
string
directions[].numericClaims[].evidenceIds(必填)
string[]
createdAt(必填)
string
updatedAt
string

错误

请求示例(curl)

curl -X GET "https://workflow.games/api/v1/orgs/{orgId}/blueprint-drafts/{draftId}/directions" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "id": "018f3c2e-0000-7000-8000-000000000000",
  "draftId": "018f3c2e-0000-7000-8000-000000000000",
  "version": 1,
  "status": "generated",
  "directions": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "type": "solid",
      "name": "示例标题",
      "positioning": "示例文本",
      "riskLevel": "low",
      "highRiskVerification": true,
      "score": 1
    }
  ],
  "createdAt": "示例文本"
}

合同真值:OpenAPI 3.1(0.1.0)。

相关:Agent 接入指南 · 使用指南 · API 参考索引

Workflow 正在加载…