Agent Settings Guide
Complete feature reference and user guide for configuring AI persona, localization, branding, and widget genres.
1. Overview
The Agent Settings page is the central command center for customizing your AI agent's behavior, response tone, multi-lingual capabilities, starter prompt chips, and visual widget appearance.
Every change made in Agent Settings is reflected instantly in the Live Widget Preview on the right side of the screen, allowing you to test aesthetics and prompt responses before saving.
Access Path
Workspace Hub → Select Agent → Settings Tab (or /workspace/[agent_id]/dashboard)
2. Agent Identity & AI Prompts
Define your agent's name, business archetype, system instructions, and initial customer greeting.
Agent Name & Business Archetype
Set the agent's name as displayed in the chat header and select a specialized domain archetype (e.g. Ecommerce, Real Estate, AI Consulting, Lead Generation).
Archetypes configure default domain knowledge rules, currency formats, and fallback intent rules.
System Prompt & AI Generator (Sparkles)
The System Prompt contains the core instructions guiding how the AI behaves, answers questions, and qualifies leads.
- Manual Customization: Type exact directives, tone guidelines, business policies, or disclaimers.
- AI Prompt Generator: Click the
Sparklesbutton to automatically craft a structured, high-converting system prompt based on your business domain. - Generation Quota Protection: Includes safety limit tracking (max 10 AI generations) to prevent runaway usage.
Welcome Message
Customize the initial greeting displayed when a visitor opens the web chat widget (e.g. "Hi there! 👋 How can I help you explore our services today?").
3. Starter Chips & Guided Conversation Flows
Starter chips and Guided Flows provide clickable conversational entry points displayed above the chat input box. They enable visitors to start conversations, explore pathways, or complete qualification journeys without typing on mobile keyboards.
Basic Chips
Single-click prompt pills. When tapped by a visitor, the text is immediately submitted as a user query to the AI agent (e.g. "What is your pricing?").
Nested Chips (Conversational Branching Trees)
Lightweight conversational menus. When clicked, a parent chip reveals sub-options or secondary choices (e.g. "Explore Real Estate" → ["View 2 BHK Apartments", "Schedule Site Visit"]).
- Type Selector: Fast dropdown toggle between
BasicandNestedchips in the dashboard. - Zero Whitespace Layout: Chips use tight
fit-contentwrapping without trailing empty space.
Guided Conversation Flows (Multi-Step Qualification & Routing)
Advanced deterministic intake journeys featuring up to 10 sequential steps, conditional branching trees, deep link sublink buttons, and anti-loop circuit breakers.
Each choice option can route to the default next step, jump to a specific step (e.g., Enterprise routing vs. Self-serve routing), or conclude the flow early.
Display external sublinks (e.g. checkout carts, calendars), 1-click CSAT survey rating stars, or seamless handoff directly into the AI agent prompt.
Regardless of whether a guided flow has 3, 5, or 10 question cards, the user progressing through the steps does not consume a credit on each tap. The entire completed intake is billed as exactly 1 single message credit upon completion.
The Combined 5-Item Budget & Plan Allocation
The chat widget renders a maximum of 5 combined interactive items on initial greeting. During onboarding, 3 AI chips are generated by default, leaving open slots for Guided Flows based on your plan:
- Free Plan: 1 Guided Flow (1 Flow + 3 Chips = 4 of 5 slots used).
- Limited Plan ($19/mo): 2 Guided Flows (2 Flows + 3 Chips = 5 slots full).
- Starter Plan ($49/mo): 3 Guided Flows (3 Flows + 2 Chips = 5 slots full).
- Growth / Scale ($149 - $399/mo): 5 Guided Flows (full capacity up to 5 flows).
- Enterprise: Unlimited Guided Flows (top 5 displayed in widget).
4. Localization & Multi-Lingual Engine
Configure default response languages and multi-lingual auto-translation.
Default Agent Language
Choose the default primary language for initial AI greetings and responses.
Supported Native Languages:
Dynamic Visitor Language Detection
Even if a default language is set, the AI agent dynamically detects the visitor's input language. If a user types in Japanese or German, the AI automatically replies natively in that exact language while translating knowledge base facts on the fly.
5. Widget Design Genres & Aesthetics
Domainchat offers 4 distinct Widget Design Genres, each featuring tailored color gradients, header badges, and modern Google Fonts typography:
Indigo Slate header gradient with clean Inter Sans geometric typography.
Royal Obsidian Gold metallic header, 4px metallic bar, Georgia Serif typography.
Floating Neo pill gradient header, Plus Jakarta Sans display typography.
Warm Emerald gradient header, Nunito rounded friendly typography.
6. Branding & Customization
Brand Color & Logo Upload
Choose your brand primary hex color for chat accents and upload a custom avatar logo displayed in the header.
Launcher Bubble Styles
Customize the floating launcher button in the bottom corner of your website:
- Standard Circular Icon (
rounded-full) - Rounded Rectangle Badge (
rounded-2xl) - Floating Pill Badge
- Custom Chat Bubble Models
7. Website Embed Code
To deploy your configured agent onto your live website, copy and paste the snippet into your website's <head> or before the closing </body> tag:
<script
src="https://www.domainchat.co/widget.js"
data-agent-id="YOUR_AGENT_ID"
async>
</script>