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

# Chatbot Overview

> Learn how Cosmo's Chatbot channel answers visitors on your website

## What is the Chatbot?

The Chatbot is Cosmo's website channel. It adds an AI-powered chat widget to your site so visitors can ask questions, get support, and interact with your brand without waiting for a human reply.

<Tip>
  Cosmo uses one AI agent across the Chatbot, Voicebot, and Receptionist Avatar. The Chatbot is the channel most teams deploy first.
</Tip>

## Channels

Cosmo by Humanizing supports three channels:

| Channel                 | Description                                                                                                                                         | Deployment                                         |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Chatbot**             | A chat widget embedded on your website. Visitors click the chat bubble to ask questions, get support, and interact with your brand.                 | Embed script on any website                        |
| **Voicebot**            | A phone channel that answers calls, speaks naturally, uses your knowledge base, and can route or hand off conversations.                            | Assigned phone number or forwarded business number |
| **Receptionist Avatar** | A kiosk-based front desk experience for offices, hotels, and lobbies. Greets visitors, searches contacts, and manages check-ins with a guided flow. | Public URL on a tablet or touchscreen              |

<Note>
  You manage the same AI agent across these channels. Each channel has its own setup, styling, and deployment options.
</Note>

### Chatbot

The Chatbot powers an embeddable chat widget with:

* RAG-powered responses from your knowledge base (web pages, text, Q\&A pairs)
* 3D avatar with text-to-speech
* Customizable themes, colors, and widget positioning
* Deploy with one line of embed code

See the [Chatbot Onboarding](/agents/onboarding) guide for setup instructions.

### Receptionist Avatar

The Receptionist Avatar is designed for physical locations. It provides:

* Multi-screen kiosk flow (language selection, visit type, contact search, calling, confirmation)
* Employee contact directory with CSV import
* Multilingual visitor welcome in 45+ languages
* Portrait and landscape kiosk orientations
* Deploy via a simple public URL (`/a/[publicKey]`) on any touchscreen

See the [Receptionist Avatar Overview](/receptionist/overview) for full documentation.

## Core Concepts

### Knowledge Base

Cosmo has a **knowledge base** - a collection of information sources that the AI agent uses to answer questions. Your knowledge base can include:

| Source Type      | Description                                         | Best For                                 |
| ---------------- | --------------------------------------------------- | ---------------------------------------- |
| **Web Sources**  | Pages from your website imported via URL or sitemap | Product pages, documentation, blog posts |
| **Text Sources** | Custom written content you provide                  | Company policies, internal knowledge     |
| **Q\&A Sources** | Specific question-answer pairs                      | FAQs, common support queries             |

The more relevant content you add to your knowledge base, the more helpful Cosmo becomes across every channel.

### Avatar

Cosmo can use a **3D avatar** in visual channels such as the Chatbot and Receptionist Avatar. Avatars:

* Animate and speak responses using text-to-speech
* Create a more engaging, human-like experience
* Can be customized to match your brand personality

### System Prompt

The **system prompt** defines Cosmo's personality, behavior, and response style. You can customize:

* The AI agent's name and role
* How it greets users
* Its communication style (formal, friendly, technical)
* Specific instructions for handling certain topics

### Widget

The **widget** is the chat interface that appears on your website. It's how visitors interact with your agent. The widget includes:

* A chat bubble that opens the conversation
* A message input area
* The avatar display
* Language and voice options for visitors

## Chatbot Lifecycle

<Steps>
  <Step title="Create">
    Create your AI agent through the onboarding wizard by entering your website domain. Cosmo will automatically discover and suggest content to import.
  </Step>

  <Step title="Train">
    Add knowledge sources to teach Cosmo about your business. Import web pages, add custom text, and create Q\&A pairs for common questions.
  </Step>

  <Step title="Customize">
    Configure Cosmo's appearance, behavior, and widget styling. Choose an avatar, set colors, and write the perfect system prompt.
  </Step>

  <Step title="Deploy">
    Generate an embed script and add it to your website. Your Chatbot is now live and ready to help visitors.
  </Step>

  <Step title="Monitor">
    Track conversations, view analytics, and continuously improve Cosmo based on visitor interactions.
  </Step>
</Steps>

## Key Features

<CardGroup cols={2}>
  <Card title="RAG-Powered Responses" icon="magnifying-glass">
    Cosmo uses Retrieval-Augmented Generation (RAG) to find relevant content from your knowledge base and generate accurate, contextual responses.
  </Card>

  <Card title="Multi-Language Support" icon="globe">
    Serve visitors in their preferred language with built-in localization support for the widget interface.
  </Card>

  <Card title="Conversation History" icon="clock-rotate-left">
    Review past conversations to understand what visitors are asking and how your agent is responding.
  </Card>

  <Card title="Analytics Dashboard" icon="chart-line">
    Track usage metrics, conversation volumes, and identify popular topics to optimize your agent.
  </Card>
</CardGroup>

## Agent vs Workspace

Understanding the relationship between agents and workspaces:

| Concept       | Description                                                                                                                                                     |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Workspace** | A container for organizing AI agents and managing team access. Each workspace can have multiple agents and members.                                             |
| **AI agent**  | The shared assistant that powers Cosmo's Chatbot, Voicebot, and Receptionist Avatar channels. Each agent has its own knowledge base, settings, and deployments. |

<Note>
  You can create multiple AI agents within a single workspace - for example, one for sales inquiries and another for technical support, each trained on different content.
</Note>

## Best Practices

<AccordionGroup>
  <Accordion icon="book" title="Start with quality content">
    Focus on adding accurate, helpful content to your knowledge base. Well-written source material leads to better responses.
  </Accordion>

  <Accordion icon="flask" title="Test before deploying">
    Use the Playground to test Cosmo with real questions before deploying to your website. Refine your system prompt based on responses.
  </Accordion>

  <Accordion icon="arrows-rotate" title="Iterate and improve">
    Review conversations regularly to identify gaps in your knowledge base. Add new content to address common questions Cosmo couldn't answer.
  </Accordion>

  <Accordion icon="bullseye" title="Keep prompts focused">
    Write clear, specific system prompts that define exactly how your agent should behave. Avoid overly broad instructions.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create a Chatbot" icon="sparkles" href="/agents/onboarding">
    Follow our step-by-step guide to create and configure a website chatbot.
  </Card>

  <Card title="Create a Receptionist Avatar" icon="building" href="/receptionist/overview">
    Set up an AI-powered front desk experience for visitor management.
  </Card>

  <Card title="Add Knowledge Sources" icon="database" href="/sources/overview">
    Learn how to train Cosmo with web pages, text, and Q\&A content.
  </Card>

  <Card title="Deploy to Your Website" icon="code" href="/agents/deployment">
    Get the embed code and go live with your Chatbot.
  </Card>
</CardGroup>