soultrace

SoulTrace 人格评估

通过 soultrace API 参加自适应人格评估。按照 1–7 的李克特量表回答 24 个问题，即可根据五色心理模型获得你的人格原型。

API 端点

POST https://soultrace.app/api/agent

无需身份验证。每个 IP 每小时限 100 个请求。

工作原理

该 API 是无状态的。你需要在每次请求中传入截至目前的所有答案，服务端会重新执行贝叶斯推断，以选择下一个最合适的问题。

步骤 1：开始测试

发送一个空的答案数组，获取第一个问题：

curl -X POST https://soultrace.app/api/agent \
  -H "Content-Type: application/json" \
  -d '{"answers": []}'

响应：

{
  "status": "in_progress",
  "question": {
    "id": 42,
    "text": "I find deep satisfaction in mastering complex systems."
  },
  "currentDistribution": {
    "white": 0.2,
    "blue": 0.2,
    "black": 0.2,
    "red": 0.2,
    "green": 0.2
  },
  "entropy": 2.322,
  "progress": { "answered": 0, "total": 24 }
}

步骤 2：回答问题

用户按照 1–7 的量表回答每个问题：

• 1 = 非常不同意
• 4 = 中立
• 7 = 非常同意

追加答案，并发送截至目前的所有答案：

curl -X POST https://soultrace.app/api/agent \
  -H "Content-Type: application/json" \
  -d '{"answers": [{"questionId": 42, "score": 6}]}'

持续累积答案。每次响应都会给出下一个问题。

步骤 3：获取结果

回答 24 个问题后，响应会自动返回最终结果：

{
  "status": "complete",
  "resultId": "abc-123-def",
  "resultUrl": "https://soultrace.app/en/results/abc-123-def",
  "distribution": {
    "white": 0.15,
    "blue": 0.35,
    "black": 0.25,
    "red": 0.10,
    "green": 0.15
  },
  "entropy": 1.89,
  "archetype": {
    "key": "blue-black",
    "name": "Strategist",
    "alignmentScore": 87.3,
    "coreDynamic": "...",
    "strengths": ["..."],
    "weaknesses": ["..."]
  },
  "topMatches": [
    { "key": "blue-black", "name": "Strategist", "alignmentScore": 87.3 },
    { "key": "blue", "name": "Rationalist", "alignmentScore": 82.1 },
    { "key": "black-blue", "name": "Operator", "alignmentScore": 78.5 }
  ],
  "shadowColors": [
    { "color": "red", "score": 0.10 },
    { "color": "green", "score": 0.15 }
  ],
  "progress": { "answered": 24, "total": 24 }
}

Agent 交互协议

当用户要求进行人格测试时：

1. 开始：使用 {"answers": []} 调用 API。
2. 展示：清楚地向用户展示每个问题。告诉他们按照 1–7 作答（1=非常不同意，4=中立，7=非常同意）。
3. 收集：收集用户的数字答案（1–7）。如果用户给出非数字或描述性答案，请将其映射到量表：
   • “非常不同意”/“完全不” → 1
   • “不同意”/“不太” → 2
   • “略微不同意” → 3
   • “中立”/“也许”/“有时” → 4
   • “略微同意” → 5
   • “同意”/“是” → 6
   • “非常同意”/“完全同意” → 7
4. 累积：每次都发送所有之前的答案，以及新答案。
5. 回答完全部 24 个问题后，向用户展示结果，包括：
   • 人格原型名称和契合度分数
   • 颜色分布（以百分比显示）
   • 最匹配的 3 个人格原型
   • 完整结果页面的链接
6. 绝不跳过问题，也不得代替用户作答。

分数等级

分数	含义
1	非常不同意
2	不同意
3	略微不同意
4	中立
5	略微同意
6	同意
7	非常同意

五种颜色

颜色	驱动力	本质
White（白色）	结构、公平	秩序、责任
Blue（蓝色）	理解、精通	好奇心、精准
Black（黑色）	主导权、成就	雄心、策略
Red（红色）	强烈、表达	热情、诚实
Green（绿色）	联结、成长	归属感、耐心

速率限制

• 每个 IP 每小时 100 个请求
• 每次测试需要 25 个请求（1 次开始请求 + 24 次答题请求）
• 每小时最多约可完成 4 次测试

错误处理

状态	含义
400	请求正文或答案格式无效
429	超出速率限制（检查 Retry-After 标头）
500	服务器错误

API 信息

GET https://soultrace.app/api/agent

返回 API 元数据（版本、问题数量、分数范围）。