Train your bot
From uploading documents to a Ready bot.
Training turns your uploaded documents into a knowledge base the bot can search. A bot can answer only after it has been trained on its current documents.
Bot status reference
Every bot has a status, shown on the Dashboard and the bot detail page. It tells you whether the bot can chat and what to do next.
| Status | What it means | What to do next |
|---|---|---|
| No documents | The bot exists but has no documents yet | Add documents from Create a bot |
| Not trained | Documents are uploaded but the bot has not been trained yet | Start training |
| Training | Training is queued or running | Wait and watch progress |
| Ready | The bot is trained on its current documents | Open Chat Workspace and ask questions |
| Needs retraining | Documents changed since the last training | Train the bot again |
How the status changes
- Uploading the first documents moves No documents to Not trained and starts training on its own.
- Training moves the bot to Training, then to Ready when it finishes.
- Adding or deleting a document on a Ready bot moves it to Needs retraining.
- Training again moves it back through Training to Ready.
- If training fails or you cancel it, the bot returns to the status it had before.
How to start training
A bot's first upload starts training with the selected document reader. Train it yourself after its documents change, or when that first training could not start, for example because daily credits ran out.
Open Training sources
On the bot detail page, open the Training sources tab. Your documents are listed at the top; the Training panel sits beside them, or below on narrow windows.
Choose a document reader
In Document reader, pick how Pegasus reads your files. See Choose a document reader.
Click Train bot
Pegasus confirms with "Training started. The bot will be ready shortly."
When you cannot click Train bot, the Training panel says why below the button:
| Message | What to do |
|---|---|
| Upload at least one document to train the bot. | Add a document first. |
| The bot is up to date. Train again after you add or remove documents. | Nothing; the bot is already Ready. |
| Training actions are unavailable while this workspace is read-only. | See Read-only state. |
| Wait for the current document or training operation to finish. | Wait for the upload or training to finish. |
| This reading method needs a Pro or Ultra plan. | Choose another document reader, or upgrade. |
See Cannot train this bot for more.
Training uses credits based on document size. Before training many documents, check that you have enough daily credits.
What happens, in order
Prepare
Pegasus checks which documents are new, changed, or removed since the last training. Only those are processed.
Read
The document reader you chose extracts the text from each new or changed document.Index
The text is split into passages and indexed so the bot can find the right parts.Finish
The bot becomes Ready, Pegasus shows "Bot is now ready to chat!", and the Training panel offers Start chat.
Watching progress
While the bot is Training, the Training panel shows progress:
- "Waiting in queue (position {position})" - other training jobs are ahead of yours.
- "Next in line" - your job starts as soon as a slot opens.
- "Preparing documents…" - Pegasus is checking what changed.
- "Reading documents…" - Pegasus is extracting text.
- "Indexing documents…" - Pegasus is building the bot's index.
- "Retrying (attempt {attempt})…" - a temporary error occurred and Pegasus is retrying on its own.
You can leave the page while training runs; it keeps going in the background.
Cancelling a training
While the bot is Training, the panel shows a Cancel button. Pegasus asks "Cancel training?" before stopping it.
- If queued: the job is removed right away.
- If running: training stops after the current file.
Choose Cancel training to stop, or Keep training to let it finish. After a cancel, the bot returns to its previous status.
First training vs retraining
- First training reads and indexes every document, so it is usually the slowest run.
- Retraining processes only what changed: new, removed, or changed files.
That is why later runs are often much faster.
Needs retraining
A bot shows Needs retraining when its documents change after a successful training, for example when you upload or delete a document.
While a bot needs retraining, it does not answer in chat, in the website widget, or through the API. Finish your document changes, then train the bot again to make it Ready.
Can you chat in each status?
| Status | Can you chat? |
|---|---|
| No documents | No - the bot has no knowledge |
| Not trained | No - it has not been trained |
| Training | No - training is in progress |
| Ready | Yes - click Start chat in the Training panel |
| Needs retraining | No - train it again to include the new changes |
If you chat with a bot that is not ready, Pegasus shows "Bot is not ready for chat." See Bot is not ready for how to fix it.
Training failures
When a training run fails:
- Pegasus shows "Training failed. Please try again.", or a message that explains the cause if it is known.
- The Training panel shows "Training failed. Updating status…" with the same reason.
- The bot returns to its previous status.
- You are not charged the full credit cost; only the work already done counts.
See Training failed for more help.
Daily credit limit
Training uses the same daily credits as chat. If today's credits are used up, Pegasus does not start training and shows a daily credit limit message.
Wait for credits to refill or upgrade your plan, then train again. See Credits and limits.