Jira Issues
Index and search the issues and comments of a Jira project in Risotto
Connect a Jira project to Risotto to make its issues searchable through the AI assistant. Risotto indexes each issue's summary, description, and comments, so past solutions in resolved issues can answer new requests.
Prerequisites
Before setting up this integration, ensure you have:
- Jira Cloud — a Jira project on a Jira Cloud instance (e.g.
yourcompany.atlassian.net) - An Atlassian API Token — see Manage API tokens. A classic token (
ATATT...) and a scoped token (ATSTT..., the kind a service account creates) both work. - The email address of the API token owner
- The project key of the Jira project whose issues you want to index
Setup Process
Step 1: Configure Integration in Risotto
Open Jira's page
Go to Settings → Integrations → Jira and open the Knowledge tab. Click Add project. If nothing is connected yet, click Index a project on the Jira projects row. The Index a project dialog opens.
Configure the Index
Enter the following information, in the dialog's order:
- Site URL: Your Jira site URL (e.g.
https://yourcompany.atlassian.net). Start it withhttps://. Risotto accepts only an Atlassian site. - Project key: The Jira project whose issues you want to index (e.g.
IT) - Account email: Email address of the API token owner
- API token: A vault credential that holds your Atlassian API token. Choose it, or click Add a vault credential to create one. Classic and scoped (service account) tokens are both supported.
- Query (optional): A JQL filter that narrows which issues of the project Risotto indexes, for example
status = Done. Risotto puts your query in parentheses and adds it to the project filter withAND, so a top-levelORstays inside the project. AnORDER BYclause stays outside the parentheses. Jira checks the query when you save it. If Jira rejects it, the save fails with "Jira rejected the Query (JQL)" and the reason. - Skip internal comments: Check this box to leave Jira Service Management internal comments out of the index. Use it to prevent agents from quoting internal notes to employees. Comments on projects that are not Service Management projects are always indexed.
- Department and Audience: Choose who gets answers from this index. See Indexes.
Risotto names the index after the project key.
- Site URL: Your Jira site URL (e.g.
Create and Monitor Index
Click Index project. The project's card on the Knowledge tab shows the progress, and so does the Indexing Jobs panel on Knowledge > Indexes.
Create index on Knowledge > Indexes still adds a Jira index. Its dialog names the site URL Server URL and the account email Email address, and adds an Index name. It is the only place to set Profile filters.
Edit the Query later
You can change the Query of an existing Jira index. You cannot change the other settings.
- On Settings → Integrations → Jira, open the Knowledge tab. In the Indexed projects card, click the Query row, edit it, and click Save. An empty Query reads "Every issue in the project".
- Or, on Knowledge → Indexes, open the index's actions menu and select Configure.... Edit Query and click Update configuration.
Saving does not reindex. Issues that the old Query indexed stay in the index until you Reindex the project. Reindex removes the old documents and indexes again with the new Query.
Content Considerations
- Risotto indexes every issue in the project that matches the optional Query, with its summary, description, and comments
- Internal comments on Jira Service Management issues are indexed unless you check Skip internal comments
Reindexing Content
To pull in issue updates:
- Navigate to Knowledge → Indexes
- Find your Jira index
- Click the row's ⋮ menu (Index actions), then click Reindex
Troubleshooting
Index returns zero issues despite valid credentials
Confirm the project key is correct and that the API token owner has permission to view the project. If you entered a Query, check that it matches issues in the project.
Authentication fails
Atlassian API tokens can expire or be revoked. Generate a new one at id.atlassian.com. Then put it in the vault credential that the index uses: in Settings → Credential Vault, open the credential's row menu and choose Rotate Value. See Rotate a value. Then reindex.
Content Verification
After indexing, use Knowledge → Playground to confirm Risotto can find and reference your indexed issues.
Related Integrations
- Jira Integration — two-way ticket sync
- Confluence Integration — index a Confluence space directly
Something wrong or missing? Report an issue · View as Markdown