Policy behavior

Understand which Calypso RAG policy fields change retrieval behavior, which fields affect presentation, and how those choices show up across Playground, Code, and the widget.

Why policy semantics matter

In Calypso RAG, the visible model ID is only part of the story. The saved policy behind that model determines what the agent can search and how it responds.

Core policy ideas

Retrieval scope

Source scope determines which materials the agent is allowed to search before answering.

Role

Role shapes tone and answer posture. It does not act as a source-selection mechanism on its own.

Presentation

Presentation mode changes how the answer is formatted for the target surface.

Source visibility

Whether sources are returned changes citation visibility, not whether retrieval happened at all.

Practical field interpretation

`file_mode`

This decides whether the agent searches all retrievable file-backed content or only selected sources.

`file_ids`, `website_ids`, `qa_ids`

These narrow the included source pool when selected scope is being used.

`smalltalk_enabled`

This decides whether lightweight greetings and pleasantries can be answered more freely or should be forced through grounded behavior.

`return_sources`

This controls whether grounded source titles are surfaced in the final response.

`presentation_mode`

This helps the same grounded answer fit different delivery surfaces.

Best practice

Change one important policy dimension at a time, then validate in Playground before moving on to an integration surface.

Model IDs and profiles

Troubleshooting