--- title: Enable the AI agents feature description: Enable the AI agents feature for Advanced Identity Cloud tenants created before April 2026 component: pingoneaic page_id: pingoneaic:identity-for-ai:ai-agent-identities-enable canonical_url: https://docs.pingidentity.com/pingoneaic/identity-for-ai/ai-agent-identities-enable.html llms_txt: https://docs.pingidentity.com/pingoneaic/llms.txt docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md section_ids: enable-the-ai-agents-feature-in-your-development-tenant-environment: "Task 1: Enable the AI agents feature in your development tenant environment" promote-the-feature-to-your-other-tenant-environments: "Task 2: Promote the feature to your other tenant environments" --- # Enable the AI agents feature The AI agents feature is enabled by default for tenant environments created on or after the following dates: * March 30, 2026 (sandbox\[[1](#_footnotedef_1 "View footnote.")] environments) * April 14, 2026 (development, UAT\[[2](#_footnotedef_2 "View footnote.")], staging, and production environments) For tenant environments created before those dates, you can enable the AI agents feature using the Ping Identity admin console. After the feature is enabled, you can promote the configuration to your other tenant environments. ## Task 1: Enable the AI agents feature in your development tenant environment In your development tenant environment: 1. In the Advanced Identity Cloud admin console, go to [icon: smart_toy, set=material, size=inline] AI Agents (in either realm), then take one of the following actions: * If the [icon: add, set=material, size=inline] Enable AI Agent Identity button displays, the AI agents feature isn't enabled, and you should continue to the next step in this task. * If the [icon: add, set=material, size=inline] Add AI Agent button displays, the AI agents feature is already enabled, and you can skip the rest of the steps in this task. However, you should check if the feature is enabled in your other tenant environments, and if necessary, enable the feature in those environments by following the steps in Task 2. 2. Check that the tenant supports these features: * **Application management**: Check using the [Application management migration FAQ](../product-information/migration-dependent-features/application-management-migration-faq.html). If the tenant doesn't support application management, contact your Ping Identity representative. * **Groups**: Check using the [Group identity migration FAQ](../product-information/migration-dependent-features/group-identity-migration-faq.html). If the tenant doesn't have groups enabled, follow the feature enablement instructions in [Group management](../idm-objects/groups.html). 3. Click the [icon: add, set=material, size=inline] Enable AI Agent Identity button: * If the AI Agent Identity is enabling progress message displays, the enablement request was successful. This progress message can display for up to 10 minutes while the feature is being enabled. You can leave the page and return later to check progress. When the AI agents feature is fully enabled, the page displays the [icon: add, set=material, size=inline] Add AI Agent button. * If an error message displays, the enablement request failed. Double-check that your tenant environment meets the prerequisites in step 2, and if necessary, refresh the page and try enabling the feature again. * If you still can't access the feature, open a support case with Ping Identity support: > **Collapse: Show support guidance** > > 1. Go to . > > 2. Click Create a case. > > 3. Follow the steps in the case submission wizard by selecting your account and contract and answering questions about your tenant environments. > > 4. On the Please answer the following questions to help us understand the issue you're facing page, enter the following details, and then click Next: > > | Field | Value | > | ---------------------------------------------------- | ------------------------------------------------------------------------ | > | What product family is experiencing the issue? | Select PingOne Advanced Identity Cloud | > | What specific product is experiencing the issue? | Select Configuration | > | What version of the product are you using? | Select NA | > | What Hostname(s) or Tenant ID(s) does this apply to? | Enter the fully-qualified domain name (FQDN) for the tenant environment. | > > 5. On the Tell us about the issue page, enter the following details, and then click Next: > > | Field | Value | > | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | > | Provide a descriptive title for your issue | Enter `Unable to enable AI agents feature` | > | Describe the issue below | Enter one of the following descriptions based on the HTTP status code you received in step 4:\* `Received a 500 HTTP status code when making a POST request to the /environment/aiagent?_action=enable endpoint.`\* `Received a 200 HTTP status code when making a POST request to the /environment/aiagent?_action=enable endpoint, but still can't access the feature.` | > > 6. Click Submit. > > 7. Wait for Ping Identity support to respond to your case with next steps for troubleshooting the issue. ## Task 2: Promote the feature to your other tenant environments After you enable the feature in your development tenant environment, you can promote the configuration to your other tenant environments (UAT\[[2](#_footnotedef_2 "View footnote.")], staging, production). 1. Determine the promotion order of your tenant environments. This will depend on whether you have a [standard promotion group of environments](../tenants/self-service-promotions.html#standard-promotion-group-of-environments) or whether you also have [additional UAT environments](../tenants/self-service-promotions.html#additional-uat-environments). 2. In promotion order, for each upper tenant environment in your promotion group, perform the following steps: 1. Run a promotion to move the configuration to the upper tenant environment from its respective lower tenant environment. Learn more in: * [Manage self-service promotions using the admin console](../tenants/self-service-promotions-ui.html) * [Manage self-service promotions using the API](../tenants/self-service-promotions-api.html) 2. In the Advanced Identity Cloud admin console in the upper tenant environment, confirm that the left navigation menu displays the [icon: smart_toy, set=material, size=inline] AI Agents link, and that the [icon: add, set=material, size=inline] Add AI Agent button displays on the page. 3. (Optional) If you have sandbox\[[1](#_footnotedef_1 "View footnote.")] tenant environments, repeat task 1 for each of those. *** [1](#_footnoteref_1). A [sandbox environment](../tenants/environments-sandbox.html) is an [add-on capability](../product-information/add-on-capabilities.html).[2](#_footnoteref_2). A [user acceptance testing (UAT) environment](../tenants/environments-uat.html) is an [add-on capability](../product-information/add-on-capabilities.html).