soultrace-ai/soultrace-skill

SoulTrace Persönlichkeitstest

Führe einen adaptiven Persönlichkeitstest über die soultrace API durch. Beantworte 24 Fragen auf einer Likert-Skala von 1 bis 7 und erhalte deinen Persönlichkeitsarchetyp basierend auf einem 5-Farben-Modell.

API-Endpunkt

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

Keine Authentifizierung erforderlich. Auf 100 Anfragen pro Stunde pro IP begrenzt.

Funktionsweise

Die API ist zustandslos. Du übergibst alle gesammelten Antworten mit jeder Anfrage, und der Server führt die Bayessche Inferenz erneut aus, um die nächste optimale Frage auszuwählen.

Schritt 1: Test starten

Sende ein leeres Antworten-Array, um die erste Frage zu erhalten:

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

Antwort:

{
  "status": "in_progress",
  "question": {
    "id": 42,
    "text": "Ich finde tiefe Zufriedenheit darin, komplexe Systeme zu meistern."
  },
  "currentDistribution": {
    "white": 0.2,
    "blue": 0.2,
    "black": 0.2,
    "red": 0.2,
    "green": 0.2
  },
  "entropy": 2.322,
  "progress": { "answered": 0, "total": 24 }
}

Schritt 2: Fragen beantworten

Der Benutzer beantwortet jede Frage auf einer Skala von 1 bis 7:

• 1 = Stimme überhaupt nicht zu
• 4 = Neutral
• 7 = Stimme voll und ganz zu

Füge die Antwort hinzu und sende alle bisherigen Antworten:

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

Sammle weiterhin Antworten. Jede Antwort liefert die nächste Frage.

Schritt 3: Ergebnisse erhalten

Nach 24 Antworten gibt die Antwort automatisch das Endergebnis zurück:

{
  "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": "Stratege",
    "alignmentScore": 87.3,
    "coreDynamic": "...",
    "strengths": ["..."],
    "weaknesses": ["..."]
  },
  "topMatches": [
    { "key": "blue-black", "name": "Stratege", "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 }
}

Agenten-Interaktionsprotokoll

Wenn ein Benutzer den Persönlichkeitstest durchführen möchte:

1. Starte durch Aufruf der API mit {"answers": []}.
2. Präsentiere jede Frage deutlich dem Benutzer. Sage ihm, er solle mit 1-7 antworten (1=Stimme überhaupt nicht zu, 4=Neutral, 7=Stimme voll und ganz zu).
3. Sammle die numerische Antwort des Benutzers (1-7). Bei einer nicht-numerischen oder beschreibenden Antwort, ordne sie der Skala zu:
   • „stimme überhaupt nicht zu“ / „überhaupt nicht“ → 1
   • „stimme nicht zu“ / „nicht wirklich“ → 2
   • „stimme eher nicht zu“ → 3
   • „neutral“ / „vielleicht“ / „manchmal“ → 4
   • „stimme eher zu“ → 5
   • „stimme zu“ / „ja“ → 6
   • „stimme voll und ganz zu“ / „absolut“ → 7
4. Sammle Antworten und sende jedes Mal ALLE bisherigen Antworten plus die neue.
5. Nach allen 24 Fragen präsentiere die Ergebnisse mit:
   • Ihrem Archetypnamen und Übereinstimmungswert
   • Ihrer Farbverteilung (als Prozentsätze anzeigen)
   • Ihren Top-3-Archetypübereinstimmungen
   • Dem Link zu ihrer vollständigen Ergebnisdetailseite
6. Überspringe niemals Fragen und beantworte sie nicht automatisch im Namen des Benutzers.

Bewertungsskala

Punktzahl	Bedeutung
1	Stimme überhaupt nicht zu
2	Stimme nicht zu
3	Stimme eher nicht zu
4	Neutral
5	Stimme eher zu
6	Stimme zu
7	Stimme voll und ganz zu

Die 5 Farben

Farbe	Antrieb	Essenz
Weiß	Struktur, Fairness	Ordnung, Verantwortung
Blau	Verstehen, Meisterschaft	Neugier, Präzision
Schwarz	Handlungsfähigkeit, Leistung	Ehrgeiz, Strategie
Rot	Intensität, Ausdruck	Leidenschaft, Ehrlichkeit
Grün	Verbindung, Wachstum	Zugehörigkeit, Geduld

Ratenbegrenzungen

• 100 Anfragen pro Stunde pro IP
• Jeder Test erfordert 25 Anfragen (1 Start + 24 Antworten)
• Maximal ~4 vollständige Tests pro Stunde

Fehlerbehandlung

Status	Bedeutung
400	Ungültiger Anfragekörper oder Antwortenformat
429	Ratenlimit überschritten (überprüfe den Retry-After-Header)
500	Serverfehler

API-Info

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

Gibt API-Metadaten zurück (Version, Fragenanzahl, Bewertungsbereich).