Reference
Model IDs and profiles
Use the correct model ID in Calypso RAG integrations and understand when to rely on the default agent versus named profiles.
Default model
The default RAG model ID is:
calypso-rag-agent
This is the best choice when you want one stable team-level grounded behavior across integrations.
Named profile format
Named profiles use this shape:
calypso-rag-agent:{profile_id}
The profile_id becomes part of the runtime contract, so choose it intentionally.
When to use the default model
Use the default model when:
- the team wants one canonical grounded behavior
- a widget or code path should not depend on a specialized profile
- you want the lowest-maintenance deployment target
When to use named profiles
Use named profiles when:
- two use cases need different retrieval scope
- role or presentation requirements differ materially
- one integration should stay stable while another is evolving
Important warning
If a named profile is deleted, any client still calling that model ID will break until the profile is recreated or the client is updated.