soultrace-ai/soultrace-skill

SoulTrace パーソナリティ評価

soultrace APIを通じて適応型パーソナリティ評価を受けましょう。24の質問に1～7のリッカート尺度で回答し、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": "複雑なシステムを習得することに深い満足感を覚える。"
  },
  "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色の色

色	原動力	本質
白	構造、公平性	秩序、責任感
青	理解、習得	好奇心、正確さ
黒	主体性、達成	野心、戦略
赤	強烈さ、表現	情熱、誠実さ
緑	つながり、成長	帰属意識、忍耐

レート制限

• IPあたり1時間に100リクエスト
• 各テストには25リクエスト（開始1 + 回答24）が必要
• 1時間あたり最大約4回の完全なテスト

エラーハンドリング

ステータス	意味
400	リクエストボディまたはanswers形式が無効
429	レート制限超過（Retry-After ヘッダーを確認）
500	サーバーエラー

API 情報

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

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