| Note |
|---|
Work in progress |
A connection is Credentials are an authentication feature that allows agents to access data from third-party external integrations in data sources. Indeed, any data coming from a third party can only be accessed using specific credentials depending on your use case.
The Agentic platform allows you to create multiple connections credentials that multiple agents and tools can use.
To create new connectionscredentials, go to the Connections menu navigate to Administration > Credentials and click the Add connectioncredentials button.
For instance, any Confluence user is part of a tenant that contains specific knowledge unavailable to other users. As such, your agent cannot access this data unless it is connected to Confluence via a user’s credentials. You can then create a connection credentials to Atlassian for the agent to access the data you want via an Atlassian Confluence data source.
Learn how to create a connection credentials for each external integration.
| Table of Contents | ||
|---|---|---|
|
Adding a SharePoint connection
Before creating a SharePoint connection, you must first ensure you possess a SharePoint site and an account to access this site and its content.
Below are the steps to create a new SharePoint connection:
In the Connections menu, click Add connection;
Select SharePoint;
Give a name to your connection;
Type the Site URL of your SharePoint, such as
https://konverso.sharepoint.com.Provide the Username to connect to this site.
Provide the Password associated with the given Username.
Select who this connection should be shared with;
Click Add connection.
The new connection is now available in the Connections list. You can now use it when creating a new SharePoint data source.
Adding an Atlassian connection
Before creating an Atlassian connection, you must first ensure you possess an Atlassian tenant and an account with an API key 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 connection configuration.
To generate the API key:
Log in to your Atlassian tenant under a user account.
| Info |
|---|
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. |
Click Your profile and settings (the user avatar icon) in the top right of the window and select Manage Account.
...
Select Security at the top of the page.
Click Create and manage API tokens from the API token section in the central part of the window.
...
Click Create API token.
...
Give a label to your API token
Click Create.
...
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.
...
Creating the connection to Atlassian
Below are the steps to create a new Confluence connection:
In the Connections menu, click Add connection;
Select Atlassian;
Give a name to your connection;
Type the Connection URL of your Atlassian tenant, such as
https://mytenant.atlassian.net.Provide the Username to connect to this site.
Provide the API key associated with the given Username.
Select who this connection should be shared with;
Click Add connection.
The new connection is now available in the Connections list. You can now use it when creating a new Atlassian Confluence data source.
Adding a ServiceNow connection
Before creating a ServiceNow connection, you must first ensure you possess a ServiceNow instance and an account to access its content.
Below are the steps to create a new ServiceNow connection:
In the Connections menu, click Add connection;
Select ServiceNow;
Give a name to your connection;
Type the URL of your ServiceNow instance, such as
https://mycompany.service-now.com.Provide the Username to connect to this site.
Provide the Password associated with the given Username.
Select who this connection should be shared with;
Click Add connection.
The new connection is now available in the Connections list. You can now use it when creating a new ServiceNow catalog data source.
Manage existing connections
You can manage existing connections via the Connections menu, in which :
| Child pages (Children Display) | ||
|---|---|---|
|
Manage existing credentials
You can manage existing credentials via the Administration > Credentials menu, where you can view the list of connections credentials with their names, their third-party integration types, and who they are shared with.
You can view more details edit or remove credentials by clicking the dots button…the corresponding icons in the last column.