AI Service Graph Connector for GCP Vertex AI
The AI Service Graph Connector for GCP Vertex AI enables you to discover and import AI assets from your Google Cloud environment into ServiceNow AI Control Tower.
The connector integrates with your Google Cloud Platform account to catalog AI systems, agents, models, and prompts. Usage data is automatically collected and populated into the AI Control Tower value dashboard, providing comprehensive visibility and governance of your AI operations.
Download apps from the Store
Visit the ServiceNow store website to download the AI Service Graph Connector for GCP Vertex AI application.
Supported ServiceNow versions
This connector is supported on the following ServiceNow releases:
| Release | Status |
|---|---|
| Australia | Supported |
| Zurich | Supported |
| Yokohama | Supported |
User Roles
You must have one of the following roles assigned.
| Required Roles |
|---|
| sn_ai_disc.discovery_admin |
| sn_cmdb_int_util.sgc_admin |
ServiceNow Prerequisites
Complete the following setup steps once when configuring the connector for the first time.
Note: Updating data source access and clear cache is a prerequisite that needs to be completed only once, when setting up a new instance for the first time.
Update Data Source Access
The connector requires write permissions to the Data Source table to create data sources.
To enable data source creation:
- Select Global from the application picker.
- Navigate to Application Access.
- Select the Can create, Can update, and Can delete check boxes.
- Select Update.
- Switch to the connector application scope.
Clear cache
Clear the cached data for the Data Source and Tables.
To clear the cache:
- Navigate to System Definition > Background Scripts
Paste the following script into the Run Script text box:
GlideTableManager.invalidateTable('sys_data_source'); GlideCacheManager.flushTable('sys_data_source'); GlideTableManager.invalidateTable('sys_db_object'); GlideCacheManager.flushTable('sys_db_object');Select Run Script.
Note: The script may take several minutes to complete.
After completion, switch to the connector application scope.
GCP Vertex AI Prerequisites
Follow the setup instructions to create a service account, assign roles, bind roles to the service account, and enable APIs. To create a JKS file, a JSON file is required. If a JSON file is available, skip the JKS file creation step. After completing setup, register the connector in your ServiceNow instance. For setup instructions and API details, see the Service Graph connector for GCP Vertex AI- Setup Instructions [KB2731256] KB article.
Note: If Cloud trace service is not turned on, you will only be able to view the reasoning engine name, which is the top-level agent.
Cloud trace service is required to capture details like prompts, tools, models, and sub-agents. These are discovered only after they have been executed at least once.
If Cloud trace service is not enabled. You must enable cloud trace service and redeploy the agents to properly discover AI agents, tools, models, prompts and sub-agents.
Service Account and Role Configuration
Create a dedicated GCP service account with least-privilege access. The connector requires permissions to query Vertex AI agents and observability data.
The service account requires the following:
- A service account created in your GCP project with the appropriate Vertex AI roles.
- Roles bound to the service account at the project or organization level.
- Required APIs are enabled in your GCP project.
Data Mapping
The following table lists the data sources, the staging tables, and the target tables CMDB CI classes and non-CMDB classes where data is stored for a GCP Vertex AI project.
| Data source | Staging table | Target tables |
|---|---|---|
| SG-GCPVertexAI-Execution | sn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_execution | sn\_ai\_disc\_ai\_usage |
| SG-GCPVertexAI-System | sn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_system | cmdb\_ai\_system\_component\_product\_model alm\_ai\_system\_digital\_asset cmdb\_ci\_function\_ai cmdb\_rel\_asset\_ci |
| SG-GCPVertexAI-Model | sn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_model | cmdb\_ai\_model\_product\_model alm\_ai\_model\_digital\_asset |
| SG-GCPVertexAI-Tool | sn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_tool | sn\_ent\_ai\_tool |
| SG-GCPVertexAI-Prompt | sn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_prompt | cmdb\_ai\_prompt\_product\_model alm\_ai\_prompt\_digital\_asset |
| SG-GCPVertexAI-System Subcomponent M2M | sn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_system\_subcomponent\_m2m | sn\_ent\_ai\_system\_subcomponent\_m2m |