Back to docs

Tool Cognitive Journey Init

Category: Cognitive Journeys -- Tier: All

Start a cognitive user journey simulation. Returns the persona's cognitive profile, initial state, and abandonment thresholds.

The LLM drives the actual simulation using browser tools (navigate, click, fill, screenshot). It tracks cognitive state throughout.

When to Use

Cognitive journeys simulate real user behavior. They use 26 cognitive traits and 10 motivational values. The simulation tracks patience, frustration, confusion, decision fatigue, and emotional state. All of this is grounded in cognitive psychology research.

Parameters

Parameter Type Required Description
persona string Yes Persona name (e.g., 'first-timer', 'elderly-user', 'power-user') or a custom description
goal string Yes What the simulated user is trying to do
startUrl string Yes Starting URL for the journey
customTraits object No Override specific cognitive traits (26 available)
location object No Override persona's location settings (timezone, locale, geolocation)
waitAfterLoad number No Extra ms to wait after page loads (e.g., 3000 for translated sites)
waitForSelector string No CSS selector to wait for after load (e.g., [data-translated])

Example

Start a cognitive journey as a first-timer trying to find pricing

Tips

  • Combine with other tools for deeper analysis.

Research

Related

From the Blog