Skip to content

docs: record the Fabric agent-eval false-failure known issue - #1261

Open
SandyChapman wants to merge 3 commits into
mainfrom
aalgo-495-fabric-relay-teardown-known-issue/schapman
Open

docs: record the Fabric agent-eval false-failure known issue#1261
SandyChapman wants to merge 3 commits into
mainfrom
aalgo-495-fabric-relay-teardown-known-issue/schapman

Conversation

@SandyChapman

@SandyChapman SandyChapman commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Overview

What. Documents the Fabric agent-eval false-failure as a known issue in the current release notes.

Why. A trial run through a NeMo Fabric adapter can be scored as an adapter failure even though the agent completed its work and produced the expected output, so evaluation results can understate an agent's accuracy. Users have no workaround in this release, and the fix cannot ship here yet, so the behaviour needs to be stated rather than left to be rediscovered.

Details

The root cause is upstream, not in the evaluator: NeMo Relay closes telemetry scopes strictly LIFO, but LangGraph schedules concurrent sibling chain runs that finish in an order the stack rejects. Relay's LangChain callback handler dropped the rejected close and left the scope live, so the enclosing request scope failed with scope handle is not at the top of the stack, and the Fabric adapter reported that teardown error as an invocation failure. It reproduces at any parallelism, including one.

Fixed upstream in NeMo-Relay #755, merged to release/0.7. It cannot reach NeMo Platform yet: Relay has not cut a release containing it, and NeMo Fabric pins nemo-relay>=0.6.0,<0.7, which excludes the whole 0.7 line. So the chain is a Relay 0.7.x release, then a Fabric dependency update, then a Fabric rev bump here.

This supersedes #1205, an evaluator-side mitigation that treated the teardown error as non-fatal. That worked around the symptom rather than fixing it, so it is closed in favour of the upstream fix plus this disclosure.

Placed under a new ## Known issues heading rather than in ## Current constraints, since that section lists intentional scope limits and this is a defect.

Testing. Docs-only change; no code paths affected. pre-commit passes on the changed file.

Breaking changes. None.

Where should the reviewer start?

docs/about/release-notes/current-release.mdx — the new ## Known issues section. Worth checking the impact wording is right for a public docs surface.

Related Issues:

  • Relates to AALGO-495
  • Relates to NVBug 6562846

Summary by CodeRabbit

  • Documentation
    • Added a Known Issues section documenting that Deep Agents trials using the NeMo Fabric adapter may be recorded as failures even when agent execution completes successfully.
    • Noted that this issue is fixed in a future release.

A Fabric agent-eval trial can be scored as an adapter failure after the agent
completed its work, because NeMo Relay's LangChain callback handler leaves a
scope open when concurrent LangGraph sibling runs finish out of LIFO order.

The defect is fixed upstream in NeMo-Relay #755 but cannot reach the platform
until NeMo Relay publishes a release carrying it and NeMo Fabric moves off its
nemo-relay<0.7 pin, so document it as a known issue for this release.

Signed-off-by: Sandy Chapman <schapman@nvidia.com>
@coderabbitai

coderabbitai Bot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: d20152ee-9b96-4f6c-9874-3e3d89d7064e

📥 Commits

Reviewing files that changed from the base of the PR and between c69716d and 64e503b.

📒 Files selected for processing (1)
  • docs/about/release-notes/current-release.mdx
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/about/release-notes/current-release.mdx

📝 Walkthrough

Walkthrough

The release notes add a Known issues section. It documents that Deep Agents trials using the NeMo Fabric adapter can receive failure scores after successful agent completion. A future release fixes the issue.

Changes

Fabric evaluation documentation

Layer / File(s) Summary
Document Fabric evaluation issue
docs/about/release-notes/current-release.mdx
Adds the false-failure behavior and future fix status to the current release notes.

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the documented Fabric agent-eval false-failure known issue.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch aalgo-495-fabric-relay-teardown-known-issue/schapman

Comment @coderabbitai help to get the list of available commands.

Signed-off-by: Sandy Chapman <schapman@nvidia.com>
@github-actions

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/about/release-notes/current-release.mdx`:
- Around line 210-212: Update the “Deep Agents trials can be scored as failures”
release-note entry to explicitly state that no workaround is available in the
current release until the fix reaches a future release.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: cc208651-7b33-4eb2-b04b-cd9670f4cb3c

📥 Commits

Reviewing files that changed from the base of the PR and between 77f03e6 and c69716d.

📒 Files selected for processing (1)
  • docs/about/release-notes/current-release.mdx

Comment thread docs/about/release-notes/current-release.mdx Outdated
Signed-off-by: Sandy Chapman <schapman@nvidia.com>
@github-actions

Copy link
Copy Markdown
Contributor
Suite Lines Covered Line Rate Branch Rate
Unit Tests 32236/40906 78.8% 63.7%
Integration Tests 18647/38832 48.0% 20.7%

@gabwow gabwow 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.

Thanks!

@SandyChapman
SandyChapman enabled auto-merge August 12, 2026 19:41
@SandyChapman
SandyChapman added this pull request to the merge queue Aug 12, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants