Upload an agent from another tenant

Learn how to upload an agent blueprint file to create a new agent in your tenant from an existing agent in another tenant.

Prerequisites

Before you begin, make sure you meet the following requirements:

You must have an .agent blueprint file downloaded from another tenant. See Download an agent.
You must have permission to create agents in the target tenant.

You can upload an agent blueprint file to create a new agent in your tenant. The upload pre-populates the agent name, description, tags, system prompt, and tool selections from the blueprint. You then review the configuration and submit the agent for review.

In Agent Builder, select the dropdown arrow on Build new agent.
Select Upload from an existing tenant.
In the file picker, select your .agent file and select Open.
Wait for the system to finish parsing the file.

Note: Parsing may take some time. Do not close the browser tab while parsing is in progress.
On the Agent & Prompt information step, review the pre-populated agent name, description, tags, and system prompt. Edit any fields as needed for the target tenant.
Select Save & continue.
On the Tools & capabilities step, review the pre-selected tools and MCP server connections. Add or remove tools as required for the target tenant.
Select Save & continue.
On the Test & publish step, test the agent and select Save & continue.
In the Confirm submit for review dialog, select Submit for review.

Result

The agent is submitted for review. You receive a notification when the administrator approves or rejects the submission. Once approved, the agent is published and available in your tenant.

Validation

To confirm the agent was submitted successfully, select Your drafts & requests in Agent Builder. The agent appears in the list with a Pending approval status.

Unify and manage your data

Upload an agent from another tenant

Footer