🎉 Get 20% off forever with "EARLY20"Claim Offer

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:

1

Create an Organization

Sign up and your organization is automatically created

2

Create a Bot

Configure your AI assistant with a name and system prompt

3

Add Data Sources

Crawl your website or upload documents to build your knowledge base

4

Deploy the Widget

Copy the embed code and add it to your website

Quick Setup

Get started in under 5 minutes:

  1. Go to Dashboard and sign in
  2. Click "Create Assistant" in the AI Assistants section
  3. Give your bot a name and configure its personality
  4. Navigate to Data Sources and click "Add Source"
  5. Choose Website and enter your URL to crawl
  6. Assign the data source to your bot
  7. Go to your bot's SettingsWidget tab
  8. 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.

TypeDescriptionAvailability
WebsiteCrawl public web pagesStarter+
DocumentUpload PDF, Word, Excel, PowerPointBasic+
ManualQ&A pairs from chat history reviewAll 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

  1. Go to Chat History in the dashboard
  2. Find a conversation with a good Q&A exchange
  3. Click "Add to Training" on the message
  4. Edit the question and answer as needed
  5. 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.

1

Allow your website domain

Before the widget will work on your site, you need to add your domain to the allowed origins list:

  1. Go to your bot's Settings page in the dashboard
  2. Scroll to the Allowed Origins section
  3. Add your website domain (e.g., https://yourwebsite.com)
  4. 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.

2

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.

OptionDescription
Positionbottom-right, bottom-left
Brand ColorPrimary color for the widget header and button
Theme Modelight, dark, or auto (follows system)
Button SizeSize of the floating chat button (default: 68px)
AvatarCustom avatar image or initials
Initial MessageThe 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.

Need Help?

Community Support

Join our Discord community for help and discussions.

Join Discord →

Direct Support

Contact our team directly for technical questions.

Email Support →