Agent Builder

Agent Builder is the control plane for Calypso RAG. Use it to define retrieval scope, response behavior, presentation mode, and named profiles for different deployment needs.

What Agent Builder controls

Agent Builder is where you decide how the RAG agent should behave, not just what it should know.

The saved policy from Agent Builder is reused across:

Playground
Code integrations
linked-agent widget mode

Default agent and named profiles

There is always one default model:

calypso-rag-agent

You can also create named profiles:

calypso-rag-agent:{profile_id}

Use the default agent for a stable deployment target. Use named profiles when you need multiple grounded behaviors for different use cases.

What you can configure

The current policy model supports:

retrieval enabled or disabled
source scope
all files vs selected sources
specific file, website, and Q&A source IDs
optional model override
top_k
small talk behavior
whether grounded source titles are returned
role preset and role brief
presentation mode

Presentation modes

The app supports response presentation choices such as:

plain text
markdown
markdown with tables
WhatsApp-safe
auto

Choose presentation mode for the target surface, not for abstract style preference.

Source scope strategy

You have two broad options:

all retrievable files
selected sources

Use all when the workspace is tightly governed and the agent should search broadly.

Use selected when:

the source pool is still noisy
the use case is specialized
you want separation between profiles

Deleting named profiles

Deleting a named profile removes it from the workspace, but it does not update every downstream client that may still call that profile ID.

Before deleting a named profile, confirm:

Playground tests have moved away from it
widget bindings no longer depend on it
external code integrations no longer call that model ID

Next steps

Knowledge

Integrations