Jira

​

Capabilities

​

Setup

​

Connect via OAuth

1. Go to Settings → Connections in Duckie
2. Find Jira and click Connect
3. You’ll be redirected to Atlassian
4. Select the Jira site to connect
5. Authorize Duckie’s access
6. You’ll be redirected back to Duckie

​

Using as a Deployment Trigger

1. Go to Deploy
2. Click Create Deployment
3. Select your agent
4. Choose Jira as the trigger
5. Configure events:
   • Issue created — When a new issue is filed
   • Issue updated — When an issue changes
   • Comment added — When someone comments

​

Use Cases

• Auto-triage: Classify and route new bugs
• Auto-respond: Answer questions in issue comments
• Status updates: Notify stakeholders of changes

​

Available Tools

​

Tool Examples

​

Create an Issue from Support Ticket

When a customer reports a bug:
1. Use @jira_create_issue to file a bug report
   - Project: SUPPORT
   - Type: Bug
   - Summary: Customer-reported issue
   - Description: Include customer details and steps to reproduce
2. Share the Jira link with the customer

​

Search for Related Issues

Before answering, check if there's a known issue:
1. Use @jira_search with JQL: project = BUGS AND status != Done AND text ~ "{{customer_issue}}"
2. If found, reference the existing issue
3. If not, create a new one

​

Using as Knowledge Source

1. Go to Train → Knowledge
2. Click Add Source
3. Select Jira
4. Choose which projects to index
5. Click Start Sync

• Reference existing bugs when customers report issues
• Find related feature requests
• Access resolution history

​

Best Practices

​

Use Specific Projects

• Customer-facing bug trackers
• Feature request projects
• Support-related projects

​

Create Templates

• Consistent bug report format
• Required fields always populated
• Proper labels and components

​

Link Issues to Conversations

• Link back to the support ticket
• Customer contact info (if appropriate)
• Conversation context

​

Troubleshooting

​

”Cannot access Jira”

• Re-authenticate the connection
• Verify your Atlassian account has Jira access
• Check project permissions

​

”Issue creation failed”

• Verify all required fields are provided
• Check that the project and issue type exist
• Ensure your account can create issues

​

”Webhook not triggering”

• Verify webhooks are enabled in Jira
• Check webhook configuration in Jira settings
• Ensure the webhook URL is correct