Knowledge Base: Confluence (Basic Authentication)
Last updated
Last updated
MangoApps AI Studio allows you to connect external knowledge sources to enhance the intelligence and accuracy of your AI assistants. One such integration is with Confluence, Atlassian’s popular knowledge management platform. This guide walks you through how to configure Confluence (using Basic Authentication) as an external knowledge base so your AI assistants can access and utilize your organization’s existing documentation.
Before starting the setup, make sure you have the necessary credentials and tools available. This ensures a smooth configuration without interruptions.
To set up Confluence as a knowledge base, you’ll need the following:
Your Atlassian login credentials
A Confluence API token
To connect Confluence to MangoApps, you’ll first need to generate an API token from your Atlassian account.
Log in to your Atlassian account and go to Account Settings > Security.
The API token acts as a secure password that MangoApps uses to connect to your Confluence instance. You will need to generate this manually.
To do so, click the Create Classic API token button.
In the resulting pop-up menu, enter a name for your token and set an expiration date.
Click Create to generate your token.
Once generated, the API token will only be shown once. You must copy and store it securely, as it will be used to authenticate the knowledge base integration.
Click Copy to securely save your new token.
You will not be able to view the token again later.
With your token ready, you will now create a new external knowledge base inside MangoApps AI Studio.
To do this, navigate to Admin Portal > Modules > AI Studio > External KBs > Create a Knowledge Base
Select Confluence as your data source.
This step involves naming your knowledge base and specifying which part of your Confluence site should be connected. These details help organize and define the knowledge set your AI assistant will use.
Fill out the required fields:
Name: Enter a meaningful name for the knowledge base.
Description: Provide a short description for internal reference.
URL: Enter the URL of the Confluence page or space you want to connect.
To allow MangoApps to access your Confluence content, you need to authenticate using your email address and the API token created earlier.
Under Authentication Method, select Basic Authentication, then add two rows for credentials:
username
Your Confluence login email address
password
Your API token from Step 3
If you only want specific types of documents included in the knowledge base, you can apply regular expression (regex) filters to narrow down what is crawled.
How it Works:
Regex filters allow inclusion or exclusion of content by matching patterns in document titles, file types, or metadata. If both inclusion and exclusion filters match a document, exclusion takes priority.
Supported Content Types:
Space: Unique space key
Page: Main page title
Blog: Blog title
Comment: Text from blog or page comments
Attachment: File name + extension
Example:
To exclude PDFs with "private" in the name: .*private.*\.pdf
To keep your knowledge base updated automatically, you can configure a sync schedule.
You can toggle sync scheduling on to keep your Confluence knowledge base updated automatically.
If disabled, the knowledge base will sync only once at the time of saving.
Now that all settings and credentials are in place, save the configuration to begin the syncing process. This will establish a connection between your MangoApps AI Studio and the specified Confluence space or page.
Click Save to finalize the setup.
MangoApps will now begin connecting with your Confluence site and start syncing content based on your filters and authentication.
Alternatively, go directly to your account security settings using this link: