soultrace

SoulTrace 人格評估

透過 soultrace API 進行適應性人格評估。回答 24 題 1-7 分的 Likert 量表題目，根據五色心理模型獲得您的人格原型。

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）。如果他們給出非數字或描述性答案，請對應到量表：
   • "非常不同意" / "完全不" → 1
   • "不同意" / "不太" → 2
   • "稍微不同意" → 3
   • "中立" / "也許" / "有時候" → 4
   • "稍微同意" → 5
   • "同意" / "是" → 6
   • "非常同意" / "絕對" → 7
4. 累積：每次傳送所有先前的答案加上新答案。
5. 完成所有 24 題後，呈現結果，包含：
   • 他們的原型名稱與符合度分數
   • 他們的色彩分佈（以百分比顯示）
   • 他們的前三名原型符合
   • 完整結果頁面的連結
6. 切勿跳過問題或代替使用者自動回答。

分數量表

分數	意義
1	非常不同意
2	不同意
3	稍微不同意
4	中立
5	稍微同意
6	同意
7	非常同意

五種顏色

顏色	驅動力	本質
白色	結構、公平	秩序、責任
藍色	理解、精通	好奇心、精確
黑色	主導、成就	野心、策略
紅色	強度、表達	熱情、誠實
綠色	連結、成長	歸屬感、耐心

速率限制

• 每個 IP 每小時 100 次請求
• 每次測驗需要 25 次請求（1 次開始 + 24 次回答）
• 每小時最多約 4 次完整測驗

錯誤處理

狀態碼	意義
400	請求主體或答案格式無效
429	超過速率限制（檢查 Retry-After 標頭）
500	伺服器錯誤

API 資訊

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

回傳 API 元資料（版本、題目數量、分數範圍）。