Guide Index
Guides HomeMangoApps WebsiteCommunity & SupportBlog & Resources
MangoApps AI Guide
MangoApps AI Guide
  • 🥭MangoApps AI Guide
  • Overview
    • Overview of MangoApps AI Studio
    • Introduction to AI Assistants
      • HR Support AI Assistant Use Case
      • Company Knowledge AI Assistant Use Case
      • IT Support AI Assistant Use Case
  • User Portal
    • User Getting Started
    • 🆕AI Assistants
      • 🆕Using AI Assistants
      • 🆕Out of the Box AI Assistants
    • AI Agents
      • Out of the Box AI Agents
      • Using AI Agents in Trackers
  • Admin Portal
    • Admin Getting Started
    • AI Admin Role
    • 🆕AI Studio Module
      • 🆕AI Studio Insights
      • AI Assistants
        • Create an Assistant
        • 🆕Writing Instructions for AI Assistants
        • Use Case Examples
          • Setting up an HR Support AI Assistant
          • Setting up an IT Support AI Assistant
      • AI Agents
        • Create an Agent
      • AI Service Providers
      • Templates
      • 🆕AI Settings
    • Understanding Your Knowledge Base
    • Navigation Menu
    • Widget
  • Bring Your Own Assistant
    • 🆕Custom Embed Assistant (BYOA)
    • Integration with AWS Bedrock
  • External Knowledge Bases
    • 🆕Overview of External Knowledge Bases
    • 🆕Knowledge Base: Confluence (Basic Authentication)
    • 🆕Knowledge Base: Confluence (OAuth 2.0 Authentication)
    • 🆕Knowledge Base: SharePoint
    • 🆕Web Page Crawler
  • Mobile
    • Download the App
  • Additional Resources
    • AI Studio by MangoApps
Powered by GitBook
On this page
  • Overview
  • What You Will Need
  • Atlassian Setup
  • MangoApps Setup
  1. External Knowledge Bases

Knowledge Base: Confluence (Basic Authentication)

PreviousOverview of External Knowledge BasesNextKnowledge Base: Confluence (OAuth 2.0 Authentication)

Last updated 2 days ago

Overview

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.


What You Will Need

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


Atlassian Setup

Step 1. Access Your Atlassian Account Settings

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.


Step 2. Generate a Confluence API Token

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.


Step 3. Copy and Save Your API 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.


MangoApps Setup

Step 4. Add a New Knowledge Base in MangoApps

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.


Step 5. Enter Knowledge Base Details

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.


Step 6. Configure Basic Authentication

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:

Key
Value

username

Your Confluence login email address

password

Your API token from Step 3


Step 7. (Optional) Apply Regex Filters

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


Step 8. (Optional) Set a Sync Schedule

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.


Step 9. Save and Activate

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:

🆕
Atlassian Account Security Settings