• Documentation

Best practices for Atlassian Intelligence

Atlassian Intelligence is available and automatically activated for all products on Premium and Enterprise plans. Organization admins can manage Atlassian Intelligence preferences from Settings > Atlassian Intelligence in Atlassian Administration.

Atlassian Intelligence is available to complete a task that you define, with a goal you set. When thinking about using AI, it helps to be clear and direct with your prompt.

TIP: Use action words when crafting your prompts to be direct and specific. “Create”, “build”, “draft”, and “suggest” are good examples. Passive, vague prompts generate a broader response that may not contain the information you are looking for.

For example, AI can help you re-write a page of messy notes into a succinct overview you can share with your colleagues, using the following prompt:

You attended a session on Atlassian Intelligence and need to write up the notes into a clear article. Using the notes on this page, please expand these into an article which shows the pre-, during, and post launch findings.

When starting out with AI, don’t try to front-load too much detail in your prompt. It’s better to treat prompting like you’re having a conversation with someone. Start with a more basic prompt, and add layers of detail to your follow-up prompts.

And, finally, be sure to review, and refine everything you create with AI, to ensure your content is accurate and clear.

Editing content with Atlassian Intelligence

When editing content in products like Jiraand Confluence, Atlassian Intelligence works best in scenarios like:

  • Transforming existing content for different audiences. For teams who want to make their writing more professional and concise.

  • Summarizing existing content. For text-heavy pages where there is a lot of context to pull from.

  • Generating new content. When teams use clear, specific prompts, with a specific goal in mind.

Tips for writing prompts:

  • Be as specific as possible in what you ask Atlassian Intelligence to do.

  • Break down complex requests into smaller, more manageable tasks.

  • Incorporate relevant keywords to improve the accuracy of generated content.

  • Use proper grammar and punctuation in your input text.

  • Proofread, review, and edit the output generated by the AI for accuracy and clarity.

  • Experiment with different prompts or variations of your input text to explore different ideas.

Searching for answers in Confluence

While Atlassian Intelligence is able to instantly answer the types of questions you would ask a teammate, it doesn’t know everything. Atlassian Intelligence generates answers solely based on what’s in your Confluence, and the content you have access to.

When searching in Confluence, Atlassian Intelligence works best when:

  • your Confluence site is full of detailed, complete, and up-to-date content

  • you need information that doesn’t change too frequently - for example, an internal wiki

  • your search prompt contains specific values and categories

  • you are searching in Confluence spaces written in on single language.

Not sure what questions to ask?

Here are a few suggestions:

  • When is the next marketing team offsite?

  • What is the work from home policy?

  • What is Project Sunrise?

  • When is our next marketing campaign?

  • Where are the release notes for SpaceLaunch’s newest product?

  • How do I submit expenses for reimbursement?

Still need help?

The Atlassian Community is here for you.