Jira Tool

With this Public Tool, you can create Jira tickets:

com.globant.geai.jira_ticket_insert

Before using the Tool, obtain the required information from Atlassian and register the API token as a Secret in your Project.

Configuration steps

1. Go to Atlassian API Tokens and log in. Make sure you are using the Atlassian account that has Jira access and that your Jira Cloud site is active (for example, https://<organization>.atlassian.net/jira/).
2. On the Atlassian API Tokens page, select Create API token with scopes, and then configure the following:
   • In the Name field, enter a descriptive name (for example, Jira Tool) and set Expires on. Click on Next.
   • In Select the app, select Jira and click on Next.
   • In Select Jira scopes, search for and select write:jira-work (Scope type: Classic). Click on Next.
   • Click on Create token and copy the generated token. The token is displayed only once; save it securely.
3. In Console, open the Project where you will use this Tool and create a new Secret. Follow the steps in How to create a Secret.
   • In the Name field, enter a descriptive name (for example, jira_api_token). This name will be used later in the token parameter of the tool.
   • In the Value field, paste the API token value previously obtained. Confirm to save the Secret.
4. Go to: https://<organization>.atlassian.net/jira/projects/
   • Replace <organization> with the name of your Jira workspace or company account.
5. Locate your project in the list.
6. In the Key column, find the project key you need and copy it (for example, OPS, GENX).
   • A project key in Jira is a short, unique identifier for a project. Every ticket (or issue) in that project starts with this key. If your project key is OPS, a ticket might look like OPS-123
   • The project name is not the same as the project key, so make sure you are using the correct one.
7. Go to: https://<organization>.atlassian.net/_edge/tenant_info
   • Replace <organization> with the name of your Jira workspace or company account.
8. A JSON object will be displayed. The value you need is cloudId. Copy that value (it looks like a UUID, for example: a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8).

Inside the Agent you are creating, go to the AI & Tools Tab, select the Tools and Agents section and click on + Add. In the left pane, select the desired Tool. Then click on the Tool in the left pane to view the required parameters, and complete the following.

Parameters

• cloud-id: Unique cloud identifier of your Jira site obtained in step 7 (for example, a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8).
• project-key: The Jira project key you obtained in step 6 (for example, OPS).
• token: The name of the Secret that stores the API token you generated in Atlassian (for example, jira_api_token).
• url: Your Jira workspace URL (for example, https://globant-team.atlassian.net/).
• username: The email address you use to access your Jira account (for example, user@globant.com).