For now, our Knowledge Base only supports documents written in English and works best for conversations in English.We’ll be expanding our Knowledge Base language support soon!
Getting Started With Your Knowledge Base
To leverage the Knowledge Base, you will need to upload documents or website URLs that you intend to reference from in conversations. Let’s walk through how to upload your documents and use them in a conversation.You can either use our Developer Portal or API endpoints to upload and manage your documents.
Our Knowledge Base supports creating documents from an uploaded file or a website URL.
1
Step 1: Ensure Website Resources are Publicly Accessible
For any documents to be created via website URL, please make sure that each document is publicly accessible without requiring authorization, such as a pre-signed S3 link.For example, entering the URL in a browser should either:
- Open the website you want to process and save contents from.
- Open a document in a PDF viewer.
- Download the document.
2
Step 2: Upload your Documents
You can create documents using either the Developer Portal or the Create Document API endpoint.If you want to use the API, you can send a request to Tavus to upload your document.Here’s an example of a The response from this POST request will include a
POST
request to tavusapi.com/v2/documents
.document_id
- a unique identifier for your uploaded document. When creating a conversation, you may include all document_id
values that you would like the persona to have access to.Currently, we support the following file formats: .pdf, .txt, .docx, .doc, .png, .jpg, .pptx, .csv, and .xlsx.3
Step 3: Document Processing
After your document is uploaded, it will be processed in the background automatically to allow for incredibly fast retrieval during conversations.
This process can take 5-10 minutes depending on document size.During processing, if you have provided a
callback_url
in the Create Document request body, you will receive periodic callbacks with status updates.
You may also use the Get Document endpoint to poll the most recent status of your documents.4
Step 4: Create a conversation with the document
Once your documents have finished processing, you may use the During your conversation, the persona will be able to reference information from your documents in real time.
document_id
from Step 2 as part of the Create Conversation request.You can add multiple documents to a conversation within the document_ids
object.Retrieval Strategy
When creating a conversation with documents, you can optimize how the system searches through your knowledge base by specifying a retrieval strategy. This strategy determines the balance between search speed and the quality of retrieved information, allowing you to fine-tune the system based on your specific needs. You can choose from three different strategies:speed
: Optimizes for faster retrieval times for minimal latency.balanced
(default): Provides a balance between retrieval speed and quality.quality
: Prioritizes finding the most relevant information, which may take slightly longer but can provide more accurate responses.
Document Tags
If you have a lot of documents, maintaining long lists ofdocument_id
values can get tricky.
Instead of using distinct document_ids
, you can also group documents together with shared tag values.
During the Create Document API call, you may specify a value for tags
for your document.
Then, when you create a conversation, you may specify the tags
value instead of passing in discrete document_id
values.
For example, if you are uploading course material, you could add the tag "lesson-1"
to all documents that you want accessible in the first lesson.
lesson-1
to document_tags
instead of individual document_id
values.