Skip to main content
Version: Early Access

Assist-AI-Assisted Authoring in Trackers

Assist brings AI-assisted authoring to the Trackers module. When Assist is configured and enabled, you can use it to draft or improve an artifact's Title and Description, producing clearer, more consistent artifacts with less manual effort.

Assist has two parts:

  • Configuration - A site administrator connects TeamForge to an AI service and enables the feature in Admin > System Tools > Assist.
  • Usage - Project members use the Assist action on the Create Artifact and Edit Artifact screens.
note

AI-generated content may be incomplete or inaccurate. Always review Assist output and verify critical details before saving.

Configure Assist​

Site administrators connect TeamForge to an AI service and turn the feature on.

  1. Select My Workspace > Admin.

  2. Select System Tools.

  3. In the sidebar, click Configure Application, then scroll down and expand the Assist section.

    Admin > System Tools > Assist configuration

  4. Provide the connection details for your AI service:

    FieldDescription
    DomainThe base URL of the AI service (for example, the provider's API domain).
    Chat EndpointThe chat/completions endpoint path appended to the domain.
    ModelThe model identifier to use for generating titles and descriptions.
    TokenThe API token or key used to authenticate with the AI service.
    Enable AI Feature in ALMSelect this check box to make the Assist action available to users in the Trackers module.

    Admin > System Tools > Assist configuration

  5. Click Test Connection to validate the domain, endpoint, model, and token.

  6. Click Save.

note

When Enable AI Feature in ALM is not selected, the Assist action does not appear on the Create Artifact and Edit Artifact screens, even if the connection details are saved.

Use Assist to Draft or Improve an Artifact​

When Assist is enabled, an Assist action appears on the Create Artifact and Edit Artifact screens - at the top right of the form and next to the Description field.

Assist panel on the Create Artifact screen

  1. Open the Create Artifact (or Edit Artifact) screen and select a tracker.

  2. Enter a Title, or use Assist to help draft one.

  3. Select Assist. The Assist panel opens.

    Assist panel on the Create Artifact screen

  4. Choose a suggested prompt or type your own request in the Add your question box, and send it.

  5. Assist generates a draft. Review the result and refine it with follow-up questions if needed.

  6. Apply the generated content to the Title or Description. The Description field is a Markdown editor, so you can switch between Preview and Source to fine-tune the formatting.

  7. Complete the remaining required fields and click Save.

important

The Assist panel shows the reminder "Assist may be incomplete or inaccurate. Verify critical details." Always review AI-generated titles and descriptions for accuracy and completeness before saving.