Skip to content

Comments

Add engine configuration URL to token failure messages#13803

Merged
pelikhan merged 3 commits intomainfrom
copilot/add-url-to-agent-failure-message
Feb 4, 2026
Merged

Add engine configuration URL to token failure messages#13803
pelikhan merged 3 commits intomainfrom
copilot/add-url-to-agent-failure-message

Conversation

Copy link
Contributor

Copilot AI commented Feb 4, 2026

Agent failure messages now include a direct link to engine configuration documentation when secret verification fails.

Changes

Updated actions/setup/js/handle_agent_failure.cjs to append documentation URL to secret verification failure messages in both issue creation and comment flows:

secret_verification_context:
  secretVerificationResult === "failed"
    ? "\n**⚠️ Secret Verification Failed**: The workflow's secret validation step failed. Please check that the required secrets are configured in your repository settings.\n\nFor more information on configuring tokens, see: https://github.github.io/gh-aw/reference/engines/\n"
    : "",

Users encountering token configuration issues will now see the engines documentation URL directly in failure tracking issues and comments.

Original prompt

The message reported in the issue/comment on agent failure when the tokens are missing should contain a url to https://github.github.io/gh-aw/reference/engines/ which provides information on configuring the tokens.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Include https://github.github.io/gh-aw/reference/engines/ URL when secret verification fails to help users configure tokens properly.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Add URL to agent failure message when tokens are missing Add engine configuration URL to token failure messages Feb 4, 2026
Copilot AI requested a review from pelikhan February 4, 2026 22:16
@pelikhan pelikhan marked this pull request as ready for review February 4, 2026 22:27
Copilot AI review requested due to automatic review settings February 4, 2026 22:27
@pelikhan pelikhan merged commit 2268e22 into main Feb 4, 2026
3 checks passed
@pelikhan pelikhan deleted the copilot/add-url-to-agent-failure-message branch February 4, 2026 22:27
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request enhances the error messaging for secret verification failures by adding a direct link to the engine configuration documentation.

Changes:

  • Updated secret verification failure messages to include a documentation URL (https://github.github.io/gh-aw/reference/engines/) that helps users configure their tokens correctly

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants