AI Service Graph Connector for Salesforce
Summarize
Summary of AI Service Graph Connector for Salesforce
The AI Service Graph Connector for Salesforce enables ServiceNow customers to discover and import AI assets from their Salesforce environment into ServiceNow AI Control Tower. This integration catalogs AI systems, agents, models, and prompts from Salesforce, automatically collecting usage data to populate the AI Control Tower value dashboard. This provides comprehensive visibility and governance over AI operations within the ServiceNow platform.
Show less
Supported Versions and Roles
- The connector supports ServiceNow releases: Australia, Zurich, and Yokohama patch 11.
- Users must have one of the following roles to configure the connector: snaidisc.discoveryadmin or sncmdbintutil.sgcadmin.
Setup and Prerequisites
Initial configuration requires these key steps:
- Update Data Source Access: Assign write permissions (create, update, delete) to the Data Source table to enable creation of data sources.
- Clear Cache: Run a background script that invalidates and flushes cached data for the Data Source and related tables. This step ensures the connector operates with up-to-date metadata.
- These steps are one-time requirements when setting up the connector on a new instance.
Data Mapping and Integration Details
The connector maps Salesforce AI asset data to corresponding ServiceNow tables, enabling seamless data synchronization:
- AI Agents: Mapped from Salesforce’s almaisystemdigitalasset to ServiceNow’s cmdbaisystemcomponentproductmodel, including fields such as Model ID, Agent ID, Version, Status, Quantity, Vendor, Company, Source System, and Asset Type.
- AI Models: Synchronized from almaimodeldigitalasset to cmdbaimodelproductmodel with fields like Asset Type, Foundation Model ID, Model, Status, External Reference ID, Vendor, and Quantity.
- AI Tools: Integrated through the AI subcomponent reference table snentaitool linked to the AI system/model tables, capturing Description, Type, Source Information, Name, and Table Name.
- AI Prompts: Imported from almaipromptdigitalasset to cmdbaipromptproductmodel, including Model Name, Description, Table Name, and External Reference ID.
- AI Agents Usage: Usage data is mapped from snaidiscaiusage to the AI system/model table, capturing User, Time, Session ID, Total Invocations, and Conversion Definition ID.
Practical Benefits
By implementing this connector, ServiceNow customers gain automated discovery and governance of their Salesforce AI assets within the AI Control Tower. This integration improves operational efficiency by consolidating AI asset visibility and usage monitoring in a single platform, enabling better control and management of AI initiatives across enterprise environments.
The AI Service Graph Connector for Salesforce enables you to discover and import AI assets from your Salesforce environment into ServiceNow AI Control Tower.
The connector integrates with your Salesforce 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 Salesforce application.
Supported ServiceNow versions
This connector is supported on the following ServiceNow releases:
| Release | Status |
|---|---|
| Australia | Supported |
| Zurich | Supported |
| Yokohama patch 11 | 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.
The connector requires write permissions to the Data Source table to create data sources.
- Select Global from the application picker
- Navigate to Application Access
- Select the Can create, Can update, and Can delete checkboxes.
- Select Update
- Switch to the connector application scope
Clear the cached data for the Data Source and Tables.
- 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
Data Mapping
AI Agents: alm_ai_system_digital_asset -> Model table (cmdb_ai_system_component_product_model)
| Required Fields | ServiceNow (Target) | Salesforce (Staging) |
| Model ID | Model | model_id |
| Agent ID | Product instance identifier | agent_id |
| Version | External record reference | version_id |
| Status | State (install_status) | u_status |
| Quantity | Quantity | quantity |
| Vendor | Vendor | u_vendor |
| Company | Company | cleansed_manufacturer_ref |
| Source System | Source System | vendor |
| Asset Type | Model Category | asset_type |
AI Models: alm_ai_model_digital_asset -> Model table (cmdb_ai_model_product_model)
| Required Fields | ServiceNow (Target) | Salesforce (Staging) |
| Asset Type | Model category | asset_type |
| Foundation Model ID | Base model | foundation_model_identifier |
| Model | Model | base_model |
| Status | State (install_status) | u_status |
| External Reference ID | External record reference | id |
| Vendor | Vendor | cleansed_vendor_ref |
| Quantity | Quantity | quantity |
AI Tools: AI subcomponent reference table (sn_ent_ai_tool) -> sn_ent_ai_system_subcomponent_m2m-> AI system/Model table (alm_ai_system_digital_asset)
| Required Fields | ServiceNow (Target) | Salesforce (Staging) |
| Description | Description | description |
| Type | Type | type |
| Source Information | Source information | source |
| Name | Name | developername |
| Table Name | Target document table | tablename |
AI Prompts: alm_ai_prompt_digital_asset -> Model table (cmdb_ai_prompt_product_model)
| Required Fields | ServiceNow (Target) | Salesforce (Staging) |
| Model Name | Model | model |
| Description | Prompt information | description |
| Table Name | ServiceNow table | table_name |
| ID | External record reference | id |
AI Agents Usage: sn_ai_disc_ai_usage -> AI system/Model table (alm_ai_system_digital_asset)
| Required Fields | ServiceNow (Target) | Salesforce (Staging) |
| User | User | user |
| Time | Time | timestamp |
| Parent ID | Session ID | parentid |
| Total Invocations | Count | totalinvocations |
| Conversion Definition ID | AI system | conversationdefinitionid |