Issue Triage¶

Investigate new issues and provide actionable triage analysis.

Workflow source: gh-aw-issue-triage.md

How it works¶

When a new issue is opened, reads the issue and related code, reproduces or validates the report where possible, and posts a comment with a root cause analysis and actionable next steps.

Quick Install¶

mkdir -p .github/workflows && curl -sL \
  https://raw.githubusercontent.com/elastic/ai-github-actions/v0/gh-agent-workflows/issue-triage/example.yml \
  -o .github/workflows/issue-triage.yml

Trigger¶

Event	Types
`issues`	`opened`

Inputs¶

Input	Description	Required	Default
`additional-instructions`	Repo-specific instructions appended to the agent prompt. Use this to define label semantics for `classification-labels`.	No	`""`
`setup-commands`	Shell commands run before the agent starts	No	`""`
`allowed-bot-users`	Allowed bot actor usernames (comma-separated)	No	`github-actions[bot]`
`classification-labels`	Comma-separated list of labels the agent may apply (e.g. `bug,needs-triage,enhancement`). If empty, no labels are applied. Define label semantics in `additional-instructions`.	No	`""`

Secrets¶

Secret	Description	Required
`COPILOT_GITHUB_TOKEN`	GitHub Copilot PAT for AI engine authentication	Yes
`GH_AW_GITHUB_TOKEN`	Ephemeral token (e.g. a GitHub App token) used for issue labeling safe outputs. When provided, labels applied by this workflow will trigger downstream label-based workflows. When omitted, the built-in `GITHUB_TOKEN` is used, which does not re-trigger other workflows.	No

Safe Outputs¶

add-comment — post a triage analysis comment on the issue
add-labels — apply labels from the configured classification-labels allowlist (max 3); semantics defined via additional-instructions

Example Workflow¶

name: Issue Triage
on:
  issues:
    types: [opened]

permissions:
  actions: read
  contents: read
  discussions: write
  issues: write
  pull-requests: write

jobs:
  run:
    uses: elastic/ai-github-actions/.github/workflows/gh-aw-issue-triage.lock.yml@v0
    # with:
      # Configure which labels the agent may apply and define their semantics in additional-instructions.
      # classification-labels: "bug,needs-triage,enhancement"
      # additional-instructions: |
      #   - `bug`: Apply when the issue describes a clear defect or unexpected behavior.
      #   - `needs-triage`: Apply when more information is needed before the issue can be acted on.
      #   - `enhancement`: Apply when the issue describes a new feature or improvement request.
    secrets:
      COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
      # Optional: pass an ephemeral token (e.g. a GitHub App token) so that issue labels
      # applied by this workflow can trigger downstream label-based workflows.
      # When omitted, the built-in GITHUB_TOKEN is used for labeling, which does
      # not re-trigger other workflows.
      # GH_AW_GITHUB_TOKEN: ${{ secrets.GH_AW_GITHUB_TOKEN }}