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:
- Replying to the last comment on a work item
- Writing a first response to a newly reported work item
- Summarizing a long discussion before answering
- Keeping replies consistent in tone and structure
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
- Summary — always included
- Description — optional
Comments
Use the Comments toggle to include or exclude comments, then choose:
- Last comment — shows its author and date
- All comments — shows the number of comments and their date range
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
- Select the sources and, optionally, enter context.
- Click Draft Comment.
- While the draft is being prepared, the sources and context are locked. You can stop drafting with Cancel.
- 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.
- Review and edit the draft in the editor. It supports the same formatting as Jira comments.
- 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:
- The oldest comments
- The end of the description
- 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.
- Every Draft Comment and Redraft uses one generation
- Generations that fail are not counted
- The number of remaining generations is shown at the bottom of the dialog; when 5 or fewer remain, a link to get a license is shown
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:
- Done — the comment was saved
- Unsaved — no comment was saved, for example the dialog or the browser tab was closed after drafting
- Error — no draft could be created
- In Progress — shown only while the AI is generating a draft
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
- AI writes a draft only — you always decide what is saved
- The draft is posted as a regular Jira comment and behaves like any other comment
- Closing the dialog without saving discards the draft