Getting Started with Sage

Sage is Agility's AI-powered assistant. It integrates into your Agile workflow and analyzes what you are working on to give practical suggestions that make Stories, Defects, Tasks, and Tests clearer and more actionable.

What Does Sage Do?

Sage analyzes your team's current work and offers proactive guidance on key Agile artifacts such as:

• Stories: Ensuring user stories are well-defined, clear, testable, and aligned with overall objectives.
• Defects: Helping to clarify defect descriptions, severity, and reproducibility steps for faster resolution.
• Tasks: Providing recommendations for breaking down tasks, estimating effort, and identifying potential dependencies.
• Test Cases: Guiding the creation of comprehensive and effective test cases that adequately cover requirements.
• Release Notes: Automatically generating structured release notes from stories and defects associated with a release.

Sage improves the quality and clarity of your Agile work items by:

• Analyzing the content of work items like stories, defects, etc.
• Recommending improvements (example: clarity, formatting, missing acceptance criteria).
• Ensuring consistency with Agile principles.

How to Enable Sage

Before you can use Sage, it must be enabled by an Agility administrator at both the system level and the user level.

Enable Sage at the System Level

Only Agility users with administrator privilege can enable Sage at the system level.

1. Click the hamburger icon > Admin > System.
2. In the Enable Features section, select Sage.
3. Click Save.

Enable Sage for Your User Account

After an administrator enables Sage at the system level, each user must enable it in their personal preferences.

1. Click your Agility Profile icon.
2. From the pop-up menu, select Agility Preferences.
3. Click on AI Supplemental Terms and read provided information.
4. If you've read and agree to the AI Supplemental Terms, you can now enable Sage.

How to Access Sage

1. Click the hamburger menu > Rooms > All Team Rooms.
2. Select a Team Room name and click Try Rooms 2 button on the right side of the selected Team Room.
3. Open a Story or Defect. Sage is available on the right side panel.
4. Check the LLM availability indicator at the top of the Sage panel to confirm the AI service is ready to respond.
5. Type your question or instruction in the message box (for example: Improve the description, Add acceptance criteria) or click the microphone icon to use voice input with speech recognition.
6. Press Enter or click Send.
7. Follow prompts. Sage responds conversationally and guides you on what can be improved.
8. Sage can help you:
   • Improving work item title to be more concise and clear
   • Enhancing Description to include more technical information
   • Define clear, testable Acceptance Criteria
   • Suggest specific implementations for Tasks
   • Recommend comprehensive Test cases
9. Review and apply Sage's suggestions.

Use Voice Input with Speech Recognition

Sage supports speech recognition, allowing you to interact with the AI assistant using your voice instead of typing.

To use voice input:

1. Click the Sage icon in the Asset Detail Drawer to open the Sage panel.
2. Click the microphone icon in the message box.
3. Speak your question or instruction clearly.
4. Sage converts your speech to text and processes your request.
5. Review the AI-generated response and apply suggestions as needed.

Voice input is useful when you need hands-free interaction or prefer speaking to typing, especially during collaborative sessions or when working through multiple work items quickly.

Use Sage in Floating Window Mode

Sage can be opened in a floating window, allowing you to access the AI assistant while navigating different sections of your work item or switching between work items.

To open Sage in floating window mode:

1. Click the Sage icon in the Asset Detail Drawer to open the Sage panel.
2. Click the floating window icon in the top right corner of the Sage panel (next to the help icon).
3. Sage opens in a separate floating window that stays on top of your workspace.
4. Continue working in the Asset Detail Drawer or navigate to other work items while keeping Sage accessible.

To return Sage to sidebar mode:

1. In the floating window, click the > icon.
2. Sage returns to the sidebar panel within the Asset Detail Drawer.

Floating window mode is useful when you need to reference Sage suggestions while editing multiple fields, switching between tabs (Details, Tasks & Tests, Activity), or working across different work items without losing your conversation context.

Tips and Notes

• Check the LLM availability indicator before interacting with Sage to ensure the AI service is online.
• Verify suggestions—AI-generated output may not be accurate.
• Use Sage during story refinement to improve clarity and quality.
• Use voice input for faster interaction when reviewing multiple work items.
• Use floating window mode to keep Sage accessible while navigating between work item sections or switching work items.

Generate Release Notes

Sage automatically generates structured release notes for your releases based on the stories and defects included in the release.

Prerequisites

Before you can generate release notes:

• Sage must be enabled at the system level and for your user account
• The release must contain at least one story or defect
• You need permission to view the release and its associated work items

Generate Release Notes for a Release

1. Navigate to Release Planning Board by clicking the hamburger menu > Release Planning.
2. Select your Value Stream from the list.
3. Click on a release name to open the release details drawer.
4. Click the Sage tab to open the Sage panel.
5. Click Release Notes Generation in the Quick Actions section.

Sage analyzes all stories and defects associated with the selected release and generates comprehensive release notes.

Understand the Generated Content

The generated release notes include:

• New Features & Enhancements — Key features and improvements delivered in the release
• Critical Fixes — Important defect fixes and resolutions
• Technical Updates — Technical improvements and system changes

The release notes are formatted in a professional structure ready for distribution to stakeholders.

Refine the Generated Notes

After Sage generates the release notes:

1. Review the generated content in the Release Notes Generator dialog.
2. Type instructions in the message box to refine the output (for example: "Make it shorter" or "Add more technical details").
3. Press Enter or click Send.
4. Copy the final release notes for use in your release communications.

Tips for Release Notes Generation

• Ensure stories and defects have clear, descriptive titles and descriptions for better quality release notes.
• Review and verify the generated content—AI-generated output may not be accurate.
• Use this feature to save time creating release documentation for stakeholders.

Troubleshooting

Sage panel doesn't appear in release details

Verify Sage is enabled at the system level and in your user preferences. If you haven't enabled Sage in your Agility Preferences, you won't see the Sage panel.

Release Notes Generation option is missing

Ensure the release contains at least one story or defect. The release notes generation feature requires work items to analyze.

Generated notes are incomplete or missing items

Check that all stories and defects are properly associated with the release. Items without clear titles or descriptions may not be included in the generated output. Verify you have permission to view all work items in the release.

Generated content isn't accurate or relevant

Review the titles and descriptions of your stories and defects. Sage relies on this content to generate release notes. Clearer, more descriptive work items produce better release notes. You can also ask Sage to refine the output with specific instructions.