Integrate Copilot Studio Agents into Power Pages Sites

Add an Existing Microsoft Copilot Studio Agent to Power Pages

Microsoft Power Pages allows you to replace the default website agent with an existing agent created in Microsoft Copilot Studio. This capability enables organizations to reuse advanced conversational agents that have already been configured, trained, and published within their environment.

Tip: Using an existing Copilot Studio agent allows you to leverage advanced conversational capabilities, custom topics, integrations, and AI-powered workflows without creating a new agent from scratch.

Why Use an Existing Copilot Studio Agent?

Organizations often create agents in Copilot Studio before deploying them to customer-facing websites. Power Pages allows these agents to be integrated directly into the website experience.

Prerequisites

Before adding an existing Copilot Studio agent to Power Pages, ensure the following requirements are met:

Important: The Copilot Studio agent and Power Pages site must belong to the same environment to ensure proper communication and authentication.

Copy the Agent Schema Name

Power Pages uses the agent schema name to identify and connect to the correct Copilot Studio agent.

  1. Open Microsoft Copilot Studio.
  2. Select the existing Agent.
  3. Navigate to Settings.
  4. Select Agent Details.
  5. Open the Advanced section.
  6. Locate the Schema Name field.
  7. Copy the Schema Name value.
Best Practice: Store the schema name securely because it is required when connecting the agent to Power Pages.

Verify Data Model Version

Before configuring the agent, verify your Power Pages site's data model version.

  1. Open Power Pages.
  2. Navigate to the Set up workspace.
  3. Select Site Details.
  4. Locate the Data Model Version setting.
  5. Verify whether the site uses:

The configuration process may differ depending on the data model version being used.

Replace the Default Agent

Once the schema name has been copied and the data model version verified, you can replace the default Power Pages agent with the existing Copilot Studio agent.

  1. Open Power Pages Setup Workspace.
  2. Navigate to Copilot settings.
  3. Select the existing agent configuration.
  4. Paste the copied Schema Name.
  5. Save the configuration.
  6. Publish the website.
  7. Test the agent experience.

Benefits of Using Existing Agents

Benefit Description
Centralized Management Manage agent logic in one location.
Advanced AI Features Leverage Copilot Studio capabilities.
Faster Deployment Reuse existing agents without rebuilding.
Consistent Experiences Provide unified customer interactions.

Best Practices

Summary

Microsoft Power Pages enables organizations to integrate existing Copilot Studio agents by replacing the default website agent. By using published agents, copying the schema name, and verifying the site's data model version, businesses can quickly deploy advanced AI-powered experiences while maintaining centralized management and governance.