[copilot-session-insights] Copilot Agent Session Analysis - Configuration Required

[github-actions[bot]]

⚙️ Copilot Agent Session Analysis - Configuration Required

Issue

The Copilot Agent Session Analysis workflow attempted to run but could not access session data.

Run Details:

• Run ID: §19742105539
• Workflow: Copilot Agent Session Analysis
• Date: 2025-11-27
• Repository: githubnext/gh-aw

Root Cause

Session data could not be fetched due to one or more of the following reasons:

1. ❌ gh agent-task extension not installed on the runner
2. ❌ Authentication token missing or insufficient permissions
3. ❌ GitHub Enterprise Copilot not enabled for this organization/repository
4. ❌ No agent task sessions available in the time period

Required Setup

To enable this workflow, the following requirements must be met:

1. GitHub Enterprise Copilot Subscription

This workflow requires GitHub Enterprise with Copilot enabled. The gh agent-task CLI extension is only available to Enterprise customers with Copilot access.

Check your access:

• Verify GitHub Enterprise subscription
• Confirm Copilot is enabled for your organization
• Ensure you have access to Copilot agent tasks

2. Install gh agent-task Extension

The workflow runner needs the gh agent-task extension installed:

gh extension install github/agent-task

For GitHub Actions runners:

• This extension should be pre-installed in the runner environment
• If using self-hosted runners, install manually
• Consider adding to runner setup scripts

3. Configure Authentication Token

The workflow needs a Personal Access Token (PAT) with appropriate permissions:

Create a secret named GH_AW_COPILOT_TOKEN:

1. Generate a Personal Access Token with these scopes:
   • repo - Full control of private repositories
   • read:org - Read organization data
   • workflow - Update GitHub Actions workflows
2. Add the token as a repository secret:
   • Go to Settings → Secrets and variables → Actions
   • Create new secret: GH_AW_COPILOT_TOKEN
   • Paste the token value

Important: The default GITHUB_TOKEN does NOT have sufficient permissions for agent task API access. A Personal Access Token is required.

4. Verify Access

Test your configuration:

# Set your token
export GH_TOKEN=ghp_your_token_here

# List agent tasks
gh agent-task list --limit 5

# View a specific task
gh agent-task view (task-id)

If these commands work, the workflow should succeed on the next run.

Troubleshooting

Extension Not Found

Error: unknown command "agent-task" for "gh"

Solution: Install the extension:

gh extension install github/agent-task

Authentication Failed

Error: 403 Forbidden

Solution:

• Verify GH_AW_COPILOT_TOKEN secret is configured
• Ensure the token has required scopes
• Check if GitHub Enterprise Copilot is enabled

No Sessions Available

Total sessions found: 0

Solution:

• This may be expected if no agent tasks have been created
• Create some agent tasks and re-run the workflow
• Verify agent tasks are being created in the correct repository/organization

Next Steps

Once configuration is complete:

1. Verify requirements:

   • GitHub Enterprise Copilot subscription active
   • gh agent-task extension installed on runner
   • GH_AW_COPILOT_TOKEN secret configured with valid PAT
   • Token has required permissions

2. Test manually:

   • Run gh agent-task list to verify access
   • Confirm sessions are returned

3. Re-run workflow:

   • Manually trigger workflow via workflow_dispatch
   • Verify successful session download
   • Check for analysis discussion creation

Additional Resources

• GitHub Agent Tasks Documentation: [Enterprise Copilot Documentation]
• gh CLI Extensions: https://docs.github.com/en/github-cli/github-cli/using-github-cli-extensions
• Personal Access Tokens: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token

Contact

For questions or assistance with configuration:

• Check with your GitHub Enterprise administrator
• Review organization Copilot settings
• Contact GitHub Support for Enterprise customers

---

This configuration guide was generated automatically because session data was unavailable.
Workflow run: §19742105539
Date: 2025-11-27

AI generated by Copilot Session Insights