---
sourceDocument: Australia Enable AI
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/intelligent-experiences

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Enable AI

ft:clusterId :

    - platai

bundleId :

    - platai

workflow :

    - Platform


---

# CMDB principal class manager AI agent

# CMDB principal class manager AI agent {#ariaid-title1}

Release version: Australia  
Updated August 14, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of CMDB principal class manager AI agent

The CMDB principal class manager AI agent assists ServiceNow users in managing principal configuration item (CI) classes within the Configuration Management Database (CMDB).
It guides users through tasks such as checking governance access, listing principal and potential principal CI classes, and marking or unmarking CI classes as principal based on user permissions.
Show full answer Show less  

## Workflow

* The agent first verifies the CMDB governance access level of the current user.
* It then lists all existing and suggested principal CI classes for review.
* If the user lacks permission to mark principal classes, the agent skips relevant steps.
* Users can choose to mark or unmark CI classes as principal from the suggested or current list.
* The agent allows users to either finish the review or request details about specific CI classes.
* Upon completion, users with write access are notified that managing principal CI classes is done.

## Configuration and Access Controls

* **Third-party access:** Disabled by default; enabling allows third-party AI agents to use this agent.
* **AI specialist access:** Disabled by default; enabling provides advanced configuration options like mapping inputs and response templates.
* **Long-term memory:** Disabled by default; when enabled, previous user interactions provide context to the AI model.
* These settings are managed via system properties and AI Agent configuration tables.
* **Allowed user roles:** Primarily users with the `sncmdbadmin` role can access and perform actions with this agent.

## Tools and Integration

* The agent uses scripts and tools to perform actions such as fetching governance access levels, identifying similar CI classes, and marking or unmarking principal CI classes.
* Designed to be integrated with Virtual Agent or ServiceNow Otto panel through the Assistant Designer.
* It can be included in agentic workflows related to CMDB Data Governance.

## Practical Benefits for ServiceNow Customers

This AI agent streamlines the management of principal CI classes by automating governance checks and providing guided workflows, ensuring only authorized users can update principal classes. It helps maintain accurate CMDB data governance, reduces manual effort, and supports compliance with organizational policies.  
Performs actions related to principal configuration item (CI) classes

## Workflow {#cmdb-cmdb-principal-class-manager-ai-agent__zsmdlwierhjt}

The agent helps users complete tasks related to CMDB principal class manager.

1. Check the CMDB governance access level for the current user.
2. List all existing and potential principal CI classes.
3. If the user does not have permission to mark principal classes, skip to step 7.
4. Ask the user whether they want to mark a suggested CI class or unmark a current CI class from the list as principal.
5. If the user specifies a class, mark or unmark the selected CI class as principal.
6. Ask the user if they are done reviewing, or if they want to see details about a specific CI class.
7. If the user has write access, inform the user that they have completed the step of managing principal CI classes.
{#cmdb-cmdb-principal-class-manager-ai-agent__ol_hcp_qwx_njc}  
{#cmdb-cmdb-principal-class-manager-ai-agent__zsmdlwierhjt__entry__2}

| Field | Description |
|-|-|
| Allow third party to access this AI agent | When enabled, third-party AI agents can use this agent. This value is off (false) by default. This setting is defined in the AI Agent configs \[sn_aia_agent_config\] table on the External discoverable field. |
| Allow AI specialists to access this AI agent | When enabled, AI specialists can use this agent. This value is off (false) by default. When set to true, more configuration options for tools become available so that an AI specialist can map inputs and response templates to tool outputs. This setting is defined in the AI Agent configs \[sn_aia_agent_config\] table on the Specialist enabled field. |
| Manage long-term memory | When enabled, all previous user interactions are used as context for the LLM. This value is off (false) by default. This setting is defined by the sn_aia.ltm.enable_long_term_memory system property. For more information, see [ServiceNow Otto AI agents reference](https://www.servicenow.com/docs/MUqSU8rHp3ao~q3QEWgHkA "Find more information about user roles, tables, and the different properties that are installed in ServiceNow Otto AI agents."). |
| Tools | Script :   Get CMDB governance access level :   Get similar CI Classes :   Identify principal classes :   Mark CI class as principal :   Unmark CI class as principal |
| Allowed user roles The specific user roles that can access this AI agent. | sn_cmdb_admin |
| Data access roles The specific user identity roles that determine which data the AI agent can access and what actions it can take. | sn_cmdb_admin |
| Triggers | Optional. None defined by default. An admin can specify triggers if desired. For more information, see [Add a trigger to an AI agent](https://www.servicenow.com/docs/NXqRJBQV_Vw00FEzklcAJw "In the guided setup for an AI agent, add triggers to run the AI agent automatically when certain conditions are met."). |
| Channels | Configure an assistant for Virtual Agent or ServiceNow Otto panel using [Assistant Designer](https://www.servicenow.com/docs/access?context=configure-now-assist-va&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US). |
| Used in agentic workflows | CMDB Data Governance |
[Table 1. Configuration]

Learn more about Configuration Management Database (CMDB) at [Configuration Management Database (CMDB)](https://www.servicenow.com/docs/access?context=c_ITILConfigurationManagement&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US).

