web
You’re offline. This is a read only version of the page.
close
Skip to main content
Community site session details

Community site session details

Session Id :
Power Pages - Administer & Monitor
Suggested answer

Not able to add agent into Power Pages site

(1) ShareShare
ReportReport
Posted on by
I am trying to add an agent into power pages site.
 
Getting this error "The agent ran into an error. Try again or contact your admin.".

What are the pre requisites we need to check for the failure. and how to check .
Categories:
I have the same question (0)
  • Suggested answer
    Jon Unzueta Profile Picture
    1,215 Super User 2025 Season 2 on at
    Not able to add agent into Power Pages site
     

    You're trying to add an agent into a Power Pages site and encountering the error:

    "The agent ran into an error. Try again or contact your admin."

    This issue is often related to missing prerequisites, licensing limitations, or environment misconfiguration. Based on internal documentation and recent community discussions, here’s a checklist and guidance to help you troubleshoot and resolve the problem.


    ✅ Key Prerequisites to Check

    1. Licensing Requirements

    • You must have a valid Power Pages license and a Copilot Studio license assigned to your user account.
    • External users or guest accounts must also be appropriately licensed if they interact with the agent  .

    📄 Refer to Power Platform Licensing Guide November 2022 for full licensing details .

     

    2. Environment Routing and Permissions

    • Ensure the agent is being added to a supported environment in Power Platform Admin Center (PPAC).
    • Admins should configure environment routing to allow agent provisioning and verify that the maker has permission to deploy agents .

    📄 See NTTData_MicrosoftCopilot_AdoptionFramework_2025 for environment and routing setup .

     

    3. Agent Deployment Pipeline

    • If you're using Copilot Studio, make sure the deployment pipeline is properly configured to approve agent deployment to shared environments.

    4. SharePoint and Site Permissions

    • If your Power Pages site is backed by SharePoint, verify that:
      • The site is not restricted by RCD (site-level disable) or RAC (user-level access control).
      • The site is not private or blocked from agent access.

    5. Audit Logs and Monitoring

    • Use Microsoft Purview or Microsoft Sentinel to check for audit logs and alerts related to agent provisioning failures.

    🛠️ How to Check and Fix

    1. Check Licensing: Go to Microsoft 365 Admin Center → Users → Licenses → Confirm Power Pages and Copilot Studio licenses are assigned.

    2. Verify Environment Access: In PPAC, confirm that the environment allows agent deployment and that your user role is set to Maker or Admin.

    3. Review Site Permissions: In SharePoint Admin Center, check if the site is private or restricted. Use PowerShell if needed to inspect site-level settings.

    4. Use Diagnostic Logs: If available, check logs in Microsoft Purview or Power Platform Admin Center for agent provisioning errors.

    5. Retry with Admin Privileges: Try adding the agent again while logged in as a Global Admin or Environment Admin.

     

    🏷️ Tag me if you have any further questions or if the issue persists.

    ✅ Click "Accept as Solution" if my post helped resolve your issue—it helps others facing similar problems.

    ❤️ Give it a Like if you found the approach useful in any way.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Responsible AI policies

As AI tools become more common, we’re introducing a Responsible AI Use…

Telen Wang – Community Spotlight

We are honored to recognize Telen Wang as our August 2025 Community…

Congratulations to the July Top 10 Community Leaders!

These are the community rock stars!

Leaderboard > Power Pages

#1
Fubar Profile Picture

Fubar 62 Super User 2025 Season 2

#2
Lucas001 Profile Picture

Lucas001 48 Super User 2025 Season 2

#3
KevinGador Profile Picture

KevinGador 44 Super User 2025 Season 2

Featured topics