Install

Wrap each agent run with the Intencion SDK. We trace the intent, every tool step, and the outcome in the background — your agent's own logic is untouched.

Your workspace API key

in_pk_4f8d9e2c1a6b7e3d5c8f9a2e1d4b6c8a

Treat this like a password. Rotate from settings if it leaks.

1. Install

pip install intencion

2. Wrap your run

import intencion
 
intencion.init(api_key="in_pk_4f8d9e2c1a6b7e3d5c8f9a2e1d4b6c8a")
 
with intencion.run(intent="refund", input=user_message, user=user_id) as run:
    order = lookup_order(order_id)
    run.step(name="lookup_order", tool="db", status="success")
 
    result = issue_refund(order)
    run.step(name="issue_refund", tool="stripe", status="success")

What we capture

Each run records the declared intent, the user input, every step (tool name + status), and the final outcome. Steps are ordered, so we reconstruct the full trace — no prompts or model responses are proxied. Events post to https://intencion.io/api/ingest.

3. Verify

⏵

Listening for your first run

Send a single traced run and we'll show up here within 2 seconds.

Bootstrap clustering kicks in at ~1,000 events. You can sample first with .