Prerequisites
- Jira connected so the agent can list tickets, comment, and change statuses.
- Your repository connected so the agent can branch, commit, and open PRs.
- A warehouse connection the agent can query read-only (it validates requests with
run_sql_query). - Optional: Slack connected for run summaries.
- Your Jira workflow must allow moving tickets from Open to In Progress, and from there to Ready for Review and Needs Review (or your equivalents). If a status isn’t reachable, the agent’s transitions will fail.
Steps
1
Agree the conventions
The agent needs three conventions it can rely on. This guide uses example values; swap in your own everywhere they appear in the next step.
Putting the ticket key in the branch name and PR title means Jira’s GitHub integration links the PR to the ticket automatically.
2
Build the agent in the Agent UI
In the Agent app, open Agents, select New agent, then Start from scratch. See Build an agent in the UI for a tour of the builder. Fill in the fields:Name: Goal:Backstory:Model: leave Auto selected.Allowed tools (everything else is refused, see the Tools Reference):
jira-change-request-agentRole:get_jira_issue,list_jira_issues,update_jira_issue,add_jira_commentread_file,write_file,search_files_and_directories,ripgrep_searchrun_sql_queryrun_terminal_commandpost_slack_message
post_slack_message and the Slack step from the Goal).If the code lives in a different repository than the one connected to your workspace, add
list_accessible_repos and clone_additional_repo to the allowed tools and prepend a Goal step telling the agent to clone that repo and work inside the clone. The agent can clone any repository your GitHub integration grants access to.3
Deploy and test it with a chat
Select Deploy, then Just here: the agent is saved to the workspace and live immediately. (Once it settles, redeploy via Open a pull request to version-control the definition, see Creating Agents in the App.)With one known-good ticket in Open status, hover the agent card, select Chat, and send:
Process the open Change Request ticket queue end to end. Confirm the status transitions, the branch and PR, and the ticket comment all land before scheduling it.4
Schedule it with Bolt
On the Agents page, hover the agent card and select Schedule. This opens a new Bolt schedule with the Run Paradime DinoAI Agent command already added and the agent pre-selected.
- Task:
Process the open Change Request ticket queue end to end. - Select Save command, set the trigger to a cron such as
0 9 * * 1-5(weekdays at 9 AM), and deploy.
After a run, every ticket that was in Open ends in Ready for Review with exactly one linked PR explaining the change from a data standpoint, or in Needs Review with a comment specific enough to answer without re-deriving the context. No ticket is left in In Progress. The most likely failure is a Jira transition error, which means a target status isn’t reachable from the ticket’s current status in your Jira workflow. Check the run transcript in the agent sessions panel.
How it works
The agent’s defining behavior is the validation gate: it only opens a PR when it can ground the request in your actual data, and everything else becomes a precise question back to the ticket instead of a guess. That means reviewers only ever see PRs with evidence attached, and unclear tickets surface immediately rather than after a wrong change ships.Next steps
Jira backlog agent
The label-driven variant: implement dbt™ models from agent-ready issues.
Run an agent with Bolt
Everything the Run Paradime DinoAI Agent command can do.
Triggering from Bolt reference
Every field of the command and the run lifecycle.
Tools Reference
What every tool id in the allowlist does.