Skip to content

Remove toolbox preview header from the Mastering Toolbox notebook#73

Open
lindazqli wants to merge 2 commits into
mainfrom
fix/toolbox-preview-header-scope
Open

Remove toolbox preview header from the Mastering Toolbox notebook#73
lindazqli wants to merge 2 commits into
mainfrom
fix/toolbox-preview-header-scope

Conversation

@lindazqli

@lindazqli lindazqli commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

What

The mastering-foundry-toolbox.ipynb notebook applied a Foundry-Features: Toolboxes=V1Preview header (via a TOOLBOX_HEADERS constant) to every toolbox MCP call, the management REST API, and skill-resource reads. That header is not required for any of those paths. This PR removes it everywhere and corrects the surrounding prose.

Why

  • Tool consumption (MAF, LangGraph, Copilot SDK, raw MCP tools/list / call_tool) needs only a bearer token scoped to https://ai.azure.com/.default - no preview header.
  • Toolbox management REST (POST .../versions, PATCH .../{name}) needs only the bearer token.
  • Consuming skills as MCP resources (10b, resources/list / resources/read) is standard MCP against the same endpoint - no preview header.
  • The only flow that needs a preview feature flag is skills CRUD (project.beta.skills.* create / update-default), and the beta.skills SDK sends it automatically - so it is never set by hand in the notebook.

Changes

  • Removed the TOOLBOX_HEADERS definition and every **TOOLBOX_HEADERS spread (5 REST, verify cells, 10b skills, MAF, LangGraph, Copilot SDK).
  • Updated intro, 5, 9, and 4l prose accordingly.

No tool behavior changes - the removed headers were unnecessary. Notebook JSON validated; all 59 cells intact.

@lindazqli
lindazqli requested a review from a team as a code owner July 16, 2026 07:59
@lindazqli
lindazqli force-pushed the fix/toolbox-preview-header-scope branch from daab7b6 to 14a884b Compare July 17, 2026 01:32
@lindazqli lindazqli changed the title Scope Toolboxes preview header to skills + management REST only Remove toolbox preview header from the Mastering Toolbox notebook Jul 17, 2026
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.

1 participant