Help Center

How to use your AI agent

Learn how to train your agent with your company data and deploy it on your website or applications.

๐Ÿ”
Knowledge Base

Train your AI agent

Your AI agent learns from the documents you upload. The more relevant information you provide, the better it will answer your customers' questions. Claude AI automatically reads and understands your documents.

๐Ÿ’ก

How it works

When you upload a document, Claude AI reads and analyses it, creating a structured knowledge summary. When a customer asks a question, your agent searches this knowledge base first, then uses its general AI capabilities to provide a complete answer.

1

Go to Knowledge Base

From your dashboard, click Knowledge Base in the top navigation. This is where you manage all documents your agent learns from.

2

Upload your documents

Click the upload area or drag and drop your files. You can upload PDFs, Excel files, Word documents, CSV files and plain text files up to 10MB each.

Tip: Start with your most important documents โ€” product catalogue, FAQ, price list and company policy.
3

Wait for AI processing

Claude AI will read your document and create a knowledge summary. This usually takes 10โ€“30 seconds. The status will change from Processing to Ready.

4

Test your agent

Go to your chat and ask questions about the content you uploaded. Your agent should now answer using your specific company information.

Example: If you uploaded a price list, ask "What is the price of product X?" โ€” your agent will use your actual prices.
5

Keep documents updated

Delete outdated documents and upload new versions whenever your information changes. Your agent always uses the latest uploaded content.

File Formats

Supported formats

Your agent supports all common business document formats. Choose the format that best fits your content type.

๐Ÿ“„
PDF Documents
.pdf
Best for formal documents, reports and formatted content.
  • Product catalogues
  • Company brochures
  • Technical manuals
  • Contracts & policies
  • Annual reports
๐Ÿ“Š
Excel / CSV
.xlsx .xls .csv
Perfect for structured data, lists and tables.
  • Price lists
  • Product inventory
  • Service schedules
  • Contact directories
  • Data tables
๐Ÿ“
Word / Text
.docx .doc .txt
Ideal for written content, procedures and FAQs.
  • FAQ documents
  • Procedures & guides
  • Company descriptions
  • Scripts & responses
  • Meeting notes
โš ๏ธ

File limits

Maximum file size: 10MB per file. For very large documents, split them into smaller topic-focused files for better results. Scanned PDFs (images) may have reduced accuracy โ€” use text-based PDFs when possible.

Best Practices

Get better results

Follow these guidelines to maximise your agent's accuracy and usefulness.

โœ“ Do this
  • Use clear headings and sections
  • Include specific prices and dates
  • Write FAQs with question + answer format
  • Keep one topic per document
  • Use consistent product names
  • Include contact info and hours
  • Update documents regularly
โœ— Avoid this
  • Uploading scanned images as PDFs
  • Very long documents (100+ pages)
  • Mixing unrelated topics in one file
  • Using abbreviations without explanation
  • Outdated price lists or information
  • Confidential passwords or keys
  • Duplicate content across files
๐Ÿ’ก

Start with an FAQ document

Create a plain text file (.txt) with your 20 most common customer questions and their answers. This single document will dramatically improve your agent's accuracy.

Format: Q: What are your opening hours? A: We are open Monday to Friday, 9am to 6pm.
๐Ÿ’ก

Upload a company overview

A short text document describing your company, services, values and contact information helps your agent introduce your business correctly.

๐Ÿ’ก

Keep pricing current

Delete old price lists before uploading new ones. Customers asking about prices will get accurate answers if your documents are up to date.

Deployment

Add to your website

There are three ways to add your AI agent to any website. Choose the one that best fits your needs.

๐Ÿ’ฌ

JavaScript Widget (Recommended)

A floating chat button appears in the corner of your website. Visitors click it to open a chat window without leaving the page.

โœ“ Best for: All websites, e-commerce, landing pages
<script src="https://chat.theiaisland.com/widget.js" data-token="YOUR_TOKEN" data-color="#c9a84c"> </script>
Paste this code just before </body> in your HTML. Get your token from Widget & Embed.
๐Ÿ–ผ๏ธ

iFrame Embed

Embed the full chat interface directly inside your webpage. The agent appears as part of your page content.

โœ“ Best for: Dedicated support pages, help centres
<iframe src="https://chat.theiaisland.com/embed/TOKEN" width="400" height="600" frameborder="0" allow="microphone"> </iframe>
๐Ÿ”—

Direct Link

