Skip to content

Migrate bundled and legacy toolbox diagnostics #9565

Description

@huimiu

Parent issue: #8710

Why this is needed

The split toolbox diagnostics are being handled separately, but #8710 also needs unified azure.yaml diagnostics to preserve the behavior of bundled and legacy manifest toolboxes. Without this follow-up, Next-step suggestions and Doctor results can still give incomplete or outdated remediation for those configuration sources.

Scope

  • Recognize bundled toolboxes declared in unified azure.yaml service configuration.
  • Preserve legacy agent.manifest.yaml toolbox compatibility while unified configuration is adopted.
  • Surface toolbox configuration and referenced-file loading errors instead of silently falling back.
  • Provide source-aware Next-step and Doctor remediation for missing endpoints and migration-required configurations.
  • Add regression coverage for bundled, legacy, mixed-source, empty-declaration, and configuration-load-error cases.

Out of scope

Acceptance criteria

  • Bundled and legacy toolbox resources are represented consistently in assembled state.
  • A failed unified configuration or $ref load is visible in Doctor and does not trigger an incorrect manifest fallback.
  • Next-step and Doctor guidance identifies the correct remediation for each toolbox source.
  • Existing legacy projects remain supported without regressions.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/uxUX, prompts, output formattingarea/validationInput/config validationengineering itemInternal engineering work itemext-agentsazure.ai.agents extension

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions