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:

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.

Table 1. Data sources, staging tables, and target tables

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