How to Add AI Data Sources in BoldDesk
BoldDesk’s AI Copilot relies on structured and curated data sources to generate accurate, context-aware responses. You can enhance its performance by adding relevant content through four main methods;
- If an agent lacks permission to access a specific knowledge base, the AI will exclude that content from its responses—even if it exists.
- AI Copilot analyzes the most recent comment in a ticket to generate a reply. The AI will only consider the most recent question if you have several follow-up questions in a ticket.
- BoldDesk uses Azure OpenAI to provide this service, meaning the AI might give incorrect responses. Therefore, the agent needs to verify the AI-generated information before posting.
- Azure OpenAI, as used in BoldDesk’s AI Copilot, generates responses based on:
- Relevant Knowledge Base (KB) articles.
- Other configured sources such as custom answers and uploaded files.
- Azure OpenAI does not have access to external data or any information beyond what is provided within the BoldDesk environment and configured sources.
- The AI permits a maximum of 4096 tokens, roughly equivalent to 12,000 characters. We advise creating separate Knowledge Bases (KBs) for distinct topics instead of combining multiple topics into a single KB.
Check out this video tutorial.
1. Knowledge Base Articles (KB)
BoldDesk allows you to create structured Knowledge Base (KB) articles that not only serve your customers and agents, but also act as valuable data sources for the AI. These articles help the AI deliver accurate, context-aware responses by referencing published content. Explore more about Creating and Managing Articles for further details.
How to Create a KB Article
-
Log in to the BoldDesk Agent Portal.
-
Navigate to the AI Center > Select Knowledge Sources > Click Knowledge Base.
- After clicking on Knowledge Base, you will be redirected to the KB module on another page.
-
Under the KB module, click Create > Then select Article.
-
Fill in Article details.
-
Publish the Article.
- BoldDesk does not impose any limits on the number of articles you can create in the Knowledge Base.
- The AI permits a maximum of 4096 tokens, roughly equivalent to 12,000 characters. We advise creating separate Knowledge Bases (KBs) for distinct topics instead of combining multiple topics into a single KB.
2. Questions and Answers (Q&A)
Questions and Answers act as a data source for the AI Copilot/AI Agent and are not directly visible to end users. You can include FAQ-type questions and answers to help the AI Copilot/AI Agent in addressing those queries. Learn more on How to Create Questions and Answers for AI.
How to Add Q&A Entries
-
Navigate to the AI Center > Select Knowledge Sources > By default, the Q&A page will be displayed.
-
Click the Add Q&A button.
-
Fill out the question-and-answer fields. Also, in the setting pane on the far right, you can configure Brand, Visibility, and Tag.
-
To finish, click the Publish button. Once published, the Q&A will be integrated into the AI knowledge source.
There are no limits on the number of questions and answers that can be added.
3. Web Pages
Web pages allow BoldDesk AI to reference real-time, publicly accessible content from your documentation site or help portal. When added as a data source, BoldDesk AI indexes the provided URLs and their eligible child pages, using the information to produce accurate, context-aware responses through AI Copilot and AI Agents.
Once configured, these pages become part of the AI’s knowledge foundation, ensuring customers and agents receive responses grounded in your latest published content.
How to add Web Pages
BoldDesk provides a dedicated workflow for adding web pages to the AI module. Follow the steps below.
Steps:
-
Log In. Sign in to the BoldDesk Agent Portal using your agent or admin account.
-
Navigate to the AI Center > Select Knowledge Sources > Click Webpage. This opens the Web Pages screen, where all previously added URLs are listed.
-
Add a New Web Page. Click the “Add Web Page” button.
A Web Page dialog box appears with three available methods for adding source URLs:- Crawl Links
- Import Sitemap
- Add Single URL
Each method supports different indexing requirements, depending on the structure of your documentation.
Learn more on How to Make Your Site Reliable for AI Support in BoldDesk.
- Providing a root domain, such as BoldDesk, will result in the processing of all pages within that domain. If a specific path is provided, such as BoldDesk Pricing, only the nested pages within that path will be processed. Other URLs will not be crawled.
- Additionally, during crawling, only links to pages within the same domain will be considered. Links to external domains will be disregarded.
- Sitemap URLs can also be utilized, and they will be processed accordingly.
- To simplify whitelisting and approval through the robots.txt file, we provide a dedicated user agent, BoldDesk-Bot. If you have restrictions in place for external crawlers, you can grant access to BoldDesk by whitelisting this specific user agent.
- To remove URLs from the AI’s knowledge base, navigate to AI → Web Pages, select the relevant website, and delete the URLs from the displayed list. Once deleted, the AI will no longer index, retrieve, or reference content from these URLs in any future interactions. This procedure ensures that outdated, irrelevant, or undesired information is excluded, thereby maintaining the accuracy, relevance, and integrity of the AI’s responses.
4. File (PDF)
BoldDesk allows you to enrich its AI by uploading files that serve as knowledge sources. These files are processed and indexed to help the AI respond accurately to user queries.
How to Add a File
-
Log in to BoldDesk Agent portal.
-
Navigate to the AI Center > Select Knowledge Sources > Click File. This opens the file page screen, where all previously added files are listed.
-
Click on ‘Add File’.
-
Choose the Brand, set the Access Scope (Private or Public), and upload the file.
-
Then click ‘Add File’ to save.
- BoldDesk currently supports uploading files in PDF and Microsoft document (.doc, .docx, .docm, .dot, .dotx, .dotm) formats. Ensure that all uploaded files are clear, well‑structured, and relevant to help the AI accurately process the content and generate reliable responses.
- Only files that are publicly accessible will be processed. Private files will be excluded from the end user’s update.
- BoldDesk has imposed limits on how many files one can add. Trial Users: A maximum of 5 PDF documents can be added. Active Users: A maximum of 100 PDF documents can be added.
- The data sources added can be used in both the Web App and the Mobile App; however, they can only be added through the Web Application.
- Currently, BoldDesk AI cannot generate responses from previous tickets or emails. However, you can convert frequently used email replies into Knowledge Base (KB) articles. Once published, the AI can reference these articles to provide accurate answers to similar questions in the future.
- Currently, there is no validation for input characters. However, BoldDesk AI supports a maximum of 2,000 characters for rough input when creating an article.
Troubleshooting (knowledge sources not appearing in AI responses)
AI response is missing a Knowledge Base article
Confirm the agent has permission to access the Knowledge Base containing the article. If access is missing, AI Copilot excludes that content.
AI did not answer earlier questions in a long ticket thread
AI Copilot analyzes only the most recent ticket comment and considers only the most recent question in that comment.
AI still references outdated web content
Remove or update the URL set under AI → Web Pages. Deleted URLs are no longer indexed or retrieved.
Frequently Asked Questions
1. What types of content can be used as AI knowledge sources in BoldDesk?
Knowledge Base articles, Q&A entries, web pages, and uploaded files (PDF and supported Microsoft document formats).
2. Does AI Copilot use the internet to answer questions?
No. AI Copilot uses only configured BoldDesk knowledge sources and does not access external data beyond those sources.
3. Why is a published KB article not being used in AI Copilot answers?
If the agent lacks permission to access that Knowledge Base, AI Copilot excludes the content from responses.
4. What ticket content does AI Copilot use to draft a reply?
AI Copilot uses the most recent comment and considers only the most recent question if multiple questions exist.
5. How do I remove a website from AI Copilot knowledge?
Go to AI → Web Pages, select the site, and delete the URLs from the list. AI will no longer index or reference those URLs.
6. Which file types can I upload as AI knowledge sources?
PDF and Microsoft document formats: .doc, .docx, .docm, .dot, .dotx, .dotm.
7. Are there limits to how much the AI can respond with?
Yes. AI Copilot supports up to 4096 tokens (~12,000 characters). Use separate KBs for distinct topics to avoid oversized and mixed-topic content.
8. Can BoldDesk AI learn from past tickets or emails automatically?
No. To reuse content, convert frequent responses into published KB articles so AI Copilot can retrieve them.