name: soultrace
description: 通过 SoulTrace API 进行人格评估。当用户想要进行性格测试、发现心理原型、了解人格特质或获取基于颜色的人格画像时使用。该 API 采用五色心理模型（白色=结构、蓝色=理解、黑色=行动力、红色=强度、绿色=连接），通过贝叶斯自适应题目选择将用户分类为 25 种原型之一。触发条件：性格测试、人格评估、我的性格是什么、做个测验、原型测试、颜色人格、SoulTrace。

SoulTrace 人格评估

通过 soultrace API 进行自适应人格评估。回答 24 道采用 1-7 李克特量表的问题，根据五色心理模型获得您的人格原型。

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": "我在掌握复杂系统时获得深深的满足感。"
  },
  "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": "策略家",
    "alignmentScore": 87.3,
    "coreDynamic": "...",
    "strengths": ["..."],
    "weaknesses": ["..."]
  },
  "topMatches": [
    { "key": "blue-black", "name": "策略家", "alignmentScore": 87.3 },
    { "key": "blue", "name": "理性者", "alignmentScore": 82.1 },
    { "key": "black-blue", "name": "执行者", "alignmentScore": 78.5 }
  ],
  "shadowColors": [
    { "color": "red", "score": 0.10 },
    { "color": "green", "score": 0.15 }
  ],
  "progress": { "answered": 24, "total": 24 }
}

代理交互协议

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

1. 启动：通过 {"answers": []} 调用 API。
2. 呈现：清晰地向用户呈现每个问题。告知他们用 1-7 分回答（1=非常不同意，4=中立，7=非常同意）。
3. 收集：收集用户的数字答案（1-7）。如果给出非数字或描述性答案，则映射到量表：

• “strongly disagree” / “not at all” → 1
• “disagree” / “not really” → 2
• “slightly disagree” → 3
• “neutral” / “maybe” / “sometimes” → 4
• “slightly agree” → 5
• “agree” / “yes” → 6
• “strongly agree” / “absolutely” → 7

1. 累积：累积答案，每次发送所有之前的答案以及新答案。
2. 回答完所有 24 道题后，呈现结果，包括：

• 他们的原型名称和匹配度分数
• 他们的颜色分布（以百分比显示）
• 他们最匹配的前 3 个原型
• 完整结果页面的链接

1. 绝不可跳过问题或代表用户自动回答。

分数量表

五种颜色

速率限制

• 每个 IP 每小时 100 次请求
• 每次测试需要 25 次请求（1 次启动 + 24 次回答）
• 每小时最多约完成 4 次完整测试

错误处理

API 信息

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

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