Core Concepts
The minimum object model behind the docs and SDK examples.
You do not need the full platform model to integrate Valmar. These are the concepts that show up repeatedly in the SDKs and docs.
UI vs API names
A few concepts are renamed in the Admin UI for clarity. The SDK and REST API keep the original names; this docs site uses the UI name in prose and the API name in code:
- "Person" in the UI →
Memberin the SDK and API. - "Knowledge Request" in the UI →
ContextRequestin the SDK and API. - "Knowledge" page in the UI → search/gather endpoints in the SDK and API.
Terms to know
Organization
The tenant boundary for people, projects, and reusable knowledge.
Project
The application or workflow scope that owns credentials, requests, and saved knowledge.
Person (Member)
A real employee or operator that Valmar can contact for missing context.
Shown as People in the Admin UI; called Member in the SDK and API.
Knowledge Request (Context Request)
A tracked request created when your app cannot answer confidently.
Shown as Knowledge Requests in the Admin UI; called ContextRequest in the SDK and API.
Context Part
A reusable saved answer that can be searched later with provenance and confidence metadata.