Skip to main content

System Context

If agents are your employees, system context is the environment you set for them — what your business is, who it serves, and how it should sound. It's global, operator-managed background information that Circus makes available to your workflows at runtime, so you don't have to repeat it in every prompt.

What goes in it

Each context item is a named entry with a body of text — things like company name, brand guidelines, target audience, tone of voice, or compliance boundaries. You give it a name and the content; the app generates a read-only slug from the name (lowercase, letters and numbers), and that slug is fixed once created, even if you later rename the item.

Enabling and disabling

Every item has an enabled/disabled toggle, and this is the important part: only enabled items are handed to workflows, and only for runs that start after the change. Disabling a context item — or editing its body — never reaches back into a run that's already underway. Each execution takes a snapshot of the enabled context at the moment it starts. Disabled items appear greyed out in the list, and deleting an item is permanent.

How workflows receive it

When a workflow starts, Circus includes a system_context object in the data it sends — a simple set of key/value pairs, one per enabled item, keyed by slug. Ordering doesn't matter; what matters is that every enabled entry is passed along. Whether an agent actually uses a given piece of context is up to how its prompt is written — system context makes the information available; the prompt decides what to do with it.

Why it's powerful

Setting the environment once, centrally, is what lets every agent and every workflow speak with one consistent voice — without you copy-pasting the same brand or compliance text into dozens of prompts. Change the company's tone in one place, and every run from that point forward reflects it.