# 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
* See also the [**Tools & Connectors** **section**](#tools-and-connectors) for further reference
### 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
### Tools & Connectors
### 
Jira Tools
| Tool | Description |
| --------------------------- | -------------------------------------------------------- |
| **Search Issues** | Query issues using JQL |
| **Get Issue** | Fetch detailed info on a specific issue (e.g., PROJ-123) |
| **Create Issue** | Create new issues or subtasks |
| **Edit Issue** | Update fields on existing issues |
| **Transition Issue** | Move issues through workflow statuses |
| **Assign Issue** | Assign issues to team members |
| **Get Transitions** | List available status transitions for an issue |
| **Get Workflow Statuses** | View all statuses in a project's workflow |
| **Get All Projects** | List all accessible Jira projects |
| **Get Agile Boards** | Find Scrum/Kanban boards |
| **Get Create Metadata** | Retrieve issue type fields before creation |
| **Search Fields** | Find custom or system fields |
| **Search Users** | Find users by name or email |
| **Search Assignable Users** | Find users assignable to a project/issue |
***
### 
Confluence Tools
| Tool | Description |
| --------------------- | ---------------------------------------------- |
| **Search Confluence** | Find pages, blogs, or spaces by keyword or CQL |
***
### 📊 Data & Analysis Tools
| Tool | Description |
| -------------------- | ------------------------------------------- |
| **Code Interpreter** | Run Python for data analysis & calculations |
| **Process File** | Read & extract content from files |
| **Vector Search** | Semantic search through knowledge bases |
| **List Attachments** | View attached files in the data room |
| **List Emails** | Access connected emails |
***
### 📈 Chart Tools
* **Bar, Line, Pie, Doughnut, Radar, Scatter, Bubble, Polar Area** charts
***
### 🧠 Knowledge & Insight Tools
| Tool | Description |
| -------------------------------------------- | --------------------------------- |
| **Read / Create / Update / Delete Insights** | Manage notes & insights |
| **List / Create / Update / Delete Skills** | Manage reusable workflows |
| **Folder Structure** | Browse knowledge base documents |
| **Image Generation** | Generate images from text prompts |
***
### ⏰ Scheduler Tools
| Tool | Description |
| --------------- | ------------------------------------ |
| **Create Task** | Schedule recurring or one-time tasks |
| **List Tasks** | View all scheduled tasks |
| **Update Task** | Modify an existing task |
| **Delete Task** | Remove a scheduled task |
***
### 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](/for-users/agents/excel-agent.md) to access your workbooks and analyze data through Blockbrain.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.blockbrain.ai/for-users/agents/atlassian-agent.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.