Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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:

ReleaseStatus
AustraliaSupported
ZurichSupported
YokohamaSupported

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:

  1. Select Global from the application picker.
  2. Navigate to Application Access.
  3. Select the Can create, Can update, and Can delete check boxes.
  4. Select Update.
  5. Switch to the connector application scope.

Clear cache

Clear the cached data for the Data Source and Tables.

To clear the cache:

  1. Navigate to System Definition > Background Scripts
  2. 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');
    
  3. Select Run Script.

    Note: The script may take several minutes to complete.

  4. 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 sourceStaging tableTarget tables
SG-GCPVertexAI-Executionsn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_executionsn\_ai\_disc\_ai\_usage
SG-GCPVertexAI-Systemsn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_systemcmdb\_ai\_system\_component\_product\_model alm\_ai\_system\_digital\_asset cmdb\_ci\_function\_ai cmdb\_rel\_asset\_ci
SG-GCPVertexAI-Modelsn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_modelcmdb\_ai\_model\_product\_model alm\_ai\_model\_digital\_asset
SG-GCPVertexAI-Toolsn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_toolsn\_ent\_ai\_tool
SG-GCPVertexAI-Promptsn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_promptcmdb\_ai\_prompt\_product\_model alm\_ai\_prompt\_digital\_asset
SG-GCPVertexAI-System Subcomponent M2Msn\_ai\_disc\_gcp\_sgc\_sg\_gcp\_ai\_system\_subcomponent\_m2msn\_ent\_ai\_system\_subcomponent\_m2m