Skip to main content

Create Toolkits for JIRA

You can connect JIRA with StackSpot AI using Toolkits. Follow these step-by-step instructions for the integration:

Step 1. Access the StackSpot AI Portal;

Step 2. Navigate to the 'Toolkits' section;

Step 3. Click the 'Create Toolkit' button and provide the following information:

  • Name: Toolkit GitHub
  • Description: Toolkit to integrate with JIRA APIs

Step 4. Click the 'Add Tool' button, then select the 'Upload File' button.

  • You will need an OpenAPI/Swagger file.
- Download this YAML file.
  • The JIRA endpoints will be automatically populated.

Step 5. Access your JIRA. You must have 2FA configured in your JIRA Account.

  1. Log in to JIRA.
  2. Go to Account 'Settings > Security > Create and manage API tokens'.
  3. Click on the 'Create an API Token'.
  4. Add a name and define an expiration date for the token.
  5. Copy the token and save it; you will use it later.

Step 6. Save the API token and your user in BASE64. You must access a terminal (Mac or Linux) or a Command prompt (Windows).

  1. Encode as a BASE64 string.
  2. Replace the following:

  • user@example.com = your email used to access Jira;

  • api_token_string = your API token from the previous step

  • Linux/Unix/MacOS:

echo -n "user@example.com:api_token_string" | base64
  • Windows 7 and later (using Microsoft PowerShell)::
$Text = "user@example.com:api_token_string"
$Bytes = [System.Text.Encoding]::UTF8.GetBytes($Text)
$EncodedText = [Convert]::ToBase64String($Bytes)
$EncodedText
  1. Copy this credential created in base64. Register it on StackSpot AI.

Step 7. Register the token so the Agent can access your private Jira project. Follow the instructions:

  1. Access the toolkit and go to 'Settings'
  2. In Authentication, click the lock icon and then click 'Register Secret'
  3. Fill out the fields
  • Secret Storage Location: Personal
  • Credential type: API Key
  • Name: Jira BASE64 API token
  • Headers:
    • Name: Authorization
    • Value: Add the: Basic <your_created_token_in_base64>
  1. Click the Register Secret button. Then, save your Toolkit.

Step 8. Create an Agent. Go to the 'Agents' section and click the Create Agent button. Provide the following details:

  • Agent Name: Jira board manager StackSpot
  • System Prompt:
You are an agent who can interact with XXXX (add your JIRA identifier here - it is a code with 4 letters)
  • LLM: Add Azure GPT-4.1
  • Tools: Add the two tools you previously created
    • POST > Create a task (issue)
    • GET > Lists tasks on a board (via JQL)

Click the 'Create' button.

Step 6. Test your Agent.