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 (Quick Action Prompts)
Starter chips are clickable prompt pills displayed above the message input box. They help visitors start conversations instantly without typing.
Basic Chips
Single-click question prompts. When clicked by a user, the text is immediately sent as a chat query (e.g. "What is your pricing?").
Nested Chips (Conversational Branching Trees)
Multi-step conversational trees. When clicked, a parent chip reveals sub-options or secondary choices (e.g. "Explore Real Estate" → ["View 2 BHK Apartments", "Schedule Site Visit"]).
- Radix Type Selector: Seamless dropdown to toggle between
BasicandNestedchip types. - Zero Whitespace Layout: Chips use tight
fit-contentwrapping around text without trailing empty space.
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>