> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://poly-ai.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://poly-ai.ferndocs.com/_mcp/server.

# Configuration

> Configure LLM, greeting, and safety filters for chat.

![chat-configuration](/_fern-files/_img/91f10d28040b73f3364eb22a3127fc5f80a378e0b6be72783d6b167cd9eddd4d.webp)

Configure chat settings in **Messaging**. Create widgets at **[Widget](/agent-studio/widgets/configure-widget)**.

## General

Select the language model that powers your chat agent.

**`Large language model`** `dropdown`

Choose the LLM for chat responses. Available models include PolyAI's **Raven 3.5** (recommended), OpenAI (GPT series), and Amazon Bedrock options.

---

**Recommended for chat:** PolyAI's [Raven 3.5](/agent-studio/behavior/models/raven) is designed for conversational AI and tuned for both voice and chat. It supports custom style instructions, auto-reasoning for complex queries, out-of-domain detection, and 24+ languages. Earlier Raven versions are deprecated and now route to Raven 3.5 automatically.

## Style prompt

Use this prompt to tailor tone, format, and etiquette specifically for the chat channel.

**`Style prompt`** `string`

An optional multiline prompt that adjusts how your agent responds in chat. Use this to set channel-specific formatting or communication style that differs from voice.

**Example:** "Use concise responses with bullet points. Include links when helpful."

---

The style prompt is optional. If left empty, the agent uses its default persona across all channels.

## Greeting

Configure what your agent says when a chat session begins.

**`Greeting message`** `string`

The first message your agent sends when a user opens the chat widget.

**Example:** "Hello, how can I help?"

---

Keep your greeting short and welcoming. Avoid long introductions that push the conversation off-screen.

## Safety filters

Safety filters are configured on a **per-channel basis**. The chat channel has its own safety filter settings, separate from the voice channel and the project-wide defaults. See [Safety filters](/agent-studio/behavior/guardrails/safety-filters) for the full reference on categories, severity levels, and how filters interact with [Guardrails](/agent-studio/behavior/guardrails/guardrails).

**`Enable safety filters`** `boolean`

When enabled, applies content filtering to chat responses. These filters apply to the chat channel only. Default settings can be managed on the **Behavior** page.

---

When safety filters are enabled, adjust the strictness for each category using the sliders:

| Category           | Description                                                                |
| ------------------ | -------------------------------------------------------------------------- |
| **Violence**       | Controls filtering of violent content (Lenient → Strict)                   |
| **Hate**           | Controls filtering of hateful or discriminatory content (Lenient → Strict) |
| **Sexual content** | Controls filtering of sexually explicit content (Lenient → Strict)         |
| **Self-harm**      | Controls filtering of self-harm related content (Lenient → Strict)         |

The jailbreak attack filter is always enabled and cannot be turned off.

> **Warning**
>
> More lenient settings allow a wider range of content through. Review your use case and compliance requirements when adjusting these settings.

## Branching behavior

Chat configuration changes take effect immediately when saved. Unlike other project settings, webchat does not follow the environment branching system – there is no Sandbox, Pre-release, or Live promotion step. Use the **Test Agent Chat** panel to verify changes before saving.

## Markdown support

Chat messages support formatted markdown rendering:

* **Bold** and *italics*
* Bulleted and numbered lists
* [Links](https://example.com)
* `Code blocks`

Formatted markdown appears in both the **Test Agent Chat** panel and **Conversation Review**.

## Next steps

After configuring chat settings:

1. **[Configure the widget](/agent-studio/widgets/configure-widget)** - Style and customize the chat widget appearance
2. **[Deploy to your website](/agent-studio/widgets/configure-widget#embed-tab)** - Generate and embed the script tag

You must configure chat settings before the widget will function. In-product banners will guide you through this process.