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 Sparkles button 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 Basic and Nested chip types.
  • Zero Whitespace Layout: Chips use tight fit-content wrapping around text without trailing empty space.
Pro Tip: Add up to 3-4 high-intent starter chips (like "Book a Demo" or "Calculate Pricing") to double user engagement rates on your website.

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:

🇺🇸 English (English)
🇪🇸 Español (Spanish)
🇫🇷 Français (French)
🇩🇪 Deutsch (German)
🇮🇳 हिन्दी (Hindi)
🇮🇹 Italiano (Italian)
🇵🇹 Português (Portuguese)
🇨🇳 中文 (Chinese)
🇯🇵 日本語 (Japanese)
🇰🇷 한국어 (Korean)
🇷🇺 Русский (Russian)
🇸🇦 العربية (Arabic)

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:

1. Classic ModernMODERN ⚡

Indigo Slate header gradient with clean Inter Sans geometric typography.

2. Elite LuxuryELITE VIP ♛

Royal Obsidian Gold metallic header, 4px metallic bar, Georgia Serif typography.

3. Fashionable NeoNEO ✨

Floating Neo pill gradient header, Plus Jakarta Sans display typography.

4. Elite & FriendlyOnline • Here to help 👋

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>