Confluence
Give an agent live Confluence access — list spaces and pages, read and write page content, search with CQL, and work with attachments and comments. This is separate from syncing Confluence into the Knowledge Base.
Prerequisites
- Permission to edit the agent
- A Confluence account connection available to the agent (personal and/or team, depending on how your workspace is set up)
- For Cloud OAuth, complete connection when prompted; Super Admin / integration setup may be required in some deployments
Configuration
- Open the agent → Toolkits → enable Confluence.
- Connect or select the Confluence account the agent should use.
- Under Select Tools to Enable, turn on at least one tool (required to save).
- Optionally set Default Space Key (for example
PROJ,DOCS,TEAM) for operations that don’t specify a space. - Optionally leave Require confirmation for create/update operations on (default) so the agent asks before creating or updating pages.
Available tools
These tools match the agent toolkit catalog:
| Tool | Category | What it does |
|---|---|---|
| Get Spaces | Space Management | List Confluence spaces the account can access |
| Get Pages | Page Management | List pages in spaces with optional filters |
| Get Page Content | Page Management | Read a page’s content by page ID |
| Create Page | Page Management | Create a page in a space |
| Update Page | Page Management | Update an existing page |
| Delete Page | Page Management | Delete a page |
| Get Page History | Page Management | Version history for a page |
| Search Content | Content Search | Search across Confluence using CQL |
| Get Attachments | File Management | List attachments on a page |
| Get Comments | Collaboration | List comments on a page |
| Get Sites | Site Management | List Confluence sites for the account |
| Get Current User | Site Management | Display name, email, account id, and site in use for the connected account |
Enable only the tools the agent should call. Write/delete tools have real side effects in Confluence.
Use cases
- Draft or update runbooks and technical docs from chat
- Search Confluence and summarize hits for a user
- Create meeting-note pages from a transcript
- Read page content as context before answering
Troubleshooting
| Symptom | What to check |
|---|---|
| Toolkit won’t save | Select at least one tool |
| Auth / connect errors | Reconnect Confluence; confirm OAuth or token still valid |
| Empty spaces/pages | Account permissions in Confluence; correct site/cloud instance |
| Wrong space targeted | Set Default Space Key or have the agent pass an explicit space key |
| Confused with KB sync | KB ingest is under KB Confluence connection; this toolkit calls Confluence APIs live |