Skip to content

Knowledge

Your assistant answers only from the knowledge you add: your website, documents, an FAQ table, text you write or photos you upload. Every answer points back to the source it came from, and can show the images that go with it.

Updated

On this page

Five kinds of knowledge

#
Knowledge source types
TypeBest forLimits
WebsiteHelp centres, product and policy pagesUp to 5000 pages per source
FilesBrochures, manuals, price lists, policiesPDF, DOCX, MD, TXT, CSV, HTML; up to 25 MB each, 20 per upload
FAQShort, exact answers to common questionsQuestion up to 1000 and answer up to 10,000 characters; CSV import up to 500 rows
TextAnything not published elsewhere, written in MarkdownUp to 200,000 characters
ImagesProduct photos, floor plans, diagrams, screenshots, each with a title and descriptionJPEG, PNG, WebP, GIF, HEIC; up to 10 MB each, 50 per upload

Add knowledge from the bot's Knowledge tab with Add knowledge. Indexing uses your own embedding key; content that has not changed is not embedded again, so re-syncs cost almost nothing.

Crawl a website

#
Website source fields
FieldWhat it does
Website URLWhere crawling starts; links on the same site are followed
Crawl scopeWhole site, only pages under this path, or this page only
Max pages1 to 5000 (default 200)
Re-crawlManually, every day or every week
Include patternsOnly crawl matching pages, one per line; ** matches any path, for example /help/**
Exclude patternsSkip matching pages, for example **/print/** or /blog/**
JavaScript renderingAutomatic, Never (plain HTML) or Always, for sites that only show content after scripts run
  • robots.txt is always respected, and pages marked noindex are skipped. The crawler identifies itself as KothadeskBot, so you can allow or block it by that name.
  • Sitemaps on your site are found and used automatically.
  • Pages behind a login cannot be crawled. Upload them as files or paste them as text instead.
  • A page that disappears from your site stays in use until two full crawls in a row miss it, or it returns 404.

FAQ tables

#

Each FAQ entry is kept whole and ranks above crawled text, so FAQs are the most reliable way to get an exact answer, such as a price, a timing or a policy. Edit entries in the table or import a CSV.

faq.csv
question,answer,url,category
What are your opening hours?,"Monday to Saturday, 9 am to 8 pm. Closed on Sundays.",https://example.com/contact,Visiting
Do you accept UPI?,"Yes, we accept UPI, cards and cash.",,Payments

Columns question and answer are required; url (linked from the answer's source) and category are optional. Tick Replace all existing entries to overwrite the table instead of adding to it.

To attach a picture to an answer, add it in Markdown: ![Size chart for kurtas](https://yourshop.com/img/size-chart.png "Kurta sizes"). The alt text replaces the image in the answer text, and the picture itself can be shown with the answer.

Images in answers

#

When a picture helps, the assistant shows it inside the answer, right after the sentence it illustrates, with its caption and a link to where it came from. Visitors tap it to see it full size. It only uses images from your own knowledge, never from elsewhere, and shows at most the number you allow per answer (2 by default, up to 3).

Where images come from
SourceImages taken
WebsitePictures in the page content, with their alt text, caption and nearby heading. Images in menus, headers and footers are ignored.
FilesPictures inside PDFs and Word (DOCX) files, and images linked from Markdown files
TextImages written in Markdown, such as ![alt](https://…)
FAQMarkdown images inside answers
ImagesEvery photo you upload, with the title and description you give it
  • Images are copied into Kothadesk's storage when a source syncs, so answers keep working if your site changes. They count towards your plan's knowledge storage; the same picture used on many pages is stored once.
  • Skipped automatically: icons, logos, SVGs, avatars, tracking pixels, images smaller than 120 px, and images repeated on so many pages that they are decoration (shown as Repeated on many pages).
  • Up to 20 images per page or file and 2000 per source are kept, in reading order.
  • Turn extraction and display on or off per bot under Bot settings, Retrieval, Images.

Tip: Images are found by their words: alt text, caption, title and description. A photo named IMG_2041.jpg with no alt text is nearly invisible to search. Write alt text on your site, or turn on Describe images with AI in Bot settings.

Upload photos as an Images source

#
  1. 01

    Add knowledge, Images

    Give the source a name, then drop up to 50 photos (JPEG, PNG, WebP, GIF or HEIC, up to 10 MB each).

  2. 02

    Title and describe each photo

    A title is suggested from the file name. Describe what the picture shows in the words a visitor would use, for example “Red 2024 hatchback, front view, alloy wheels” or “2 BHK floor plan, 950 sq ft, east facing”.

  3. 03

    Upload

    Each photo becomes one document with one searchable entry. Uploaded originals are re-encoded and stripped of location and camera data.

Review, hide and describe images

#

Open any source and choose the Images tab to see every image taken from it, with its alt text, caption, your description, the AI description and the document it came from. Filter by description status.

Image description status
StatusMeaning
Has a descriptionAlt text, a caption, a title or your description already says what it shows
Waiting for AI descriptionQueued for Describe images with AI; usually done within minutes
Described by AIThe bot's own AI key wrote a short description
No description (AI off)No usable text and AI descriptions are off for this bot
Model can't read imagesThe bot's chat model is not vision-capable; choose one that is, then Describe with AI
Monthly AI limit reachedThe bot described 2000 images this month; the rest wait
AI key rejectedThe provider refused the key; fix it under Model providers
AI description failedThe provider kept failing; try Describe with AI again later
  • Hide an image to stop it appearing in answers without deleting it, for example an out-of-date photo. Show brings it back.
  • Edit description to add or correct your own words; it is used ahead of the AI description.
  • Describe with AI asks the bot's own key for a description of one image.
  • Re-extract images reprocesses the whole source, for example after turning on Extract images from sources. Text that has not changed is not embedded again.

Keep knowledge up to date

#
  • The list shows each source's type, documents, status and last sync, and refreshes by itself while indexing runs.
  • Re-sync a website at any time, or Cancel sync if you started the wrong one.
  • Switch a source off to stop using it for answers without deleting it.
  • Open a source to see every document with its status, chunks and when it was indexed, and the history of sync jobs with any errors.
  • Answers keep working while a source re-indexes: each document is swapped in only when it is ready.
  • Deleting a source stops it being used at once, then removes its documents and files in the background. This cannot be undone.
Why a document fails
ProblemFix
A scanned PDF with no textExport it with a text layer, or paste the text as a Text source
Very large filesPDFs up to 1000 pages and CSVs up to 100,000 rows are read
Your embedding key was rejectedFix the key under Model providers, then re-sync
The plan's document or storage limitRemove unused sources or ask about a larger plan

How answers cite your knowledge

#

Answers carry numbered markers such as [1] and a Sources list. Website sources link to the page, FAQ entries to their url if you set one; text sources have no link. An image in an answer shows the citation number of its source when the answer cites that source. Choose how citations appear in Bot settings. When nothing in your knowledge answers a question, the assistant says so instead of guessing.

Content that answers well

#
  • Use clear headings: one topic per section. Headings help the assistant find the right passage.
  • Write numbers exactly: "Returns within 7 days of delivery", not "about a week". Exact numbers let the promises check allow the answer.
  • Use the words customers use as well as your own terms: "cancel my plan" as well as "subscription termination".
  • Put common questions in an FAQ table with short, complete answers.
  • Remove outdated pages with exclude patterns so old prices never appear.
  • Add the question to an evaluation set whenever you fix a wrong answer.

Worked examples

#

Online shop

Help centre, exact policies and product photos

Accurate answers on delivery, returns and payment without crawling thousands of product pages, with a photo when a visitor asks what something looks like.

  • Website: https://yourshop.com/help, scope Only pages under this path, re-crawl every week.
  • Exclude patterns: /products/**, /cart/**, /account/**.
  • FAQ: delivery charges, return window, COD availability, UPI and card payments. Add the size chart image to the sizing answer in Markdown.
  • Images: the 40 bestsellers, each titled with the product name and colour, described with fabric and fit.

Asked “Do you have the cotton kurta in blue?”, the assistant answers from the product text and shows the indigo kurta photo under that sentence, captioned, with Source: Product photos.

Clinic or bookings

A brochure and a doctor timetable

Answer which doctor is available when, and what a consultation costs.

  • Files: the clinic brochure (PDF) and the OPD timetable (CSV). The brochure's map and floor plan come along as images, so “where is the X-ray room?” can show the plan.
  • FAQ: consultation fees, parking, insurance and cashless partners.
  • Update the timetable file whenever it changes: upload the new version and delete the old one.

Software company

Documentation with a changelog

Answer how-to questions from the docs, without old release notes confusing answers.

  • Website: https://docs.yourapp.com, whole site, max pages 2000, re-crawl every day.
  • Exclude patterns: /changelog/** and /v1/** for the retired version.
  • Text: an internal note on known issues and workarounds that is not on the public site.

Coaching institute

Courses, fees and batches

Answer course and fee questions exactly, in English and Hindi.

  • Website: the course pages. FAQ: fee structure, instalments, scholarship rules and batch timings per centre.
  • Add Hindi versions of key FAQ entries, for example "JEE ki fees kitni hai?", so Hinglish questions match directly.