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.
📄 Refer to for full licensing details .
📄 See for environment and routing setup .
Check Licensing: Go to Microsoft 365 Admin Center → Users → Licenses → Confirm Power Pages and Copilot Studio licenses are assigned.
Verify Environment Access: In PPAC, confirm that the environment allows agent deployment and that your user role is set to Maker or Admin.
Review Site Permissions: In SharePoint Admin Center, check if the site is private or restricted. Use PowerShell if needed to inspect site-level settings.
Use Diagnostic Logs: If available, check logs in Microsoft Purview or Power Platform Admin Center for agent provisioning errors.
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.
Fubar
62
Super User 2025 Season 2
Lucas001
48
Super User 2025 Season 2
KevinGador
44
Super User 2025 Season 2