> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Flow settings: the Global settings panel

> Settings for a whole flow agent: system prompt, smart context manager, tools used by the flow, MCP servers and live variables, plus links to shared settings.

Settings that apply to the whole flow live in **Global settings**, not on any one step. This page covers the parts that only flow agents have, and points to the pages for settings that flow and single prompt agents share.

## Open Global settings

In the flow builder, click **Global settings** in the tool rail. Each section shows a short summary (such as **On**, **Off**, **Not set**, a count, or **Needs attention**). Click a section to open it.

![The Global settings panel open in the flow builder, listing System prompt, Voice settings, LLM configuration and the other sections with their summaries](https://mintcdn.com/hamsa-452fa79a/2xrN5xxbhCUDZ-2o/images/agents/flow/global-settings-light.webp?fit=max\&auto=format\&n=2xrN5xxbhCUDZ-2o\&q=85\&s=baf6dfa0f6efcf665e9da3b8177c5dc7)

When you view an older version of the agent, every section is read-only.

## Sections at a glance

| Section | What it sets | Where it's explained |
| - | - | - |
| **System prompt** | Instructions for the whole call, plus prompt enhancer, enhanced turn taking and smart context manager | [Below](#system-prompt) |
| **Voice settings** | Voice, expressiveness, speech recognition model, voice dictionaries | [Voice, language and dialect](https://docs.tryhamsa.com/agents/settings/voice-and-language.md) |
| **LLM configuration** | Provider and model | [Choose the model](https://docs.tryhamsa.com/agents/settings/model.md) |
| **Noise cancellation** | Noise cancellation and auto-gain control | [Call behavior settings](https://docs.tryhamsa.com/agents/settings/call-behavior.md) |
| **Knowledge base** | Knowledge base items the agent can search | [Knowledge base](https://docs.tryhamsa.com/agents/knowledge-base/overview.md) |
| **Tools** | Every tool the flow's steps call | [Below](#tools) |
| **MCP servers** | MCP servers for the whole flow | [Below](#mcp-servers) |
| **Live variables** | Values extracted after every caller turn | [Live variables](https://docs.tryhamsa.com/agents/variables/live-variables.md) |
| **Outcome** | The data to produce from each call after it ends | [Call details](https://docs.tryhamsa.com/agents/monitor/call-details.md) |
| **Phone number** | The numbers that reach this agent | [Phone numbers](https://docs.tryhamsa.com/agents/connect/phone-numbers.md) |
| **Call settings** | Turn taking, interruptions, timeouts, call length and more | [Call behavior settings](https://docs.tryhamsa.com/agents/settings/call-behavior.md) |
| **Policies & guardrails** | Rules the agent follows and checks it can't skip | [Policies & guardrails](https://docs.tryhamsa.com/agents/safety/policies-and-guardrails.md) |
| **Functions & macros** | JavaScript and Jinja helpers for guardrails and prompts | [Functions & macros](https://docs.tryhamsa.com/agents/safety/functions-and-macros.md) |
| **Call webhook** | Where call events and conversation data are sent | [Webhooks](https://docs.tryhamsa.com/agents/connect/webhooks.md) |

To change the system prompt, voice or call settings for one part of the call only, use a [Change agent settings step](https://docs.tryhamsa.com/agents/flow/steps/change-settings.md).

## System prompt

**System prompt** is required: "System instructions are required" until you fill it in. Write who the agent is, how it should speak and what it must never do. It applies on every step of the call. Each Conversation step's message adds the instructions for that part of the call on top of it, so keep step-specific instructions in the steps and shared rules here. See [Write a prompt that works on calls](https://docs.tryhamsa.com/agents/build/write-a-prompt.md).

Under the box, the editor counts the prompt's words and estimates its tokens ("56 words · about 83 tokens"). The token count is an estimate of what the prompt costs on every turn; the model counts its own way. When the prompt has two or more Markdown headings (`#`, `##` or `###`), an **Outline** menu appears next to the count: pick a heading to jump to it. A prompt with Jinja blocks shows as a preview, so it has no outline.

![The System prompt section with a prompt split into Role, What you help with and Rules, the count 56 words, about 83 tokens, and the Outline menu open listing the three headings](https://mintcdn.com/hamsa-452fa79a/Rl78D_qJIpinmg19/images/agents/flow/system-prompt-outline-light.webp?fit=max\&auto=format\&n=Rl78D_qJIpinmg19\&q=85\&s=79d3a88c9e54ea8a3278e26ff3e0e5df)

The same section has three switches and choices:

| Field | What it does | Default |
| - | - | - |
| **Prompt enhancer** | Adds automatic improvements to the prompts the model reads. **Disabled**: "No enhancements applied". **Basic**: "Stable, model-agnostic prompts". **Advanced**: "Model-aware prompts with stronger guardrails and live flow context", for complex or long conversations | **Basic** |
| **Enhanced turn taking** | "Better numeral capturing and backchannel detection for more natural conversations" | Off |
| **Smart context manager** | "Keeps what the model reads short and relevant as the call moves between steps, so long calls stay accurate and never go over the model's limit." | On for new agents |

![The System prompt section with a system prompt filled in, Prompt enhancer set to Basic, Enhanced turn taking and Smart context manager switches](https://mintcdn.com/hamsa-452fa79a/2xrN5xxbhCUDZ-2o/images/agents/flow/global-settings-system-prompt-light.webp?fit=max\&auto=format\&n=2xrN5xxbhCUDZ-2o\&q=85\&s=7c449b18d35fb81c026e6dae4271a2ec)

### Smart context manager

On long calls, the conversation the model reads keeps growing, including what earlier steps left behind. With **Smart context manager** on, the agent builds a trimmed view of the conversation for each reply: it tidies up what earlier steps left once a new step is under way, and keeps the total within the model's limit. The full transcript is kept as is. If anything goes wrong while trimming, the agent uses the full conversation for that reply.

Turn it on for flows with many steps or long calls.

## Tools

**Tools** ("Every tool this flow calls, and the steps that call it") is a read-only overview. You add a tool to the flow by adding a [Tool step](https://docs.tryhamsa.com/agents/flow/steps/api-request.md) or a [Web tool step](https://docs.tryhamsa.com/agents/flow/steps/web-tool.md), not here.

* Each tool shows its method (or MCP or WEB) and how many steps use it ("Used in 3 steps"). The most used come first.
* Each tool's steps are folded. Click the tool to list them; click a step's name to open its settings, or **Locate** to center it on the canvas.
* With two or more tools, **Search tools or steps** finds a tool by its name or a step by its name, and **All**, **APIs**, **MCP** and **Web** narrow the list by kind. With **APIs**, you can also pick a method.
* **Mixed versions** means the flow's steps use different versions of the same tool. Each step then shows its version, such as `v2`.
* **Whole flow** marks an MCP server attached to the whole flow rather than to a step.
* **Open … in Tools** opens the tool in [APIs & MCPs](https://docs.tryhamsa.com/agents/tools/overview.md).

With no tool steps yet, it reads: "No step calls a tool yet. Add a Tool or Web tool step to call one."

![The Tools section with Search tools or steps, the All, APIs, MCP and Web filter, and two tools: create\_return folded and lookup\_order open on its Look up order step](https://mintcdn.com/hamsa-452fa79a/2xrN5xxbhCUDZ-2o/images/agents/flow/global-settings-tools-search-light.webp?fit=max\&auto=format\&n=2xrN5xxbhCUDZ-2o\&q=85\&s=df3fc8373c1a3a30acec4b93eb4e4abc)

## MCP servers

**MCP servers** ("Manage MCP servers available to your workflow.") attaches MCP servers to the whole flow. Click **Add MCP servers** to pick from the servers in your project, or **Manage servers** to change them. "Their functions are available on every step": the agent can call them at any point in the call, whichever step it's in.

Every function each server offers is available to the agent; you can't pick functions or fix their parameters here. When a newer version of a server exists, its row shows **Update available** with **Update**. To take a server off the flow, click its ×.

To set up a server first, see [Connect an MCP server](https://docs.tryhamsa.com/agents/tools/mcp-servers.md).

![The MCP servers section with no servers yet and the Add MCP servers button](https://mintcdn.com/hamsa-452fa79a/2xrN5xxbhCUDZ-2o/images/agents/flow/global-settings-mcp-servers-light.webp?fit=max\&auto=format\&n=2xrN5xxbhCUDZ-2o\&q=85\&s=730c95decc81452ae37f657abc377d91)

## Live variables

**Live variables** are "Extracted after every caller turn, in every node." Define a value once here, and the agent keeps it up to date for the whole call, whichever step the caller is in: their name, a new delivery date, or asking for a person. Each one is a row that opens its card, with **Back** to return. A step can switch an agent-wide live variable off, or add its own, and a **When a live variable matches** transition can move the call as soon as one matches.

For setup, value checks and how they behave on a call, see [Live variables](https://docs.tryhamsa.com/agents/variables/live-variables.md).

## Good to know

* With [versioning](https://docs.tryhamsa.com/agents/release/environments.md), **Phone number** is read-only here: which number reaches which environment is managed in releases.
* Changes save to your draft as you make them. They reach callers when you publish. See [Drafts and versions](https://docs.tryhamsa.com/agents/release/drafts-and-versions.md).

## Related

> [card] [Call behavior settings](https://docs.tryhamsa.com/agents/settings/call-behavior.md)
>
> Turn taking, interruptions, timeouts and call length.

> [card] [Choose the model](https://docs.tryhamsa.com/agents/settings/model.md)
>
> Providers and models for your agent.

> [card] [Change agent settings step](https://docs.tryhamsa.com/agents/flow/steps/change-settings.md)
>
> Change settings for part of a call.

> [card] [Live variables](https://docs.tryhamsa.com/agents/variables/live-variables.md)
>
> Values the agent keeps up to date for the whole call.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.