> ## Documentation Index
> Fetch the complete documentation index at: https://orwel-22af1265.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Personality Engine

> Understanding how Orwel calculates visitor personalities and behavioral patterns.

Orwel's **Personality Engine** analyzes visitor behavior in real-time to infer psychological traits and predict future actions. This analysis is based on the **p12 Base Model**, a set of 12 core personality archetypes derived from digital body language.

## The p12 Base Model

The engine scores every visitor against 12 distinct personality dimensions. A visitor typically exhibits a mix of these traits, with 1-2 dominant ones forming their primary persona.

### Action Architects

*Users who are goal-oriented and structured.*

<CardGroup cols={2}>
  <Card title="Decisive" icon="bolt" href="/concepts/personalities/decisive">
    Quick to act, focused on results.
  </Card>

  <Card title="Impulsive" icon="fire" href="/concepts/personalities/impulsive">
    Acts on immediate urges, high energy.
  </Card>

  <Card title="Methodical" icon="list-check" href="/concepts/personalities/methodical">
    Systematic, detail-oriented.
  </Card>

  <Card title="Focused" icon="crosshairs" href="/concepts/personalities/focused">
    Highly attentive to specific tasks.
  </Card>
</CardGroup>

### Information Explorers

*Users who seek knowledge and understanding.*

<CardGroup cols={2}>
  <Card title="Curious" icon="magnifying-glass" href="/concepts/personalities/curious">
    Seeks new information, explores widely.
  </Card>

  <Card title="Skeptical" icon="shield" href="/concepts/personalities/skeptical">
    Cautious, verifies claims.
  </Card>

  <Card title="Lost" icon="compass" href="/concepts/personalities/lost">
    Disoriented or unsure.
  </Card>
</CardGroup>

### Social Connectors

*Users driven by interaction and community.*

<CardGroup cols={2}>
  <Card title="Social" icon="users" href="/concepts/personalities/social">
    Seeks connection with others.
  </Card>

  <Card title="Reactive" icon="bell" href="/concepts/personalities/reactive">
    Responds to external stimuli.
  </Card>
</CardGroup>

### Emotional States

*Transient states reflecting current mood.*

<CardGroup cols={2}>
  <Card title="Anxious" icon="triangle-exclamation" href="/concepts/personalities/anxious">
    Worried or hesitant.
  </Card>

  <Card title="Playful" icon="gamepad" href="/concepts/personalities/playful">
    Fun-seeking, non-linear.
  </Card>

  <Card title="Engaged" icon="heart" href="/concepts/personalities/engaged">
    Deeply involved and committed.
  </Card>
</CardGroup>

## Calculation Logic

The engine uses a **Bayesian Inference** model combined with **Rate-Based Feature Extraction**.

1. **Event Collection**: The SDK captures granular events (clicks, scrolls, hovers, form inputs).
2. **Feature Engineering**: Events are normalized into rates (e.g., `clicks_per_minute`, `interaction_ratio`) to account for session duration.
3. **Probabilistic Scoring**: Each trait has a Gaussian probability model. The engine calculates the likelihood of the observed behavior matching each trait's profile.
4. **Confidence Score**: A confidence score (0-1) is assigned to each trait. Traits with high confidence (>0.6) are considered active.

## Personality Combos (Synergies)

When a visitor exhibits two strong traits simultaneously, they form a **Personality Combo**. These combinations provide deeper insight into complex behaviors.

### Complementary Synergies

Positive combinations that enhance user capability.

* **Executive Architect** (Decisive + Methodical): Deep analysis followed by decisive action. The ideal B2B buyer.
* **Community Catalyst** (Social + Playful): Drives engagement and viral growth.
* **Critical Researcher** (Curious + Skeptical): Explores widely but evaluates rigorously. Hard to win over, but loyal once convinced.
* **Goal Achiever** (Decisive + Engaged): Quick decision-making with long-term commitment.
* **Specialist Commitment** (Focused + Engaged): Intense concentration with sustained interest.

### Conflict Patterns

Opposing traits that indicate friction or uncertainty.

* **Tension Pattern** (Impulsive + Methodical): Urgency vs. Deliberation. The user wants to act but feels the need to check details, leading to erratic behavior.
* **Stress Pattern** (Anxious + Decisive): Caution vs. Action. Often results in "approach-avoidance" cycles (starting a form, stopping, starting again).
* **Navigation Conflict** (Lost + Focused): Disorientation vs. Concentration. The user is trying hard to find something but failing.

## Using Personalities

You can retrieve the inferred personalities for a visitor using the API:

```http theme={null}
GET /api/v1/identities/{id}/personalities
```

Use these insights to personalize the experience:

* **For Decisive users**: Show "Buy Now" buttons and quick checkout.
* **For Skeptical users**: Highlight social proof, guarantees, and detailed specs.
* **For Lost users**: Trigger a proactive support chat or simplified navigation.
