Documentation Index
Fetch the complete documentation index at: https://docs.humanizing.com/llms.txt
Use this file to discover all available pages before exploring further.
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.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 |
You manage the same AI agent across these channels. Each channel has its own setup, styling, and deployment options.
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
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
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 |
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
Create
Create your AI agent through the onboarding wizard by entering your website domain. Cosmo will automatically discover and suggest content to import.
Train
Add knowledge sources to teach Cosmo about your business. Import web pages, add custom text, and create Q&A pairs for common questions.
Customize
Configure Cosmo’s appearance, behavior, and widget styling. Choose an avatar, set colors, and write the perfect system prompt.
Deploy
Generate an embed script and add it to your website. Your Chatbot is now live and ready to help visitors.
Key Features
RAG-Powered Responses
Cosmo uses Retrieval-Augmented Generation (RAG) to find relevant content from your knowledge base and generate accurate, contextual responses.
Multi-Language Support
Serve visitors in their preferred language with built-in localization support for the widget interface.
Conversation History
Review past conversations to understand what visitors are asking and how your agent is responding.
Analytics Dashboard
Track usage metrics, conversation volumes, and identify popular topics to optimize your agent.
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. |
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.
Best Practices
Start with quality content
Start with quality content
Focus on adding accurate, helpful content to your knowledge base. Well-written source material leads to better responses.
Test before deploying
Test before deploying
Use the Playground to test Cosmo with real questions before deploying to your website. Refine your system prompt based on responses.
Iterate and improve
Iterate and improve
Review conversations regularly to identify gaps in your knowledge base. Add new content to address common questions Cosmo couldn’t answer.
Keep prompts focused
Keep prompts focused
Write clear, specific system prompts that define exactly how your agent should behave. Avoid overly broad instructions.
Next Steps
Create a Chatbot
Follow our step-by-step guide to create and configure a website chatbot.
Create a Receptionist Avatar
Set up an AI-powered front desk experience for visitor management.
Add Knowledge Sources
Learn how to train Cosmo with web pages, text, and Q&A content.
Deploy to Your Website
Get the embed code and go live with your Chatbot.