Systems And Versions
Register the AI System under review and create explicit System Versions for candidates.
System vs System Version
A System is the AI product surface under review. A System Version is a concrete baseline or candidate configuration for that System.
| Object | Example |
|---|---|
| System | Search API, Home feed recommender, Support agent |
| System Version | prod-2026-05-20, candidate-ranker-v42, agent-policy-fix-3 |
Create a System
shell
determina systems create --project-id <project-id> --name "Home feed recommender" --system-type recommender --kind url --config-json '{"base_url":"https://candidate.example.com"}'Create a Version
shell
determina system-versions create --project-id <project-id> --system-id <system-id> --label "candidate-ranker-v42" --metadata-json '{"git_sha":"<sha>","release":"2026-05-23"}'Configuration shape
The configuration shape depends on how Determina reaches the System. Use Native HTTP for services that speak Determina contracts directly, Schema-Mapped HTTP for existing HTTP shapes, and agent integration pages for agent drivers.