Skip to main content
All CollectionsAgentsCreating Agents
Creating and editing an Agent
Creating and editing an Agent
Updated over a week ago

You can create your own Agent to work with you and everyone within your site. We strongly encourage you to iterate on your Agent by editing the prompt based on unexpected responses or feedback you’re getting from people using the Agent.

After creating or editing your Agent, you can encourage people on your site to use it by Sharing an Agent.

Create your Agent

To create an Agent:

  1. Open Chat in the navigation bar in Jira, Jira Service Management, Jira Product Discovery or Confluence.

  2. From the dropdown menu at the top of the chat, or the Chat menu under the chat box, select Create an Agent.

  3. Fill in the form fields:

    1. Name: Give your custom Agent a name that clearly identifies its role or purpose, such as 'Release Manager' or 'People Ops Expert'.

    2. Description: This description will appear when browsing for Agents and will help people understand what your agent does.

    3. Instructions: You can provide a custom prompt that defines the way the Agent responds. More about writing instruction for an Agent

    4. Conversation starters: These are suggestions to help people get a chat started with your Agent. If you leave this field blank, we’ll provide 3 generic options. More about conversation starters

    5. Knowledge: This is the context you want your Agent to understand. All Agents have generic knowledge to work from, but providing relevant information (like Confluence spaces, or a Google Drive, or a Jira project) will help your Agent behave in a more optimized and accurate way. More about providing knowledge to your Agent

  4. Select Create to finish creating your agent.

If you’d like to hide your Agent so only you and people with a link can use it, select Hide Agent before selecting Create. On the other hand, Show Agent means anyone within your site can search for it by its name when they Browse Agents. You can change your selection at any time by editing an Agent.​

Agents don't grant additional access or permissions to any data or information. So even when Agents are shared, people can only see content they have access to.

Editing an Agent

Agents can only be edited by the person who created the Agent.

To edit an Agent:

  1. Open Chat in the navigation bar in Jira, Jira Service Management, Jira Product Discovery or Confluence.

  2. From the dropdown menu at the top of the chat, or the Chat menu under the chat box, select Browse Agents.

  3. You can Search for the Agent you’re looking to edit by typing its name in the search bar, or by using the filters for Starred Agents or My Agents (which are Agents you created).

  4. Select more actions () on the Agent’s card, then select Edit Agent.

  5. Edit the Agent, then select Publish to save your changes.

Did this answer your question?