soultrace

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SoulTrace Personality Assessment

SoulTrace 人格测评

Take an adaptive personality assessment through the SoulTrace API. Answer 24 questions on a 1-7 Likert scale and receive your personality archetype based on a 5-color psychological model.

通过SoulTrace API完成自适应人格测评。回答24道1-7李克特量表的问题，即可获得基于五色心理模型生成的你的人格原型。

API Endpoint

API 端点

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

No authentication required. Rate limited to 100 requests/hour per IP.

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

无需身份验证，单IP限速为每小时100次请求。

How It Works

工作原理

The API is stateless. You pass all accumulated answers with every request, and the server replays the Bayesian inference to select the next optimal question.

该API是stateless的。每次请求你都需要传入所有已提交的答案，服务端会重新执行贝叶斯推理来选择下一个最优问题。

Step 1: Start the test

步骤1：启动测试

Send an empty answers array to get the first question:

bash

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

Response:

json

{
  "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 }
}

发送空的answers数组来获取第一道题：

bash

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

返回结果：

json

{
  "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 }
}

Step 2: Answer questions

步骤2：回答问题

The user answers each question on a scale of 1-7:

1 = Strongly Disagree
4 = Neutral
7 = Strongly Agree

Append the answer and send all answers so far:

bash

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

Keep accumulating answers. Each response gives the next question.

用户按照1-7的量表回答每道题：

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

追加答案并发送当前所有已提交的答案：

bash

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

持续累积答案，每次返回结果都会给出下一道题。

Step 3: Get results

步骤3：获取结果

After 24 answers, the response automatically returns the final result:

json

{
  "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 }
}

回答完24道题后，返回结果会自动给出最终测评结果：

json

{
  "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 Interaction Protocol

Agent 交互协议

When a user asks to take the personality test:

Start by calling the API with
```
{"answers": []}
```
.
Present each question to the user clearly. Tell them to answer 1-7 (1=Strongly Disagree, 4=Neutral, 7=Strongly Agree).
Collect the user's numeric answer (1-7). If they give a non-numeric or descriptive answer, map it to the scale:
- "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
Accumulate answers and send ALL previous answers plus the new one each time.
After all 24 questions, present the results with:
- Their archetype name and alignment score
- Their color distribution (show as percentages)
- Their top 3 archetype matches
- The link to their full results page
Never skip questions or auto-answer on behalf of the user.

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

启动测试：调用API并传入
```
{"answers": []}
```
。
展示问题：清晰地将每道题展示给用户，告知用户按照1-7的分值作答（1=非常不同意，4=中立，7=非常同意）。
收集答案：收集用户的数字答案（1-7）。如果用户给出非数字或描述性答案，按照如下规则映射到对应分值：
- "非常不同意" / "完全不认可" → 1
- "不同意" / "不太认可" → 2
- "略微不同意" → 3
- "中立" / "不确定" / "有时是" → 4
- "略微同意" → 5
- "同意" / "是的" → 6
- "非常同意" / "完全认可" → 7
累积答案：每次请求都要发送所有历史答案加上新提交的答案。
展示结果：24道题全部答完后，向用户展示如下结果：
- 人格原型名称和匹配度分数
- 五色分布（以百分比展示）
- 匹配度最高的3种人格原型
- 完整结果页面的链接
禁止跳过问题或代用户自动作答。

Score Scale

分值量表

Score	Meaning
1	Strongly Disagree
2	Disagree
3	Slightly Disagree
4	Neutral
5	Slightly Agree
6	Agree
7	Strongly Agree

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

The 5 Colors

五色含义

Color	Drive	Essence
White	Structure, fairness	Order, responsibility
Blue	Understanding, mastery	Curiosity, precision
Black	Agency, achievement	Ambition, strategy
Red	Intensity, expression	Passion, honesty
Green	Connection, growth	Belonging, patience

颜色	核心驱动力	本质
白色	结构性、公平	秩序、责任感
蓝色	理解力、掌控力	好奇心、精准性
黑色	自主性、成就感	野心、策略性
红色	强烈度、表达欲	热情、坦诚
绿色	联结性、成长性	归属感、耐心

Rate Limits

速率限制

100 requests per hour per IP
Each test requires 25 requests (1 start + 24 answers)
Maximum ~4 complete tests per hour

单IP每小时最多100次请求
每次完整测试需要25次请求（1次启动 + 24次提交答案）
每小时最多可完成约4次完整测试

Error Handling

错误处理

Status	Meaning
400	Invalid request body or answers format
429	Rate limit exceeded (check `Retry-After` header)
500	Server error

状态码	含义
400	请求体或答案格式无效
429	超出速率限制（查看 `Retry-After` 请求头）
500	服务端错误

API Info

API 信息

bash

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

Returns API metadata (version, question count, score range).

bash

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

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