S
SkillsMD 发现、学习和掌握最新的 AI 技术 Skills。基于真实社区数据，为开发者提供最权威的 AI 工具导航。
关于 聚焦 AI 技术 Skills 每周数据更新 中英双语文档 © 2026 SkillsMD. All rights reserved.
SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试 | SkillsMD
首页 / Skills / soultrace SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试 soultrace by soultrace-ai/soultrace-skill
npx skills add https://github.com/soultrace-ai/soultrace-skill --skill 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": "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 = 强烈同意
附加答案并发送迄今为止的所有答案：
🇺🇸 English SoulTrace Personality Assessment
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.
API Endpoint
POST https://soultrace.app/api/agent
No authentication required. Rate limited to 100 requests/hour per IP.
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.
Step 1: Start the test
Send an empty answers array to get the first question:
curl -X POST https://soultrace.app/api/agent \
-H "Content-Type: application/json" \
-d '{"answers": []}'
Response:
{
"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
The user answers each question on a scale of 1-7:
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
联系我们 curl -X POST https://soultrace.app/api/agent \
-H "Content-Type: application/json" \
-d '{"answers": [{"questionId": 42, "score": 6}]}'
步骤 3：获取结果 {
"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 }
}
智能体交互协议
开始 ：使用 {"answers": []} 调用 API。呈现 ：向用户清晰地呈现每个问题。告知他们以 1-7 回答（1=强烈不同意，4=中立，7=强烈同意）。收集 ：收集用户的数字答案（1-7）。如果他们给出非数字或描述性答案，将其映射到量表：
* "强烈不同意" / "完全不" → 1
* "不同意" / "不太是" → 2
* "有点不同意" → 3
* "中立" / "可能" / "有时" → 4
* "有点同意" → 5
* "同意" / "是" → 6
* "强烈同意" / "绝对是" → 7累积 ：累积答案，并在每次发送时传递所有 之前的答案加上新的答案。完成所有 24 个问题后 ，呈现结果，包括：
* 他们的原型名称和匹配度分数
* 他们的颜色分布（以百分比显示）
* 他们匹配度最高的 3 个原型
* 指向他们完整结果页面的链接切勿跳过问题 或代表用户自动回答。
分数量表 分数 含义 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 元数据（版本、问题数量、分数范围）。
1 = Strongly Disagree4 = Neutral7 = Strongly Agree Append the answer and send all answers so far:
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.
Step 3: Get results After 24 answers, the response automatically returns the final result:
{
"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 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.
Score Scale Score Meaning 1 Strongly Disagree 2 Disagree 3 Slightly Disagree 4 Neutral 5 Slightly Agree 6 Agree 7 Strongly Agree
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
Error Handling Status Meaning 400 Invalid request body or answers format 429 Rate limit exceeded (check Retry-After header) 500 Server error
API Info GET https://soultrace.app/api/agent
Returns API metadata (version, question count, score range).
超能力技能使用指南：AI助手技能调用优先级与工作流程详解
47,800 周安装
