Secret handling
Where a secret variable's value is stored, who can read it, and how the Builder Chat collects one without it passing through the model.
A secret variable goes in and is never readable again by anyone except the call-time runtime.
Authorization: Bearer {{calendar_api_key}}Where the value lives
The value is encrypted before it is stored, and the encryption is tied to your workspace, so the stored copy only decrypts for it. The unencrypted value is never stored alongside your agent's settings.
At call time the runtime decrypts the value server-side, purely to fill in
{{token}} references in your tools. Nothing in the browser ever sees the
decrypted bytes.
Rotating a secret
The editor is write-only: it shows that a secret exists but never re-displays the value. When you edit, the value field starts empty. Type a new value to rotate it, or leave it blank to keep the current value. Saving blank is a no-op, not an erase.
Why the model never sees one
Secrets are decrypted to fill a tool's URL or headers, which the model does not author. The model writes the request body, but the substituted secret lives in the URL and headers, out of its reach.
Keep secrets out of a tool's mock response. The runtime fills tokens there too, and a mock response is handed to the model as the tool's result, so a secret written in one reaches the model.
Secrets in a URL or header never reach the model
A secret in a tool's URL or headers cannot be leaked through a transcript, an answer to the caller, or the Builder Chat.
The Builder Chat secret dialog
When the Builder Chat wires a tool that needs authentication, it calls for a secret variable and the editor opens a passive password dialog. You type the value there and it goes from your browser to the encrypted store. The model never sees it.
Never paste a credential into the chat
If you paste a credential into the conversation, the model sees it before any tool runs. Some pastes are refused and you are pointed back at the dialog, but that check recognises a credential by its name or its shape, and not every credential has a recognisable one.
The dialog is the only path that keeps the value out of the model. Rotate anything you have already pasted.
Variables and secrets
Reusable tokens substituted into your prompt, tools and workflow functions at call time, including secrets that stay encrypted in the vault and never reach the model.
Caller memory
Recognising a repeat caller by phone number, and the settings that decide how the agent treats them.