# Atlassian Agent

### What Can You Do?

Once connected, the Atlassian Agent lets you:

* **Find Projects, Issues & Pages**: Search for Jira projects, list all issues, and find Confluence pages or spaces
* **Read & Analyze Content**: Ask questions about specific issues or pages, get summaries, or extract key points from project documentation
* **Manage Issues & Workflows**: Create, update, assign, or transition Jira issues; manage project boards and workflows
* **Automate Collaboration**: Assign issues, search for users, and streamline project communication
* **Access Documentation**: Search for Confluence content, get page details, and browse spaces for resources

### Quick Setup

#### Step 1: Select Atlassian Agent

1. In any Blockbrain conversation, click the **AI Model selection** dropdown
2. Click **"Show detailed AI model list"**
3. Find and click **"Atlassian Agent"**
4. Look for **"Configure"** under the Status column

#### Step 2: Connect to Atlassian

1. Click **"Configure"**
2. Click the **"Connect"** button
3. Sign in with your Atlassian (Jira/Confluence) account when prompted
4. Click **"Accept"** to allow Blockbrain to access your Jira and Confluence data.

#### Step 3: Start Using Atlassian

That's it! You can now ask Blockbrain about your Jira projects, issues, Confluence pages, and more.

### What You Can Ask

#### **Finding Projects, Issues & Pages**

```
"List all Jira projects I have access to"
"Show me all issues assigned to me in the Marketing project"
"Find the Confluence page about Q3 planning in the Product space"
```

#### **Reading & Analyzing Content**

```
"Summarize the description and comments for issue PROD-123"
"What are the key points from the 'Project Kickoff' Confluence page?"
"Extract all action items from the 'Sprint Review' page"
```

#### **Managing Issues & Workflows**

```
"Create a new bug in the Engineering project"
"Assign issue HR-456 to Jane Smith"
"Transition issue DEV-789 to 'In Progress'"
```

#### **Automating Collaboration**

```
"List all users assignable to the Marketing project"
"Get details for user john.doe@company.com"
"Show workflow statuses for the Support project"
```

#### **Accessing Documentation**

```
"Find all Confluence pages tagged 'Q4 Roadmap'"
"Show me the latest updates in the Design space"
"Get details for the page 'API Documentation'"
```

### How It Works

**Your Access = Blockbrain's Access**

* Blockbrain can only see Jira issues and Confluence pages you can access
* If you can't open/find an issue or page, neither can Blockbrain
* Your permissions stay exactly the same

**Safe and Secure**

* Your data remains in Jira and Confluence
* Blockbrain reads and updates only as instructed—no unauthorized changes
* All access is logged in your organization's audit trail

### Tips for Better Results

#### Be Specific

**False:** "Find my issue"\
**Correct:** "Find the Jira issue about the Q3 budget in the Finance project"

#### Use **Types or Status**

**False:** "Show me tasks"\
**Correct:** "Show me all open bugs assigned to me in the Marketing project"

#### Mention Locations (and if it's in Jira/Confluence)

**False:** "Find the document"\
**Correct:** "Find the **Confluence** page titled 'Project Kickoff' in the Engineering space"

### Troubleshooting

**"I can't find my issue or page"**

* Check if you can see the issue or page directly in Jira or Confluence
* Try using different search terms (e.g., part of the issue key, project name, or page title)
* The item might be in a project or space you don't have access to

**"Permission denied" errors**

* Your Jira or Confluence permissions may have changed
* Contact your IT team to verify your access
* Try reconnecting the agent

**"No projects or spaces found"**

* You might not have access to any Jira projects or Confluence spaces
* Check with your administrator about Atlassian licensing
* Verify you're signed in with the correct Atlassian account

### Privacy and Security

* **Respecting Permissions**: Blockbrain can only access Jira issues and Confluence pages you have permission to see
* **No Unauthorized Changes**: Blockbrain only creates, edits, or transitions issues/pages when you instruct it—no unsolicited actions
* **No Storage**: Blockbrain doesn't store copies of your issues, pages, or attachments

### Common Use Cases

**Project & Issue Management**

* Quickly list all your Jira projects and issues
* Find out who is assigned to an issue or project
* Get user details for collaboration

**Content & Workflow Analysis**

* Summarize long Confluence pages or Jira issue discussions
* Extract action items or decisions from project documentation
* Search for specific issues, comments, or Confluence content

**Resource & Documentation Access**

* Locate project documentation in Confluence
* Get details or links for important Jira issues
* Browse Confluence spaces for project resources

### Example Conversation

**You:** "List all issues assigned to me in the Product project"

**Blockbrain:** "Here are your issues in the Product project:

* PROD-101: Update user onboarding flow
* PROD-115: Fix login bug
* PROD-120: Review Q3 roadmap

Which issue would you like to view or update?"

**You:** "Show me the details for PROD-115"

### Next Steps

Want to connect more services? Try the [excel-agent](https://docs.en.theblockbrain.ai/for-users/agents/excel-agent "mention") to access your workbooks and analyze data through Blockbrain.