Share a direct URL to your agent. Add it to emails, WhatsApp, social media or any button on your website.

โœ“ Best for: Email signatures, social media, QR codes
https://chat.theiaisland.com/embed/YOUR_TOKEN
You can add this link to a button: <a href="YOUR_LINK">Chat with us</a>
โš™๏ธ

WordPress

Add the JavaScript widget to any WordPress site using a plugin or the theme editor.

โœ“ Best for: WordPress websites
1. Go to Appearance โ†’ Theme Editor
2. Open footer.php
3. Paste the widget code before </body>
4. Save and visit your site
Desktop

Use on desktops & computers

Your agent works on any device with a browser. Here are the best ways to give your team or customers quick access.

๐Ÿ–ฅ๏ธ

Browser shortcut (Windows & Mac)

The easiest way โ€” open your agent link in Chrome or Edge, then add it as a desktop shortcut.

Chrome: Open your agent URL โ†’ Click โ‹ฎ menu โ†’ More tools โ†’ Create shortcut โ†’ Check "Open as window" โ†’ Create

Edge: Open your agent URL โ†’ Click ยทยทยท menu โ†’ Apps โ†’ Install this site as an app
๐Ÿ“Œ

Pin to taskbar

After creating a browser shortcut, right-click the app icon on your desktop and select "Pin to taskbar" for one-click access.

๐Ÿ”–

Browser bookmark

Press Ctrl+D (Windows) or Cmd+D (Mac) when viewing your agent to save it as a bookmark for quick access.

๐Ÿ“ฑ

Mobile (iOS & Android)

Open your agent link in Safari (iOS) or Chrome (Android), then use "Add to Home Screen" to create a mobile app icon.

iOS Safari: Tap the Share button โ†’ Add to Home Screen
Android Chrome: Tap โ‹ฎ menu โ†’ Add to Home screen
๐Ÿ‘ฅ

Share with your team

Send your direct agent link to all team members. They can access it from any browser without any installation needed.

Your agent link: https://chat.theiaisland.com/embed/YOUR_TOKEN โ€” get it from Widget & Embed
API

API integration

Connect your agent to any application, CRM or custom software using our REST API. Available on Pro and Enterprise plans.

๐Ÿ”‘

Getting your API token

Go to Widget & Embed โ†’ API Access tab to find your personal API token. Keep it secret โ€” do not share it publicly.

1

Send a message to your agent

POST https://chat.theiaisland.com/api/chat Content-Type: application/json Authorization: Bearer YOUR_TOKEN { "message": "What are your prices?", "session_id": "customer_unique_id" }
2

Receive the response

{ "reply": "Our Basic plan is โ‚ฌ25/month...", "conversation_id": "abc123" }
3

Maintain conversation context

Use the same session_id for messages from the same user. The agent will remember the conversation context.

FAQ

Frequently asked questions

Quick answers to the most common questions.

How long does document processing take? +
Most documents are processed in 10โ€“30 seconds. Larger files (5โ€“10MB) may take up to 2 minutes. The status will show "Processing" and then change to "Ready" automatically.
Can my agent answer in multiple languages? +
Yes! Your agent automatically detects the language your customer writes in and responds in the same language. Supported: English, Spanish, German, Italian, French and Portuguese. You can upload documents in any of these languages.
Is my data private and secure? +
Yes. Your documents are private โ€” only your agent uses them. No other user or agent can access your knowledge base. Data is stored on European servers with SSL encryption.
How many documents can I upload? +
Basic plan: up to 10 documents. Pro plan: unlimited documents. Enterprise: unlimited with priority processing.
What happens when my trial ends? +
After 3 days, you will be redirected to the pricing page. Your documents and conversation history are saved for 30 days. Choose a plan to continue using your agent.
Can I customise the agent's name and personality? +
Yes, on Pro and Enterprise plans you can set a custom agent name, upload a custom avatar and define the agent's personality and tone. Go to Settings in your dashboard.
My agent doesn't know the answer โ€” what can I do? +
Upload a document that contains the answer. Create an FAQ file (.txt) with questions and answers about the topics your customers ask most. The more specific information you provide, the better your agent will perform.
Support

Need more help?

Our team is here to help you get the most out of your AI agent.

โœ‰๏ธ

Email support

Send us your question and we'll respond within 24 hours.

info@theiaisland.com
๐Ÿ’ฌ

Chat with Theia

Ask our own AI agent โ€” it knows the platform well and can answer most questions instantly.