Draft Comment | Smart Data Generator Documentation

Draft Comment documentation.

Overview

Draft Comment prepares a comment draft for a Jira work item using AI. It reads the work item's summary, description and comments, takes your optional instructions into account, and writes a reply that you can review and edit before saving.

Draft Comment is ideal for:

Nothing is posted to the work item until you click Save.


Where to Find It

Open a work item and select Content generator → Draft Comment.

The Draft Comment dialog opens with the sources and context at the top. After drafting, the draft appears in the same dialog, below the context.


Sources

The Sources section defines what the draft is based on. Each source shows its word count.

Work item

Comments

Use the Comments toggle to include or exclude comments, then choose:

Default selection when the dialog opens

Work item Default
No comments Description selected; the Comments toggle is off and cannot be turned on
One comment Last comment selected; All comments unavailable
Two or more comments Last comment selected; All comments available

If you change the default selection, Draft Comment remembers your choice and restores it the next time you open the dialog, as far as the work item allows. Use Reset to defaults to go back to the default selection.


Context

Context tells the AI what the comment should achieve, for example:

Ask the reporter for browser console logs first and keep it short.

Context supports bulleted and numbered lists. Pasted text is converted to plain text and lists.

Whether context is needed depends on the selected sources:

Selected sources Context
Comments included Optional
No comments, Description included Recommended — without context, the draft is a first reply: a summary of the reported problem and clarifying questions
Summary only Required — Draft Comment stays disabled until you enter context

Context can contain up to 1,000 words.


Drafting and Reviewing

  1. Select the sources and, optionally, enter context.
  2. Click Draft Comment.
  3. While the draft is being prepared, the sources and context are locked. You can stop drafting with Cancel.
  4. When the draft is ready, the dialog scrolls to the draft. The sources and context remain above it — scroll up or use ↑ Sources & context to change them.
  5. Review and edit the draft in the editor. It supports the same formatting as Jira comments.
  6. Click Save to post the comment to the work item.

Redraft

To get a new draft, change the sources or the context and click Redraft. The new draft replaces the current one.

If you edited the draft by hand, Draft Comment asks for confirmation before replacing it: choose Replace to continue or Keep editing to keep your version.


Limits

Limit Value
Sources (summary, description, comments and context together) 10,000 words
Context 1,000 words
Comment 10,000 characters

The word count of the selected sources is shown in the Sources section header. The character count of the draft is shown in the bottom-right corner of the editor.

When sources exceed the limit

You can still draft a comment. Draft Comment shows how much the limit is exceeded and what will be left out, and shortens the sources in this order:

  1. The oldest comments
  2. The end of the description
  3. The end of the last comment

The summary and your context are always kept in full. Shortened sources are marked in the draft header, for example All comments (3 of 5) or Last comment (shortened).

If the context alone exceeds 1,000 words, Draft Comment is disabled until you shorten it.

When the comment exceeds the limit

The character counter turns orange at 90% of the limit. Above 10,000 characters, the editor is marked red, a message shows how many characters to remove, and Save is disabled until the comment is shortened.


AI Usage on Evaluation Licenses

Evaluation licenses include 50 AI generations for Draft Comment. This limit is separate from the limit for sprint name generation.

When all generations are used, Draft Comment and Redraft are disabled. Drafts that are already open can still be edited and saved.

If you need a higher limit while evaluating Smart Data Generator, contact us through the Customer Portal.


When a Draft Cannot Be Created

Not enough information

If the selected sources do not contain anything to respond to, Draft Comment shows Couldn't draft a comment with the reason. Add context or include more sources, and draft again.

Technical error

If the AI service cannot be reached, Draft Comment shows Something went wrong. Your sources and context are kept — click Try again.

In both cases, the attempt is not counted toward the evaluation limit.


Activity Stream Integration

Every Draft Comment session — from opening the dialog to saving the comment or leaving it — is recorded in the Users Activity Stream as one entry with the action type Draft Comment.

The entry status shows how the session ended:

The entry shows the work item, selected sources, context, number of generations and whether a comment was saved. A saved comment can be deleted directly from the Activity Stream.

The text of the sources and of the draft is not stored.


Permissions

To save a draft, you must have permission to add comments to the work item.


Additional Notes