Atlassian Confluence

Confluence is a web-based collaboration and documentation tool designed for teams to create, share, and manage content in one place. Confluence knowledge articles are regrouped in spaces and consist of pages and sub-pages whose content can be leveraged by an agent.

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

Prerequisites

Before you create an Atlassian Confluence data source, you need to ensure you have created Atlassian credentials in Administration > Credentials.

Learn how to create Atlassian credentials on this page: Atlassian.

Adding an Atlassian Confluence data source

To add a new Atlassian Confluence data source,

  • Go to Build > Data sources > External integrations.

  • Click the Add external integration button;

  • Next, click the Atlassian Confluence card and provide the following information:

    • Name your data source;

    • Add a description for the data source;

    • Select the Atlassian credentials to use.

    • Optionally, you can specify a CQL filter to filter the extracted data.

Finally, click the Add external integration button to add this new integration to your data source repository.

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 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 the data source has been created, you can select it when creating an agent.

Find more information about how to create an agent by reading this page: Build your own agent.