Profiles and Scenes
Understanding how profiles and scenes organize your conversation data
Data Organization
Profiles and scenes are the fundamental building blocks of the Ontbo API. They provide a structured way to organize conversation data and enable intelligent context retrieval.
Profiles
A profile represents a single end-user of your application within the Ontbo API.
Profiles keep each user’s data separate, so information belonging to one user cannot be accessed by another. All data you send to a profile, and all queries you make, are scoped to that profile.
Example: If your application has 100 registered users, you would typically create 100 profiles in the Ontbo API — one for each user.
Scenes
A scene represents a single unit of interaction between a user and your application.
In the current version of the Ontbo API, a scene corresponds to a chat session. Future versions will support other types of interactions (for example, voice sessions or interactive workflows).
Every scene is always linked to exactly one profile, ensuring the interaction belongs to the correct user.
Example: When a user starts a new conversation in your app, you create a new scene inside their profile.
Profile and Scene Structure
Next Steps
Now that you understand profiles and scenes, learn about the different retrieval modes available for querying your data.