Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Work in progress

Atlassian is a platform that provides tools for software developers and project managers to facilitate collaboration, software development, and project management.

Atlassian’s most popular products consist of:

  • Jira (project management)

  • Bitbucket (code collaboration and version control)

  • Trello (visual collaboration tool)

  • Confluence (documentation collaboration tool)

If you use Atlassian in your daily work, you likely have a Confluence wiki filled with valuable documentation. This documentation can be utilized by an agent within our platform. To enable this, you need to establish an Atlassian credential, which will grant access to your Atlassian tenant using the provided credentials.

This credential can then be used to access the content of your Confluence wiki via an Atlassian Confluence data source.

Adding an Atlassian credential

Before creating an Atlassian credential, you must first ensure you possess an Atlassian tenant (e.g. mytenant.atlassian.net) and an account with an API key to be able to access the content from your Atlassian tenant (such as Confluence, Jira, etc.).

Generating the Atlassian API key

The API key (or API token) is used as a password in the Atlassian credential configuration.

To generate the API key:

  1. Log in to your Atlassian tenant under a user account.

We strongly advise using an Atlassian Service Account with administrator permissions to generate the API token. This account needs to be tied to a license.

  1. Click Your profile and settings (the user avatar icon) in the top right of the window and select Manage Account.

image-20241014-125030.png

  1. Select Security at the top of the page.

  2. Click Create and manage API tokens from the API token section in the central part of the window.

image-20241014-125333.png

  1. Click Create API token.

image-20241014-125450.png

  1. Give a label to your API token

  2. Click Create.

image-20241014-125806.png

The token is ready for use. Make sure to copy the token before you close this dialog, as it is impossible to see the token later.

image-20241014-125725.png

Creating the credential to Atlassian

Below are the steps to create a new Atlassian credential:

  1. Go to User interfaces > Agentic > Credentials > Configuration.

  2. Click Add credential to create a new credential;

  3. Select the Atlassian credential type;

  4. Give a name to your credential;

  5. Type the Connection URL of your Atlassian tenant, such as https://mytenant.atlassian.net.

  6. Provide the Username (= email address) to connect to this site.

  7. Provide the API key associated with the given Username.

  8. Click Create.

The new credential is now available in the Credentials list. You can now use it when creating a new Confluence knowledge base data source.

What’s next?

Learn how to create a Confluence knowledge base data source that uses your credentials by reading this page: Confluence knowledge base.

  • No labels