Upgrade agents to the GitHub Copilot harness (preview)

[This article is prerelease documentation and is subject to change.]

Note

Features in this article are used by agents or workflows powered by the GitHub Copilot harness.

Usage-based billing applies to using, building, testing, and evaluating agents. These actions might consume Copilot Credits. Learn more in Manage costs for agents powered by the GitHub Copilot harness.

You can ask Copilot Studio to upgrade agents powered by the standard harness. The upgrade creates a copy of the agent onto the GitHub Copilot harness. The upgrade carries over instructions, tools, and suggested prompts. Your custom topics can be rebuilt as skills of workflows. You get a report of what was migrated, what requires attention, and what was skipped. The upgrade consumes credits.

Important

This article contains Microsoft Copilot Studio preview documentation and is subject to change.

Preview features aren't meant for production use and may have restricted functionality. These features are available before an official release so that you can get early access and provide feedback.

If you're building a production-ready agent, see Microsoft Copilot Studio Overview.

Upgrade an agent from the standard harness to the GitHub Copilot harness

  1. On the Copilot Studio home page, enter something like "upgrade my Coffee Coach agent" in the input box.

  2. Follow the progress of your request in the chat.

    Copilot Studio prompts you to confirm or clarify details as needed. For example, it might ask you to confirm if it found the right agent or what you prefer to do with specific features of the original agent.

    When Copilot Studio finishes, your artifacts—the new agent and any workflows—appear as cards in the chat. The tile for the new agent shows the new agent's name followed by (Upgraded).

  3. Select the Open icon on any card to view or customize the artifact.

Limitations

The following features aren't migrated:

  • Knowledge sources
  • Power Fx expressions
  • Child agents