Behaviours Bot

What is the Behaviours Bot?

The Behaviours Bot is an AI-powered script generation assistant built into ScriptRunner for Jira Cloud. It converts natural, everyday language instructions into ready-to-use Behaviours scripts. You can utlize the functionality of the Behaviours Bot to create new Behaviours scripts, or modify, refine, and improve existing ones.

The Behaviours Bot uses the GPT-oss-20b model (hosted on AWS Bedrock) to process requests and generate responses. All data handled by the Behaviours Bot is processed exclusively within AWS, which is already covered under the Adaptavist Data Processing Addendum (DPA) accepted when obtaining a ScriptRunner license. No additional third parties receive or process Behaviours Bot data.

Using the Behaviours Bot offers several advantages when creating and managing Behaviours scripts:

  • Simplified script creation
    Supports both technical and non-technical users by generating Behaviours scripts from natural language input.

  • Faster Jira Cloud customization
    Converts requirements into Behaviours scripts instantly, speeding up configuration work.

  • Improved reliability
    Built-in error checking and testing allow you to validate Behaviours scripts before deployment, reducing the risk of issues.

  • Script preview
    Generated Behaviours scripts can be executed and previewed directly in a preview window.

  • Lower training and support demands
    Helps teams customize Behaviours without needing scripting knowledge, decreasing the need for training or support.

  • Context-aware AI assistance
    Generates accurate results informed by deep ScriptRunner and Jira Cloud expertise.

  • Fewer bugs and misconfigurations
    Early error detection and clear Behaviours script generation lead to smoother workflows and fewer support tickets.

How to use the Behaviours Bot

The Behaviours Bot is fully integrated into the Behaviours app and is free to use. This feature is turned off by default. Your ScriptRunner for Jira Cloud organization administrator can enable it in the Settings for your instance.

Within the Behaviours feature, you’ll see a notification banner prompting you to try the Behaviours Bot, as shown in the example below.

Click Try it out to open the Behaviours Bot on your instance. Depending on your role and whether your ScriptRunner AI setting is enabled, you are prompted to do one of the following actions:

  • start using the Behaviours Bot
  • activate the required setting
  • contact your administrator

When writing a script in the Behaviours code editor, you can:

  • use one of the available Example Scripts
  • write your own code, or
  • click Ask Behaviours Bot to chat with the Behaviours Bot. 

Chatting with the Behaviours Bot allows you to describe your scripting queries in everyday plain language, enabling the Bot to generate example Behaviours scripts based on your prompts.

Example: Generate a Behaviours script with the Bot

Suppose you're editing an existing behaviour that has two events and two views selected. In this case, you'll see the Ask Behaviours Bot option enabled, as shown below:

  1. Click Ask Behaviours Bot. The Behaviours Bot landing screen opens:
  2. Enter your Behaviours context in the right-hand panel, by choosing from either the Create or Issue view options.
    Depending on your selection, choose:
    • Project - select the relevant project from the list available for the chosen view.
    • Issue type - select from a list of recent issues, or enter a full issue key.
  3. Enter your query or instruction in the main panel.
    You can make the query as descriptive as you like. The Behaviours Bot is designed to deliver accurate responses to all Behaviours queries. It can modify existing scripts, identify errors, and create new scripts from your prompts.
    For example, you could ask to Set summary to 'sprint demo', as shown below:

    Here, you can ask the Bot for help. You can submit questions, re-run your query, and so on.
  4. (Optional) Use the Add some code option to include code for the Bot to review.
  5. Click Send.
    The Behaviours Bot generates a Behaviours script and displays it in the code editor. For example:

    The Behaviours Bot provides you with the corresponding issue fields in the Form preview panel configured for the chosen project on your Jira instance.
  6. Review both the generated code and the Form preview panel to confirm the behaviour works as expected. 
  7. (Optional) Modify the example script if it doesn't work as expected by:
    • editing the code directly in the editor.
    • continuing to chat with the Behaviours Bot to refine the result.
    • changing how the code is executed by selecting On load or On change under Run this script, and click Re-run script.
    • clicking Re-run script again once all modifications have been made to generate an updated Behaviours script.
  8. Click Copy code when you are satisfied with the results provided, and paste into your Behaviours script.

    The Behaviours Bot is currently in Beta, and chat history is not yet stored. This means your conversation will be lost if you leave the page. We are actively working to improve this experience.

Related content:

On this page