Add Submit to your org catalog content for Agent Builder#97
Open
sophie-roy3 wants to merge 13 commits intoMicrosoftDocs:mainfrom
Open
Add Submit to your org catalog content for Agent Builder#97sophie-roy3 wants to merge 13 commits intoMicrosoftDocs:mainfrom
sophie-roy3 wants to merge 13 commits intoMicrosoftDocs:mainfrom
Conversation
Adds two new articles and updates two existing articles to cover the new "Submit to your org catalog" flow in Agent Builder, which lets makers submit agents for admin review and publication to the Microsoft 365 Copilot Agent Store under "Built by your org". New articles: - agent-builder-submit-to-org-catalog.md: submission flow, fields, approval status tracking, post-approval updates, and how to find the approved agent in the Agent Store. - agent-builder-publication-privacy-terms-of-use.md: guidance on providing valid privacy statement and terms of use URLs, and how those URLs flow to both the shared version and the Agent Store version of the agent. Updates: - agent-builder-share-manage-agents.md: removes the stale "Differences between sharing and publishing agents" table (which compared sharing with Copilot Studio publishing, not relevant on this Agent Builder page); adds "Update your agent's About info" and "Submit an agent to your org catalog" sections; updates the related-content list. - publish.md: fixes the "Submit to organizational catalog" row in the "Declarative agents built with Microsoft 365 Copilot" table to point to the new page, updates the note to reference the submission flow, and updates the closing paragraph. - TOC.yml: adds entries for the two new articles under the Agent Builder section.
Replaces "**More options** (the overflow menu)" and "**More options**"
with "the **More** ellipses (**...**)" to match the canonical product
UI label ("More" per the menu tooltip) and the pattern used throughout
agent-builder-share-manage-agents.md.
Updated author and ms.author fields in the document.
Expands the Creator website description in both the About this agent table and the submission form table to include concrete examples (profile page, team SharePoint site, internal support page) so makers understand what to point the link at.
Updated the date and improved wording for clarity in the privacy statement and terms of use documentation.
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the Agent Builder documentation set to describe the new Submit to your org catalog flow, including maker submission steps, approval status tracking, and how related metadata (privacy/terms) is provided and surfaced in the Agent Store.
Changes:
- Adds two new Agent Builder articles covering org-catalog submission and privacy/terms-of-use URL guidance.
- Updates existing publishing and sharing/management docs to link to and describe the new submission flow.
- Updates the Agent Builder TOC to include the new articles.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/TOC.yml | Adds navigation entries for the two new Agent Builder articles. |
| docs/publish.md | Updates the Agent Builder distribution table and guidance to point to the new org-catalog submission article. |
| docs/agent-builder-submit-to-org-catalog.md | New end-to-end maker guidance for submitting agents to the org catalog, tracking status, and updating approved listings. |
| docs/agent-builder-share-manage-agents.md | Removes stale comparison content; adds “About this agent” metadata guidance and links to the submission flow. |
| docs/agent-builder-publication-privacy-terms-of-use.md | New guidance on providing valid privacy/terms URLs and how they appear in the Agent Store. |
| | **Terms of use** | 2,048 characters | A link to your organization's terms of use. Must be a valid HTTPS URL. Replace the default placeholder link with your organization's URL. | | ||
|
|
||
| > [!TIP] | ||
| > **Short description**, **Creator website**, **Privacy statement**, and **Terms of use** are prepopulated from your agent's **About this agent** settings. To set these values without starting a submission, use **About this agent** from the agent authoring header. For more information, see [Update your agent's About info](agent-builder-share-manage-agents.md#update-your-agents-about-info). |
Comment on lines
+33
to
+36
| The privacy statement and terms of use URLs apply to both the shared version of your agent and the Agent Store version. When you save these URLs, either in the submission dialog or in the **About this agent** dialog, both versions are updated. | ||
|
|
||
| > [!NOTE] | ||
| > To update these URLs after approval, resubmit your agent for admin review. Changes to the shared version apply immediately. Changes to the Agent Store version apply only after admin approval. |
Comment on lines
55
to
+58
| > [!NOTE] | ||
| > If sharing options are restricted in your organization, when you share the agent, an admin must approve and deploy it before it's available to other users in the organization. | ||
| > If sharing options are restricted in your organization, makers can submit agents to the organizational catalog for admin review. Once approved, the agent is published to the Agent Store under **Built by your org**. For details, see [Submit agents from Agent Builder to your org catalog](agent-builder-submit-to-org-catalog.md). | ||
|
|
||
| For more information about sharing agents, see [Share an agent via Microsoft 365 Copilot](agent-builder-share-manage-agents.md#share-an-agent). | ||
| For more information about sharing agents, see [Share and manage agents](agent-builder-share-manage-agents.md). To publish an agent to your organization's Agent Store, see [Submit agents from Agent Builder to your org catalog](agent-builder-submit-to-org-catalog.md). |
Clarified the update process for URLs in agent submissions.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Related work item: bacx/content AB#45872
Summary
Adds two new articles and updates two existing articles to cover the new Submit to your org catalog flow in Agent Builder. Makers can now submit agents for admin review and publication to the Microsoft 365 Copilot Agent Store under Built by your org, for broad organizational availability without per-user sharing prerequisites.
Target publication: 2026-05-08.
New articles
agent-builder-submit-to-org-catalog.md— submission flow, field requirements, approval status tracking, post-approval updates, and how to find an approved agent in the Agent Store.agent-builder-publication-privacy-terms-of-use.md— guidance on providing valid privacy statement and terms of use URLs, and how those URLs flow to both the shared version and the Agent Store version of the agent.Updates
agent-builder-share-manage-agents.mdpublish.mdTOC.ymlNotes for reviewers
/microsoft-365/admin/manage/agent-registry#publish-agents.