> ## Documentation Index
> Fetch the complete documentation index at: https://www.orwel.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intent signals

> Behavior patterns Orwel reads from each session and the action each one suggests.

Orwel reads how a visitor behaves in a session (clicks, scroll, hovers, form inputs, pace) and turns it into **intent signals**: behavior patterns such as *comparing options*, *ready to act* or *lost*. They are statistical patterns of on-page behavior, not a psychological profile of the person, and they exist to trigger a useful action: show proof to someone who is verifying claims, offer help to someone who is lost, shorten the path for someone ready to act.

> [!NOTE]
>
> Signals are computed from on-site behavior only. They never use sensitive categories, and they are exposed to you through the app, the API and MCP; nothing is shown to the visitor unless you build it.

## Signal to action

| Signal | What the session looks like | A useful response |
| - | - | - |
| Decisive | Few pages, straight to pricing or signup | Keep the path short, put the CTA first |
| Skeptical | Rereads pricing, opens comparisons and FAQs | Show social proof, guarantees and docs |
| Lost | Back and forth, repeated searches, no progress | Offer chat or a guided tour |
| Curious | Many pages, long reads, no conversion yet | Offer a guide, newsletter or demo |
| Anxious | Starts forms and abandons them | Reduce fields, reassure about price and data |
| Engaged | Long session, deep scroll, returns often | Invite to trial, call or community |

## The 12 signals

Every session is scored against 12 behavior patterns, grouped below. A visitor usually shows a mix, with one or two dominant signals. The API names them personalities for backwards compatibility.

### Action Architects

*Users who are goal-oriented and structured.*

> [card] [Decisive](https://www.orwel.io/docs/concepts/personalities/decisive.md)
>
> Quick to act, focused on results.

> [card] [Impulsive](https://www.orwel.io/docs/concepts/personalities/impulsive.md)
>
> Acts on immediate urges, high energy.

> [card] [Methodical](https://www.orwel.io/docs/concepts/personalities/methodical.md)
>
> Systematic, detail-oriented.

> [card] [Focused](https://www.orwel.io/docs/concepts/personalities/focused.md)
>
> Highly attentive to specific tasks.

### Information Explorers

*Users who seek knowledge and understanding.*

> [card] [Curious](https://www.orwel.io/docs/concepts/personalities/curious.md)
>
> Seeks new information, explores widely.

> [card] [Skeptical](https://www.orwel.io/docs/concepts/personalities/skeptical.md)
>
> Cautious, verifies claims.

> [card] [Lost](https://www.orwel.io/docs/concepts/personalities/lost.md)
>
> Disoriented or unsure.

### Social Connectors

*Users driven by interaction and community.*

> [card] [Social](https://www.orwel.io/docs/concepts/personalities/social.md)
>
> Seeks connection with others.

> [card] [Reactive](https://www.orwel.io/docs/concepts/personalities/reactive.md)
>
> Responds to external stimuli.

### Emotional States

*Transient states reflecting current mood.*

> [card] [Anxious](https://www.orwel.io/docs/concepts/personalities/anxious.md)
>
> Worried or hesitant.

> [card] [Playful](https://www.orwel.io/docs/concepts/personalities/playful.md)
>
> Fun-seeking, non-linear.

> [card] [Engaged](https://www.orwel.io/docs/concepts/personalities/engaged.md)
>
> Deeply involved and committed.

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.