Getting Started
In plain terms: you already know who your user is. Buddy just needs a trustworthy way to learn the same thing, so the agent can be helpful without ever asking the user to log in again.
Key concepts
- Identity Bridge
- The mechanism that turns a token from your app into a verified Identity Context the agent can use.
- Identity Context
- A small, verified set of facts about the user:
userId, optionalemailandrole, plus any custom attributes you map. - Business API Tool
- An optional tool that lets the agent call your own API, with the verified identity injected server-side.
The three-minute version
- In Studio, open your agent → Connections → User authentication.
- Pick a method (most teams start with JWT pass-through) and save your configuration.
- Embed the widget and hand it a user token (see below).
- Open the live console to confirm a sample token verifies.