Skip to content

Graceful Tool Failure Handling skill - #220

Open
Tim (Timziito) wants to merge 3 commits into
microsoft:mainfrom
Timziito:add-graceful-tool-failure-handling
Open

Graceful Tool Failure Handling skill#220
Tim (Timziito) wants to merge 3 commits into
microsoft:mainfrom
Timziito:add-graceful-tool-failure-handling

Conversation

@Timziito

Copy link
Copy Markdown
Contributor

When a tool, connector, or API call fails or misbehaves, states exactly what happened and offers a real fallback, instead of continuing as if it succeeded or fabricating the result it would have returned.

When a tool, connector, or API call fails or misbehaves, states exactly what happened and offers a real fallback, instead of continuing as if it succeeded or fabricating the result it would have returned.
Copilot AI review requested due to automatic review settings July 27, 2026 14:30

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds a new submission to the skills gallery that instructs agents to explicitly acknowledge tool/connector/API failures and provide honest, actionable fallbacks instead of fabricating results.

Changes:

  • Introduces the graceful-tool-failure-handling skill (SKILL.md) with concrete instructions and guardrails for handling failed tool calls.
  • Adds a human-facing overview (README.md) describing when to use the pattern and how it differs from tool-tracer.
  • Registers the submission in the gallery via metadata.json (name/description/platforms/tags/author/version/dates).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
submissions/graceful-tool-failure-handling/SKILL.md Adds the agent-facing runtime instructions for handling tool failures honestly and providing fallbacks.
submissions/graceful-tool-failure-handling/README.md Adds a human-facing explanation and cross-references to related patterns/skills.
submissions/graceful-tool-failure-handling/metadata.json Adds gallery metadata for discovery, attribution, and platform targeting.

Comment thread submissions/graceful-tool-failure-handling/README.md Outdated
Copilot AI review requested due to automatic review settings July 27, 2026 19:53
Fixes the issues flagged in the automated review: see PR discussion for details.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

@adrianatruji

Copy link
Copy Markdown
Collaborator

Appreciate this, Tim (@Timziito). Transparency into the agent's tool trace is definitely a demanded capability.

Two comments. The README notes in other skills such as it-support-ticket-agent and company-memory-builder (they already do it for their domains) suggest that this could be baked into the relevant skill/process at hand rather than as a separate process. The broad scope of the trigger ("whenever a tool call fails/acts unexpected/... before deciding how to respond") gets in between the agent's own reasoning loop on every hiccup, which could be counterproductive.

The challenge behind the idea (CoT/tool trace visibility) is totally relevant though, so a suggestion can be to reframe it around that (e.g. triggered on a specific intent: "describe what failed / what did you actually do"). Thank you!

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.

3 participants