Creating an Atlassian Confluence data source

Creating an Atlassian Confluence data source

This page is dedicated to explaining how to create an Atlassian Confluence data source that can be leveraged by Koji to answer users' queries.

For Koji to answer users' queries based on the Confluence knowledge related to your project, you will need to:

  1. Create an Atlassian connection.

  2. Create an Atlassian Confluence data source using this connection.

  3. Select the data source to use in Koji settings.

Prerequisites

Before you create an Atlassian Confluence data source, you need to ensure you have created an Atlassian connection in Platform management > Configuration > Connections.

Learn how to create an Atlassian connection on this page: Creating an Atlassian connection.

Creating an Atlassian Confluence data source

You can create a new data source leveraging a Confluence wiki by following these steps:

  1. Go to Content > Data sources.

  2. Click the Add data source button.

  3. Type the name of your data source.

  4. Select the Atlassian Confluence data source type.

  5. Select an Atlassian connection.

  6. Add a description for your data source.

  7. Select the language of the content.

  8. Specify a CQL filter to filter the extracted data.

  9. Finally, click Create.

image-20250707-125246.png
Configuration Part 1
image-20250707-125506.png
Configuration Part 2

What is a CQL filter?

A CQL (Confluence Query Language) filter is a way to narrow the data to retrieve for constituting a data source by using the CQL syntax.

You can filter which space(s) to add in a data source using a CQL filter if you have several Confluence spaces.

You can, for example, narrow the content of the retrieved spaces with this sample query: space in ('SEC', 'DOC'), which will only retrieve the pages from the SEC and DOC Confluence spaces of your tenant.

To learn more about CQL and its syntax, see the Advanced Searching using CQL page.

What’s next?

Now that your data source is ready, you will need to go to Koji settings to do the following:

  • Enable Confluence search in the Knowledge sources section.

  • Select the data source to use in the Data source selection section.

You can find more information about these last steps on the Koji settings page.