Skip to content

feat: document Foundry project ownership boundary - #9513

Draft
Hui Miao (huimiu) wants to merge 2 commits into
hui/foundry-agents-delegationfrom
hui/foundry-ownership-documentation
Draft

feat: document Foundry project ownership boundary#9513
Hui Miao (huimiu) wants to merge 2 commits into
hui/foundry-agents-delegationfrom
hui/foundry-ownership-documentation

Conversation

@huimiu

@huimiu Hui Miao (huimiu) commented Aug 10, 2026

Copy link
Copy Markdown
Member

Why this is needed

The Foundry ownership boundary must be understandable to users and extension authors: azure.ai.projects owns project identity and managed model deployments, while azure.ai.agents delegates those operations and continues to own agent services. Documentation must also describe the actual compatibility contract after removing the unnecessary core dependency.

Why this approach

The documentation describes the existing WorkflowService.Run completion contract, the versioned input-only request file, and the successful-operation state reread through Project and Environment APIs. It documents empty-string tombstones as the representation for no-longer-configured project-owned environment values and removes claims about Environment.UnsetValue, structured workflow error protobufs, result files, or mandatory core upgrades.

The changes cover:

  • cli/azd/docs/environment-variables.md and docs/reference/environment-variables.md for project-owned values and tombstone semantics.
  • docs/README.md for the ownership model and project commands.
  • docs/architecture/extension-framework.md for the extension delegation contract.
  • docs/reference/feature-status.md for the project commands' beta status.
  • The cspell configuration remains aligned with terms actually used by the implementation.

This is the top layer and targets hui/foundry-agents-delegation from PR #9512.

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
22 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

@github-actions github-actions Bot added ext-agents azure.ai.agents extension ext-foundry azure.ai.{agents,connections,inspector,projects,routines,skills,toolboxes}, microsoft.foundry ext-projects azure.ai.projects extension labels Aug 10, 2026
@huimiu
Hui Miao (huimiu) force-pushed the hui/foundry-agents-delegation branch from 555fc80 to 127ffd5 Compare August 10, 2026 10:56
@huimiu
Hui Miao (huimiu) force-pushed the hui/foundry-ownership-documentation branch from 2ed2df6 to 5430292 Compare August 10, 2026 10:58
@github-actions github-actions Bot added the area/extensions Extensions (general) label Aug 10, 2026
@huimiu
Hui Miao (huimiu) force-pushed the hui/foundry-agents-delegation branch from 127ffd5 to 1077cbd Compare August 10, 2026 13:19
@huimiu
Hui Miao (huimiu) force-pushed the hui/foundry-ownership-documentation branch from 5430292 to 39035f3 Compare August 10, 2026 13:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/extensions Extensions (general) ext-agents azure.ai.agents extension ext-foundry azure.ai.{agents,connections,inspector,projects,routines,skills,toolboxes}, microsoft.foundry ext-projects azure.ai.projects extension

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant