Confluence Integration
Connect Confluence as a context source for the AI Documentation Agent to search pages with CQL, read page content, and keep your docs aligned with your team's wiki.
Overview
Use the Confluence integration to connect your Atlassian account and make Confluence available as an AI agent context source. The Documentation AI agents read Confluence pages live at runtime. When a prompt needs context from confluence, the agent queries Confluence on demand with CQL, then reads the relevant pages directly.
Before you start
You need:
- An organization or workspace admin role in Documentation.AI
- An Atlassian account with access to the Confluence content you want the agent to use
- At least one documentation project created in your Documentation.AI workspace
Connect Confluence
Open the organization integrations page
In the Documentation.AI dashboard, go to Settings → Organization Settings → Integrations. Find Confluence, then click Connect to start the organization-level connection.
Complete the Atlassian OAuth flow
Sign in to Atlassian if prompted, then approve access for the Confluence account you want Documentation.AI to use. After the flow completes, Documentation.AI returns you to the integrations settings page.
A successful connection creates the Confluence account at the organization level and automatically attaches it to the documentation project that started the flow.
Enable the Confluence connector for a documentation project
Go to Settings → Integrations inside the specific documentation project where you want the AI agent to use Confluence. Turn on the Confluence agent connector for that project.
Your project now has permission to let the Writer and Answer agents query the connected Confluence site.
Verify the active connection
Confirm the integration shows as active and displays the connected Confluence site name and URL. If the project connector is enabled, the AI agent can start using Confluence as context immediately.
The Confluence connection is managed at the organization level, but the agent connector is enabled per documentation project. Connect once, then choose which projects can use it.
How the AI agent uses Confluence
The Confluence subagent uses these tools to find and read the content your prompt needs.
| Tool | What it does |
|---|---|
listSpaces | Lists all Confluence spaces accessible to the connected account |
searchPages | Searches pages using CQL by text, space, label, or other criteria |
getPage | Fetches full content of a single page by ID |
listSpacePages | Lists pages within a specific space |
getSpaceTree | Retrieves the page tree hierarchy for a space |
getPageChildren | Lists child pages under a specific page |
getPageLabels | Lists labels attached to a page |
The agent decides which tools to call based on your prompt. For example, it may search with CQL first, inspect a space tree to narrow the scope, then fetch one or more pages to answer a question or write documentation.
Example prompts
Use prompts like these when you want the AI agent to pull context from Confluence:
- Summarize the deployment process documented in our Platform Engineering space.
- Find Confluence pages about SSO setup and update the authentication guide to match them.
- Search for pages labeled onboarding and draft a getting-started checklist for new support agents.
- Compare the incident response steps in Confluence with the current runbook in this documentation project.
Troubleshooting
Use these checks if the Confluence integration or project connector is not behaving as expected.