Edit

Share via

Build an agent from a form (preview)

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

Power Pages provides ability to create an agent directly from the form. These agents integrate with Copilot Studio and use knowledge, actions, and business logic from the form.

With minimal steps, you build agents using existing form fields and logic, and automatically use Power Pages' built-in authorization and security roles. You can also enhance and fine-tune these agents in Copilot Studio to unlock advanced capabilities.

Important

  • This is a preview feature.
  • Preview features aren’t meant for production use and might have restricted functionality. These features are subject to supplemental terms of use, and are available before an official release so that customers can get early access and provide feedback.

Prerequisite

  • The tenant admin needs to turn on the agent feature for Power Pages.

  • Agents in Power Pages use the Microsoft Copilot Studio agent. Check that the tenant has enough message quotas for agents. Learn more about quotas in Quotas and limits for Copilot Studio.

Create an agent

Create an agent directly from forms to streamline the manual process.

  1. Sign in to Power Pages.

  2. Find your site, and select Edit.

  3. In the Pages workspace, select a web page with a basic form.

  4. Select the form.

  5. Select Agent.

    Screenshot of clicking the Agent button in a Power Pages form to build an agent.

    The Add Agent dialog opens. Create a new agent or extend an existing one for the selected form. The dialog has these configuration options:

  6. Describe the purpose of the form, and give instructions to the agent. These instructions help the agent know when to trigger based on user input.

  7. Select the optional checkbox to let the agent autofill the form using information from an uploaded image or PDF file.

  8. Enter a name for the new agent, or select an existing agent from Microsoft Copilot Studio.

    Note

    • Only agents you create from Power Pages are available for selection.
    • Agent creation from forms supports only columns of Text, Number, Date and time, Choice, and Currency data types.

  9. Select Continue. If you choose to create a new agent, Microsoft Copilot Studio creates it. If you select an existing agent, Microsoft Copilot Studio updates it.

    By default, authentication isn't set up when you create an agent in Microsoft Copilot Studio. Set up authentication manually in the Copilot Studio editor.

  10. Under Choose Roles for this Agent, select Add Roles to assign web roles, and control which users can use the agent based on their assigned roles.

  11. Under Tables and columns for Web API, select the checkbox to let the agent use table permissions for the table related to the form. The agent uses the Power Pages Web API, which needs extra site settings. Selecting this checkbox automatically creates the required site setting.

    Note

    This configuration lets the agent use all fields in the selected table. To limit access to specific fields, update the site settings in the Management App.

  12. Select Continue.

  13. Select Publish to make the agent available from the Power Pages site.

Known issues

  • If you don’t see the newly created agent on your site and still see the classic widget experience, add the site setting 'SiteCopilot/EnableNativeControlPVABots' and set its value to true.
  • If proper authentication isn't configured for an agent hosted on a private site, the agent can incorrectly respond that a record was created successfully, even though no record was created. To avoid this issue, always configure Microsoft Entra as the identity provider for agents hosted on private sites.
  • Last updated on