AI Service Graph Connector for Salesforce
The AI Service Graph Connector for Salesforce enables to discover and import AI agents, models, prompts, tools, and track agent usage from your Salesforce environment into ServiceNow AI Control Tower.
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 check boxes.
- Select Update.
- Switch to the connector application scope.
Clear the cached data for the Data Source and Tables.
- Navigate to .
- Enter the following script in 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 might take several minutes to complete. After completion, switch to the connector application scope.
Salesforce Prerequisites
Before proceeding, ensure you have:
- Salesforce Account: Active Salesforce account with access to the services you want to connect.
- Credentials: Salesforce Consumer Key and Consumer Secret with read permissions for the services you plan to integrate.
Required Permissions:
These are found in Permission Sets or Profiles → System Permissions section:
- Manage Al Agents (core/common permission required in almost all cases).
- Agent-type-specific:
- Service Agents (common use case): Manage Agentforce Service Agents + Manage Al Agents.
- Agentforce (Default) Agent: Manage Agentforce Default Agent + Manage Al Agents.
- Employee Agents: Manage Al Agents (sometimes Manage Agentforce Employee Agents or Manage Employee Agent Access (Beta) for access management).
Salesforce Setup Documentation:
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 |