Documentation
Learn how to set up and use Taros AI assistants for your business
Overview
Taros is an AI-powered assistant platform that lets you create intelligent chatbots trained on your own content. Deploy them on your website to provide instant, accurate answers to your customers.
Website Crawling
Automatically crawl your website to train your assistant
Document Upload
Upload PDFs, Word docs, and more to your knowledge base
Chat Widget
Embed a customizable chat widget on your website
How It Works
Setting up Taros involves four main steps:
Create an Organization
Sign up and your organization is automatically created
Create a Bot
Configure your AI assistant with a name and system prompt
Add Data Sources
Crawl your website or upload documents to build your knowledge base
Deploy the Widget
Copy the embed code and add it to your website
Quick Setup
Get started in under 5 minutes:
- Go to Dashboard and sign in
- Click "Create Assistant" in the AI Assistants section
- Give your bot a name and configure its personality
- Navigate to Data Sources and click "Add Source"
- Choose Website and enter your URL to crawl
- Assign the data source to your bot
- Go to your bot's Settings → Widget tab
- Copy the embed code and paste it into your website
Tip: Start with a single-page crawl to test, then expand to full-site crawling once you're happy with the results.
Data Sources Overview
Data sources are the knowledge base for your AI assistants. You can add multiple data sources and assign them to different bots.
| Type | Description | Availability |
|---|---|---|
| Website | Crawl public web pages | Starter+ |
| Document | Upload PDF, Word, Excel, PowerPoint | Basic+ |
| Manual | Q&A pairs from chat history review | All plans |
Website Crawling
Crawl your website to automatically build a knowledge base from your existing content.
Crawl Modes
Single Page
Crawls only the exact URL you provide. Best for testing or specific pages.
Full Site
Follows links to crawl multiple pages. Depth and page limits depend on your plan.
Note: Only publicly accessible pages can be crawled. Pages behind login walls will not be indexed.
Document Upload
Upload documents to train your assistant with specific content like manuals, guides, or FAQs.
Supported Formats
- PDF (.pdf)
- Word (.doc, .docx)
- Excel (.xls, .xlsx)
- PowerPoint (.ppt, .pptx)
- Plain text (.txt)
After uploading, you can edit the extracted text directly in the dashboard to correct any OCR errors or remove unwanted content.
Tip: Document upload requires a Basic plan or higher.
Manual Training
Create high-priority Q&A pairs by reviewing chat conversations. These have 3x priority over regular content.
How to Add Manual Training
- Go to Chat History in the dashboard
- Find a conversation with a good Q&A exchange
- Click "Add to Training" on the message
- Edit the question and answer as needed
- Save to add it to your knowledge base
You can view and manage all manual training data from the Data Sources page by clicking on the manual training data source.
Bot Settings
Configure your bot's behavior in the Settings page. Key options include:
System Prompt
Define your bot's personality, tone, and scope. Choose from templates or customize under Advanced Settings.
AI Provider & Model
Select from Mistral, OpenAI, or Anthropic providers and choose the model that fits your needs.
Allowed Origins
Restrict which domains can embed your chat widget for security (paid plans only).
Product Search
Enable real-time product search to let your bot find and display products from your website.
Enable Product Search
Toggle this on to allow your bot to search your website for products when users ask about them.
Search URL
Provide a search URL with {query} as a placeholder for the search term.
https://yourshop.com/search?q={query}AI Settings
Choose your AI provider and model to power your assistant.
AI Providers
Mistral AI
European open-source models. Available on all plans.
OpenAI
GPT models. Requires Pro plan or higher.
Anthropic
Claude models. Requires Pro plan or higher.
Knowledge Instructions
Found under Advanced Settings, you can provide specific instructions for how the AI should use retrieved knowledge. For example:
Use only the retrieved context. Do not guess or use outside knowledge.
If the answer is not in the context, say "I don't have information about that."Fallback Behavior
Configure how your bot handles situations where it can't find relevant information.
Allow Unverified Answers
When enabled, the bot can answer using general knowledge even without matching context. When disabled, it will only answer from your knowledge base.
No Knowledge Fallback Message
Custom message shown when no relevant knowledge is found and unverified answers are disabled.
Embedding the Widget
Add the Taros chat widget to your website in two simple steps.
Allow your website domain
Before the widget will work on your site, you need to add your domain to the allowed origins list:
- Go to your bot's Settings page in the dashboard
- Scroll to the Allowed Origins section
- Add your website domain (e.g.,
https://yourwebsite.com) - Click Save
The widget won't load if your domain isn't in the allowed origins list. This is a security feature to prevent unauthorized use.
Add the embed code to your website
Copy the embed code from your bot's Widget settings and paste it into your website's HTML, just before the closing </body> tag:
<script data-bot="YOUR_BOT_ID" data-mode="bubble" src="https://widgets.taros.ai/widget.js"></script>You can find the exact code with your bot ID in the Widget Customizer tab of your bot's settings.
That's it! Once both steps are complete, the chat widget will appear on your website. Visitors can click it to start chatting with your AI assistant.
Widget Customization
Customize the widget appearance to match your brand.
| Option | Description |
|---|---|
| Position | bottom-right, bottom-left |
| Brand Color | Primary color for the widget header and button |
| Theme Mode | light, dark, or auto (follows system) |
| Button Size | Size of the floating chat button (default: 68px) |
| Avatar | Custom avatar image or initials |
| Initial Message | The greeting message shown when users first open the chat |
All customization options are available in the Widget Customizer tab of your bot's settings page.
API Authentication
Coming Soon: API key management will be available in the dashboard soon. Contact support if you need API access now.
Use API keys to authenticate requests to your bot programmatically.
Using the API Key
curl -X POST https://api.taros.ai/v1/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Hello, how can you help me?"}'Security: Never expose API keys in client-side code. Use server-side requests or environment variables.
Chat Endpoint
Send messages to your bot and receive AI-powered responses.
Request
POST /v1/chat
{
"message": "What are your business hours?",
"conversationId": "optional-conversation-id",
"language": "en"
}Response
{
"response": "Our business hours are Monday to Friday, 9 AM to 5 PM.",
"conversationId": "conv_abc123",
"sources": [
{
"title": "Contact Page",
"url": "https://example.com/contact"
}
],
"contextReliability": "high"
}Plans & Limits
Taros offers several plans to fit your needs:
Starter
1 assistant, 1 website data source, ~1,000 message credits/month. No document uploads. Great for trying out Taros with a free trial.
Basic
Up to 3 assistants, unlimited data sources, document uploads enabled, ~5,000+ message credits/month. Good for small businesses.
Pro
Up to 10 assistants, unlimited data sources, advanced analytics, team members, API integrations, ~50,000+ message credits/month.
Enterprise
Custom limits, SSO, dedicated support, isolated data storage, custom hosting options. Learn more.
View full plan details and pricing on the Pricing page.

