AI Service Graph Connector for Hugging Face
The AI Service Graph Connector for Hugging Face enables you to discover and import AI assets from your Hugging Face environment into ServiceNow AI Control Tower.
The connector integrates with your Hugging Face account to catalog AI systems, agents, models, and prompts from Hugging Face Spaces. 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 Hugging Face application.
Supported ServiceNow versions
| Release | Status |
|---|---|
| Australia | Supported |
| Zurich | 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
Hugging Face Prerequisites
Complete the following steps in your Hugging Face environment before creating a connection.
- Hugging Face account (If you don't have a Hugging Face account, create one at https://huggingface.co)
- Generate API Tokens
Discovery Scope
The Hugging Face connector discovers AI components from Hugging Face Spaces by analyzing Python files using pattern matching. The following AI asset types are identified during discovery:
| Asset Type | Description |
| AI Agents/Systems | Applications and agent implementations identified in Space code. |
| AI Models | Language models, embeddings, and other ML models referenced in code. |
| AI Tools | Function definitions and tool implementations. |
| AI Prompts | Prompt templates and configuration strings. |
The discovery process follows these stages:
- Space Discovery – Identifies Hugging Face Spaces based on organization membership or public visibility.
- Code Analysis – Downloads and analyzes Python files from each Space.
- Pattern Matching – Identifies these components:
- Agent implementations (for example, LangChain agents, custom frameworks)
- Model references (for example, model_id parameters, API calls)
- Tool definitions (for example, function decorators, tool classes)
- Prompt templates (for example, PromptTemplate, string templates)
- Relationship Mapping – Links AI systems to their sub-components such as models, tools, and prompts.
- Incremental Updates – Processes only Spaces modified since the last successful import.
Note: The connector performs incremental discovery, only processing spaces that have been modified since it's last successful import.
Data Mapping
The connector maps Hugging Face AI assets to ServiceNow staging tables and target CMDB tables for comprehensive asset management.
| Data Source | Staging Table | Target Table | Description |
|---|---|---|---|
| SG-HuggingFace-Discovery | sn_ai_hf_disc_ai_discovery_staging | Parent data source | Discovers HuggingFace Spaces and feeds other staging tables |
| SG-HuggingFace-System | sn_ai_hf_disc_ai_system_staging | alm_ai_system_digital_asset | Imports AI systems and applications |
| SG-HuggingFace-Model | sn_ai_hf_disc_ai_model_staging | alm_ai_model_digital_asset | Imports AI models and embeddings |
| SG-HuggingFace-Prompt | sn_ai_hf_disc_ai_prompt_staging | alm_ai_prompt_digital_asset | Imports prompt templates |
| SG-HuggingFace-Tool | sn_ai_hf_disc_ai_tool_staging | sn_ent_ai_tool | Imports tool and function definitions |
| SG-HuggingFace-SubComponents M2M | sn_ai_hf_disc_ai_m2m_staging | sn_ent_ai_system_subcomponent_m2m | Imports relationships between AI systems and their components |
Target Tables
The Hugging Face connector populates the following target tables in ServiceNow.
Digital Asset Tables
- alm_ai_system_digital_asset – Stores AI System digital assets discovered from Hugging Face Spaces.
- alm_ai_model_digital_asset – Stores AI Model digital assets including language models and embeddings.
- alm_ai_prompt_digital_asset – Stores AI Prompt digital assets including prompt templates and configurations.
Entity Tables
- sn_ent_ai_tool: Stores AI Tools including function definitions and tool implementations
- sn_ent_ai_system_subcomponent_m2m: Stores many-to-many relationships between AI systems and their subcomponents (models, tools, prompts)
Note: The Hugging Face connector currently focuses on discovery of AI assets. Usage and execution tracking capabilities may be added in future versions.
Data Flow Architecture
The Hugging Face connector follows this data flow:
| Stage | Description |
| Data Source | The connector calls Hugging Face APIs to discover Spaces based on organization or public visibility settings. |
| Staging Tables | Raw data is loaded into import set staging tables for processing. |
| Transform Maps | Data is transformed, validated, and mapped to target table schema. |
| Target Tables | Cleaned and structured data is inserted into the final destination tables in the ServiceNow CMDB. |