soultrace-ai/soultrace-skill

Avaliação de Personalidade SoulTrace

Faça uma avaliação adaptativa de personalidade através da API soultrace. Responda a 24 perguntas em uma escala Likert de 1 a 7 e receba seu arquétipo de personalidade com base em um modelo psicológico de 5 cores.

Endpoint da API

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

Não requer autenticação. Limitado a 100 requisições/hora por IP.

Como Funciona

A API é stateless. Você envia todas as respostas acumuladas em cada requisição, e o servidor reproduz a inferência bayesiana para selecionar a próxima pergunta ideal.

Passo 1: Iniciar o teste

Envie um array de respostas vazio para obter a primeira pergunta:

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

Resposta:

{
  "status": "in_progress",
  "question": {
    "id": 42,
    "text": "Eu encontro profunda satisfação em dominar sistemas complexos."
  },
  "currentDistribution": {
    "white": 0.2,
    "blue": 0.2,
    "black": 0.2,
    "red": 0.2,
    "green": 0.2
  },
  "entropy": 2.322,
  "progress": { "answered": 0, "total": 24 }
}

Passo 2: Responder às perguntas

O usuário responde a cada pergunta em uma escala de 1 a 7:

• 1 = Discordo Totalmente
• 4 = Neutro
• 7 = Concordo Totalmente

Adicione a resposta e envie todas as respostas até o momento:

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

Continue acumulando respostas. Cada resposta fornece a próxima pergunta.

Passo 3: Obter resultados

Após 24 respostas, a resposta retorna automaticamente o resultado final:

{
  "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": "Estrategista",
    "alignmentScore": 87.3,
    "coreDynamic": "...",
    "strengths": ["..."],
    "weaknesses": ["..."]
  },
  "topMatches": [
    { "key": "blue-black", "name": "Estrategista", "alignmentScore": 87.3 },
    { "key": "blue", "name": "Racionalista", "alignmentScore": 82.1 },
    { "key": "black-blue", "name": "Operador", "alignmentScore": 78.5 }
  ],
  "shadowColors": [
    { "color": "red", "score": 0.10 },
    { "color": "green", "score": 0.15 }
  ],
  "progress": { "answered": 24, "total": 24 }
}

Protocolo de Interação do Agente

Quando um usuário solicitar fazer o teste de personalidade:

1. Inicie chamando a API com {"answers": []}.
2. Apresente cada pergunta claramente ao usuário. Diga a ele para responder de 1 a 7 (1=Discordo Totalmente, 4=Neutro, 7=Concordo Totalmente).
3. Colete a resposta numérica do usuário (1-7). Se ele der uma resposta não numérica ou descritiva, mapeie-a para a escala:
   • "discordo totalmente" / "de jeito nenhum" → 1
   • "discordo" / "não muito" → 2
   • "discordo ligeiramente" → 3
   • "neutro" / "talvez" / "às vezes" → 4
   • "concordo ligeiramente" → 5
   • "concordo" / "sim" → 6
   • "concordo totalmente" / "absolutamente" → 7
4. Acumule as respostas e envie TODAS as respostas anteriores mais a nova a cada vez.
5. Após todas as 24 perguntas, apresente os resultados com:
   • O nome do arquétipo e a pontuação de alinhamento
   • A distribuição de cores (mostre como porcentagens)
   • As 3 principais correspondências de arquétipo
   • O link para a página completa de resultados
6. Nunca pule perguntas ou responda automaticamente em nome do usuário.

Escala de Pontuação

Pontuação	Significado
1	Discordo Totalmente
2	Discordo
3	Discordo Ligeiramente
4	Neutro
5	Concordo Ligeiramente
6	Concordo
7	Concordo Totalmente

As 5 Cores

Cor	Motivação	Essência
Branco	Estrutura, justiça	Ordem, responsabilidade
Azul	Compreensão, domínio	Curiosidade, precisão
Preto	Agência, realização	Ambição, estratégia
Vermelho	Intensidade, expressão	Paixão, honestidade
Verde	Conexão, crescimento	Pertencimento, paciência

Limites de Taxa

• 100 requisições por hora por IP
• Cada teste requer 25 requisições (1 início + 24 respostas)
• Máximo de ~4 testes completos por hora

Tratamento de Erros

Status	Significado
400	Corpo da requisição ou formato das respostas inválido
429	Limite de taxa excedido (verifique o cabeçalho Retry-After)
500	Erro do servidor

Informações da API

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

Retorna metadados da API (versão, número de perguntas, intervalo de pontuação).