Close

AI best practices for using Atlassian Intelligence in Confluence

This guide will delve into some AI best practices that will help smooth the process and optimize your experience. But before we begin, here is a quick refresher on Atlassian Intelligence.


What is Atlassian Intelligence?

Atlassian Intelligence combines cutting-edge models developed by OpenAI with the capabilities and data within the Atlassian platform.

The AI search functionality within Confluence sifts through existing Confluence pages and documentation to provide relevant and contextual answers to queries. It operates exclusively within the confines of your Confluence space and retrieves information based on your access permissions and the content available to you. 

Additionally, Atlassian Intelligence's algorithms quickly provide contextual answers, definitions, and summaries. This saves you time by defining complex terms, abbreviations, and project names within the page. This also eliminates the need for lengthy searches, facilitating a more efficient reading experience within Confluence. Atlassian Intelligence can even summarize long and complex information, whether that’s as a quick brief for team members or easily digestible updates for clients.

Here are a few benefits to using Atlassian Intelligence.

Accelerate work: Atlassian Intelligence helps you organize and structure your notes effectively and accelerate your work process.

  • Transform messy notes into valuable documentation
    You can create headings, bullet points, and sections to make your documentation more coherent and easily understandable.
  • Improve writing clarity and conciseness
    The AI-powered capabilities automatically detect and address common errors such as grammar, spelling, and punctuation mistakes. It provides real-time suggestions and corrections, ensuring that your writing is clear, professional, and error-free.
  • Adapt your writing tone
    Whether you need to convey a formal tone for a professional document or a more casual tone for internal communication, the AI-powered capabilities can provide suggestions and guidance to help you tailor your writing style accordingly. This ensures effective communication and engagement with your target audience.

Glean insights: Here are ways you can harness the power of Atlassian Intelligence to gather valuable insights faster than ever.

  • Leverage AI-powered search capabilities in Confluence to access contextual, reliable, and relevant information (beta)
    Atlassian Intelligence enhances the search capabilities in Confluence with AI-powered algorithms. This enables you to efficiently retrieve information from your Confluence pages and documentation while accessing contextual, reliable, and relevant information. The AI-powered search can understand the context of your query and provide accurate and tailored results, saving you time and effort in finding the specific information you need.
  • Define internal jargon, acronyms, brands, and products for consistent knowledge sharing (beta)
    With Atlassian Intelligence, you can define and maintain a consistent understanding of internal jargon, acronyms, brands, and products within your organization. This promotes effective knowledge sharing and collaboration by ensuring that everyone is on the same page and using consistent terminology. It helps eliminate confusion and improves communication across teams and departments.

Turn insights into action: make faster and more informed decisions and quickly solve customer issues.

  • Collaborate with AI to generate ideas and answer pressing questions during brainstorming sessions
    Atlassian Intelligence can be a valuable collaborator during brainstorming sessions. It can generate ideas based on the input and context provided, helping to spark creativity and generate innovative solutions to complex problems. The AI-powered capabilities can also answer pressing questions and provide insights that contribute to productive and effective brainstorming sessions.
  • Summarize key takeaways and action items 
    Atlassian Intelligence excels at summarizing large amounts of text quickly and efficiently. It can extract the most important information, key takeaways, and action items from lengthy documents or discussions. This saves you time in manually reading and analyzing large volumes of text, allowing you to quickly grasp the main points and take appropriate actions based on the summarized insights.

To learn more about the technology behind Atlassian Intelligence, its limitations, and our commitment to privacy, visit the Atlassian Trust Center.


Treat prompting like a conversation

When getting started with AI, don’t try to front-load too much detail in your prompt. Instead, approach it as if you’re having a conversation with someone. Begin with a basic prompt and gradually add more layers of detail to your follow-up prompts.

AI prompting is like guiding a relatively knowledgeable assistant through a task. By providing clear and specific prompts, you can help the AI understand your needs and generate more accurate and relevant responses. This interaction mimics a conversation, allowing for a more natural and iterative process and ultimately leading to improved outcomes and enhanced productivity.

Let’s say you’re using Atlassian to generate a summary of a meeting. You could start with a simple prompt like, “Summarize the key points from today’s meeting.” As the AI generates the initial summary, you can then provide more specific follow-up prompts to refine the output further. For instance, you could ask, “Include details on the action items assigned to each team member” or “Highlight any decisions made during the meeting.”

By taking this approach, you allow the AI system to better understand your requirements and generate more accurate and relevant responses. Treating the prompt as a conversation enables a more natural and iterative interaction with the AI, leading to improved outcomes.


