Share Declarative Agents with Others

Share declarative agents to your team with ATK

For developers building declarative agents for Copilot, a common requirement is the ability to share these agents with team members or specific audiences within their organization. Starting with version 6.2.0 of the Microsoft 365 Agents Toolkit (ATK), this process has become significantly more streamlined and user-friendly.

🚀 What’s New in ATK v6.4.0 - Developers can now:

• Specify access permissions for their agents — either to selected individuals or group of users.
• Share agents across the entire tenant with just a few clicks.
• Generate a shareable link that recipients can use to instantly accept and access the shared agent.

This functionality is available in both ATK for VS Code and ATK CLI.

Prerequisites

• The M365 account you used for deploying declarative agent must have M365 Copilot license.

• M365agents.yml schema version v1.10 or above. See the section of instructions.
• ATK VS Code v6.4.0 or above.
• ATK CLI v1.14 or above.

Known Limitations

• Deploy an advanced declarative agents that have actions or api plugins are not supported by the Copilot platform yet. This support is coming on the way!

How to share - walkthrough

In ATK VS Code

1. Open your declarative agent project in VS Code and open the ATK panel.

2. Navigate to the lifecycle control in ATK panel and click Share.

⚠️ Important! — Run the Provision lifecycle before sharing. Provision ensures your agent is deployed to Copilot with the correct shareable scope.

3. Choose the audience: Select "Share access with selected users" and then enter individual emails, or group email address.

Or select “Share with all tenant users.”

4. Get a shareable link - on successful sharing you will see a notification appear in right bottom corner:

Now you can navigate to env.dev file to get the shareable link:

5. Copy the link and send to your colleagues. Recipients click Accept to gain access.

In ATK CLI

1. From your agent project folder, run the ATK CLI command atk share:

example below - replace placeholders with your values:

# Share to all tenant users
$ atk share --scope tenant -i false

# Share to selected users
$ atk share --scope users --email '[email protected]' -i false

2. Copy the share link from env.dev file and send to your colleagues. Recipients click Accept to gain access.

Notes: Pre-steps should have been done are create agents and provision the agents. Example as below:

# Create declarative agents
$ atk new -n da -c declarative-agent -with-plugin no -i false

# provision declarative agents
$ atk provision

About YAML schema:

The Share feature in ATK, or the atk share command in the ATK CLI, requires your project to use m365agents.yml schema version v1.10 or above. Please verify that your project is using a supported schema version. If your project is still on any unsupported schema, you can upgrade the Agent Toolkit/the ATK CLI and regenerate the project to obtain the correct yml version which supports the Share feature.

If you want to share an existing agent instead of generating a new one, manually update the version field in the m365agents.yml file to a supported schema (v1.10 or later) and add the scope parameter.

Add the scope parameter, set the value to "shared"