To maximize the value of Griptape for your team, integrate it with your own data sources. This article demonstrates how to create and connect a Knowledge Base to Atlassian Confluence.
The steps are as follows:
Access the Griptape Dashboard
Create a Knowledge Base with a Confluence Connector
Wait for the data from Confluence to index
Chat with your data
Access the Griptape Dashboard
Log in to the Griptape Cloud dashboard by going to https://cloud.griptape.ai, or clicking on the Griptape Dashboard button in your @Griptape Slackbot Home page.
Create a Knowledge Base with a Confluence Connector
To connect to Atlassian Confluence, you will need your Confluence Domain URL, an API Token and the Email Address of a user of your Confluence site with the level of permissions you would like to allow your team to have access to. These steps will walk you through the process.
Add a Knowledge Base and Connector
Currently there is one type of connector available, one for Atlassian Confluence. As such, we'll be creating both the Knowledge Base and the Confluence Connector in a single step.
Choose the Knowledge Bases tab in the left navigation bar of your Griptape Dashboard.
Click + New Confluence Connection to create a new Knowledge Base connected to Atlassian Confluence.
Enter the Domain name of your Confluence site. Example:
https://yoursite.atlassian.net
Create an API Token
To create an API token, click the Get API Token button. This will open a new tab where you can create a new API token for your site.
Click the Create API token button.
Enter a label for your token and click Create.
A modal with your new API token will appear.
Click the Copy button to copy it to your clipboard.
Close the modal, and navigate back to the browser tab where you are creating your Confluence Connection.
Fill out the rest of the modal
Paste the newly created API token into the modal.
Add the email address for a user with appropriate permissions.
🛡️ For additional security, create an API token for a new Atlassian user that has permission to access only the information you want to connect to Griptape.
Click the Connect button to create the Knowledge Base with the Confluence Site connected.
You will be taken to your list of Knowledge Bases (currently just one) and see that it has a Data Source attached.
View the Data Source Status
To see the status of the Knowledge Base's data source, you can click on it in the Data Sources column. This will take you to the Data Source page.
While the data source is indexing, the status will appear as a blue circle, as in the image below.
Once finished, the status will turn green, showing the data is ready for you and your team to chat with it.
Keeping your information up to date
By default, your Knowledge Base will automatically re-index any new data every evening at midnight. If you would like to force a new ingest, you can do so in three ways:
Click the Refresh Data button on the Knowledge Bases or Data Sources page.
Click the Create Data Job button on the page of the Data Source you'd like to update the data for.
Use the
/griptape refreshcommand in Slack with the @Griptape slackbot.