Write specific prompts

To enhance the effectiveness of your tasks, it’s important to be as specific as possible in what you ask Atlassian Intelligence to do. When crafting prompts, use action words that are direct and specific. For instance, words like “create,” “build,” “draft,” and “suggest” can help generate more focused responses. Avoid using passive or vague prompts, as they may result in broader responses that may not contain the desired information.

For example, instead of using a passive prompt like “Can you provide some information about this topic?” try using a more specific and action-oriented prompt like “Please create a detailed summary of the key features and benefits of our new product.” This will help Atlassian Intelligence generate a response that directly addresses the specific information you are seeking.

By being specific in your prompts, you can ensure that Atlassian Intelligence understands your requirements and generates the desired output accurately and efficiently.


Incorporate relevant keywords

To improve the accuracy and relevance of the generated content, incorporate keywords related to your topic or industry. This will help Atlassian Intelligence better understand the context and provide more tailored suggestions. 

For instance, if you are looking for communication tips for a technology team, include keywords such as “IT,” “tech,” “software,” “collaboration tools,” etc. This will help Atlassian Intelligence generate specific and relevant suggestions for your team’s needs.


Break down complex requests into smaller, more manageable tasks

Another useful strategy for utilizing Atlassian Intelligence is to break down complex requests into smaller, more manageable tasks. Doing this helps Atlassian Intelligence better analyze and understand each task, leading to more accurate and relevant suggestions. It also helps avoid overwhelming the system with too many requests at once, which could slow down or hinder its ability to provide helpful suggestions.

For example, instead of asking for general advice on project management, try breaking it down into specific areas such as time management, task delegation, or team communication. This will allow Atlassian Intelligence to provide targeted and actionable suggestions for each aspect of your request.


Experiment with different prompts or variations

AI systems thrive on experimentation. To explore different ideas and perspectives, experiment with different prompts or variations of your input text. This allows you to generate diverse content options and uncover unique insights. By trying out various prompts and variations, you can also train the AI system to better understand your specific needs and preferences. This will ultimately result in more accurate and personalized suggestions tailored to your specific request. 

Let’s say you are working on a marketing campaign. You could try inputting different keywords or phrases related to your target audience or product to see how the AI system generates different messaging ideas and approaches. This can help you brainstorm and refine your campaign strategy and also give you a better understanding of your audience’s preferences and interests.


Use pre-defined prompts

Atlassian Intelligence offers pre-defined prompts that simplify the process of engaging with AI in Confluence Cloud. These prompts streamline the interaction process, enabling users to obtain AI-generated insights and suggestions with ease. Users can prompt AI for tasks like generating summaries, extracting key information, and suggesting content improvements. The prompts are carefully crafted to ensure that users can quickly and effortlessly engage with AI, even if they are new to the technology.

For example, you can use the "Improve Writing" prompt to receive suggestions on how to enhance your written content, or the "Find action items" prompt to quickly identify and prioritize tasks within a meeting notes page. These prompts make it easier for users to leverage the power of AI within Confluence and can significantly improve productivity and efficiency in completing tasks.


Review and edit AI-generated output

Although AI-generated content can be a valuable starting point, it’s crucial to review and edit the output for accuracy and clarity. AI systems like the ones used to power Atlassian Intelligence aren’t infallible and may occasionally produce errors or inconsistencies.

Furthermore, by taking the time to review and edit the AI-generated output, you can also ensure that the content is tailored to your specific needs and audience. Atlassian Intelligence has the capability to adjust the tone of existing content, allowing you to customize it for different target audiences. This enhances the overall quality of the information and makes it more impactful for your purposes. 

Above all, it’s important to remember that AI is a tool, not a replacement for human intelligence and expertise. Therefore, it’s essential to use it in conjunction with your own skills and knowledge to get the most out of it.


Work smarter, not harder, with Atlassian Intelligence

Since the announcement that Atlassian Intelligence capabilities were available, nearly 10% of Atlassian’s 265,000+ customers have already leveraged Atlassian Intelligence, including Domino’s Pizza and Ovo Energy, a leading energy technology company. Join them in unlocking the power of Atlassian Intelligence to streamline your workflows, accelerate collaboration, and drive innovation. 

Haven’t activated Atlassian Intelligence yet? Learn how to do that here.

Supercharge your workflows with Atlassian Intelligence

Learn how to supercharge your workflows with Atlassian Intelligence.