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.2.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.

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