soultrace

SoulTrace 性格診断

soultrace API を通じて、適応型の性格診断を受けられます。1〜7のリッカート尺度で24問に回答すると、5色の心理モデルに基づく性格アーキタイプがわかります。

API エンドポイント

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

認証は不要です。IPアドレスごとに1時間あたり100リクエストまでに制限されています。

仕組み

API はステートレスです。リクエストごとに、それまでに蓄積したすべての回答を渡します。サーバーはベイズ推論を再実行し、次に出す最適な質問を選択します。

ステップ 1：テストを開始する

空の answers 配列を送信すると、最初の質問が取得できます。

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

エージェントとの対話プロトコル

ユーザーから性格診断を受けたいと依頼された場合：

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	強くそう思う

5色

色	原動力	本質
White	構造、公平さ	秩序、責任
Blue	理解、熟達	好奇心、正確さ
Black	主体性、達成	野心、戦略
Red	強烈さ、表現	情熱、誠実さ
Green	つながり、成長	帰属、忍耐

レート制限

• IPアドレスごとに1時間あたり100リクエスト
• 1回のテストにつき25リクエスト（開始1回＋回答24回）
• 1時間あたり完了できるテストは最大約4回

エラー処理

ステータス	意味
400	リクエスト本文または回答の形式が無効です
429	レート制限を超過しました（Retry-After ヘッダーを確認してください）
500	サーバーエラー

API 情報

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

API のメタデータ（バージョン、質問数、スコア範囲）を返します。