Microsoft Foundry (Classic) pattern-based discovery

  • Release version: Australia
  • Updated May 3, 2026
  • 9 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Microsoft Foundry (Classic) pattern-based discovery

    Microsoft Foundry (Classic) pattern-based discovery, part of the AI Agent Topology Mapping application in ServiceNow, enables automated discovery of Microsoft Foundry AI services, agents, models, and projects within Azure environments. This horizontal discovery process populates both CMDB and non-CMDB tables, establishing detailed configuration items (CIs) and relationships that provide comprehensive visibility into Microsoft Foundry resources.

    Show full answer Show less

    Key Features

    • AI Agent Topology Mapping Patterns: Includes specific patterns for discovering Azure AI Foundry Agents, Services, Projects, and Models, which collect detailed asset and metadata information.
    • Data Model and Tables: Discovers and populates various tables such as AI System Digital Asset, AI Prompt Digital Asset, AI Model Digital Asset, AI Function, Azure AI Foundry, Azure AI Project, and AI Model Deployment, capturing essential details like names, unique IDs, statuses, versions, manufacturers, and relationships.
    • CI Relationships: Establishes critical relationships between AI functions, Azure datacenters, resource groups, AI models, and deployments, supporting dependency mapping and service instance inclusion.
    • Tag-Based Discovery: Azure AI Service Foundry patterns collect resource tags into Key Value tables, facilitating better classification and filtering.
    • Discovery Prerequisites: Requires updated ServiceNow applications from the ServiceNow Store (including AI Agent Topology Mapping, Discovery and Service Mapping Patterns, Visibility Content, and CMDB CI Class Models), activation of cloud-related CI relationships, and proper Azure service account setup with necessary permissions.
    • Operational Considerations: Includes specific instructions for Azure Availability Sets and Zones, such as cleaning up pre-populated CIs and registering subscription features via Azure CLI.

    Practical Guidance for ServiceNow Customers

    • Ensure Application Currency: Keep discovery-related applications updated from the ServiceNow Store to support latest Microsoft Foundry patterns and capabilities.
    • Set Up Azure Service Accounts Correctly: Configure Azure accounts with appropriate permissions and datacenter URLs, especially for Azure GovCloud environments.
    • Configure Discovery Schedules: Use the Discovery Admin Workspace to create Azure cloud discovery schedules and optionally limit discovery to new subscriptions to optimize performance.
    • Activate Cloud CI Relationships: Enable CI relationships required for tag-based discovery to integrate discovered components into service instances effectively.
    • Utilize Dependency View Maps: Visualize discovered Microsoft Foundry resources and their relationships in ServiceNow’s Dependency Views for better impact analysis and service management.
    • Leverage AI Control Tower Integration: If using AI Control Tower, discovered data in non-CMDB tables can be viewed and managed through its workspace.

    Expected Outcomes

    By implementing Microsoft Foundry pattern-based discovery, ServiceNow customers gain:

    • Comprehensive and up-to-date visibility into Microsoft Foundry AI services, models, agents, and related Azure resources within their CMDB.
    • Accurate CI relationships that enable effective service mapping, impact analysis, and operational management of AI workloads.
    • Improved query performance when populating service account and logical datacenter fields directly in cloud CIs (from version 1.30.2 onward).
    • Automated tag collection that enhances resource organization and filtering capabilities.
    • Streamlined discovery processes with support for incremental discovery of new subscriptions and compliance with Azure-specific operational requirements.

    AI Agent Topology Mapping discovers Microsoft Foundry (Classic) services, agents, and models during horizontal discovery.

    Request new or enhanced Patterns on the ServiceNow® Store

    Visit the ServiceNow Store to view all the available updates and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.

    Microsoft Foundry data model

    The following diagram illustrates the tables and relationships that the AI Agent Topology Mapping application creates when discovering Microsoft Foundry resources.

    Figure 1. Tables and relationships populated during Microsoft Foundry discovery
    Microsoft Foundry data model
    Note:
    The following relationships are stored in the Asset-CI Relationship [cmdb_rel_asset_ci] table and aren't represented in the Dependency View map:
    • The Deployed as::Deployment of relationship between AI Function [cmdb_ci_function_ai] and AI System Digital Asset [alm_ai_system_digital_asset].
    • The Used by::Uses relationship between AI Model Deployment [cmdb_ci_ai_model_deployment] and AI Model Digital Asset [alm_ai_model_digital_asset].

    Discovery requirements

    Verify that the applications are up to date
    Discovering these resources may require updating to the latest version of the following applications from the ServiceNow Store:
    • AI Agent Topology Mapping
    • Discovery and Service Mapping Patterns
    • Visibility Content
    • CMDB CI Class Models
    Activate the cloud-related CI relationships
    To include discovered components into service instances, enable CI relationships used in tag-based discovery by Service Mapping. These CI relationships are available from the 1.0.68 release on the ServiceNow Store. For operational steps, see Tag-based discovery configuration.
    Azure Availability Set
    Wait for the Clean-Up job for Availability zone to clear availability set record schedule job to delete all the pre-populated availability set's Configuration Items (CI) in the cmdb_ci_azure_availability_set table.
    Azure Availability Zone

    To run a discovery with Azure Availability Zone, register the subscription ID to the AvailabilityZonePeering feature with AZ CLI using az feature register -n AvailabilityZonePeering --namespace Microsoft.Resources to use the Check Zone Peering API. Check the status with az feature show -n AvailabilityZonePeering --namespace Microsoft.Resources before running discovery.

    Set up Azure service accounts
    Enable Cloud Discovery to access your Azure environment.
    Discovering Azure GovCloud (US) accounts requires using a datacenter URL when setting up an Azure service account. For more information, see Set up Azure service accounts.
    Create an Azure cloud discovery schedule
    For more information, see Create an Azure Discovery schedule in Discovery Admin Workspace.
    (Optional) Discover datacenters only for new subscriptions
    Starting with Zurich Patch 2, you can discover datacenters only for new subscriptions added since the last discovery. For more information, see Discover datacenters only for new cloud accounts.
    (Optional) Populate Service Account and Logical Datacenter fields in cloud CIs
    Starting with Discovery and Service Mapping Patterns version 1.30.2, you can improve query performance by populating Service Account and Logical Datacenter fields directly in cloud CIs. For more information, see Improved query performance with direct field population in CI tables.

    Verify the REST API Permissions

    Download the Cloud Discovery patterns spreadsheet so you can grant user permissions required for running the Discovery patterns. In addition to permissions, the spreadsheet also includes useful information such as pattern names, types, CI Classes, and links to vendor documentation. New patterns are available quarterly, so check periodically to be sure you have the latest version of the spreadsheet.

    Data collection

    The AI Agent Topology Mapping application includes the following patterns for Microsoft Foundry discovery:
    • Azure - AI Foundry Agents
    • Azure - AI Service Foundry
    • Azure - AI Service Foundry Project
    • Azure - AI Foundry Models

    The Azure - AI Foundry Agents pattern collects AI System Digital Assets, AI Prompt Digital Assets, and Key Value information. You can view this information in the Related Links section of the CI record by navigating to All > Configuration > Azure > Azure AI Foundry Agents and selecting the relevant record.

    The Azure - AI Foundry Models pattern collects AI Model Digital Assets. You can view this information in the Related Links section of the CI record by navigating to All > Configuration > Azure > Azure AI Foundry Models and selecting the relevant record.

    The AI Agent Topology Mapping application populates data in both CMDB and non-CMDB tables.

    Data stored in non-CMDB tables

    The AI Agent Topology Mapping application populates data in non-CMDB tables when running the Microsoft Foundry patterns.

    If you have the AI Control Tower application, you can view the information in the AI Control Tower Workspace.

    Table 1. AI System Digital Asset [alm_ai_system_digital_asset]
    Field Description
    Display name [display_name] Display name of the Microsoft Foundry agent.
    External record reference [external_ref_id] Unique identifier of the Microsoft Foundry agent.
    Model [model] References the AI System Component Product Model [cmdb_ai_system_component_product_model] table.
    Asset type [model_category] Asset type of the agent. Value is set to Agentic AI.
    State [install_status] State of the agent. Value is set to Deployed.
    AI prompts [ai_prompts] References the AI Prompt Digital Asset [alm_ai_prompt_digital_asset] table.
    AI models [ai_models] References the AI Model Digital Asset [alm_ai_model_digital_asset] table.
    Configuration Item [ci] References the AI Function [cmdb_ci_function_ai] table.
    Table 2. AI System Component Product Model [cmdb_ai_system_component_product_model]
    Field Description
    Name [name] Name of the Microsoft Foundry agent.
    Short description [short_description] Description of the Microsoft Foundry agent.
    Status [status] Operational status of the agent. Value is set to PREPARED.
    Version [version] Version of the Microsoft Foundry agent.
    Manufacturer [manufacturer] Cloud provider of the resource. Value is set to Azure.
    Model categories [cmdb_model_category] Model category. Value is set to Agentic AI.
    Table 3. AI Prompt Digital Asset [alm_ai_prompt_digital_asset]
    Field Description
    Prompt information [prompt_info] Instruction text defined for the Microsoft Foundry agent.
    Model [model] References the AI Prompt Product Model [cmdb_ai_prompt_product_model] table.
    Asset type [model_category] Asset type of the prompt. Value is set to AI prompt.
    Configuration Item [ci] References the AI Function [cmdb_ci_function_ai] table.
    Table 4. AI Prompt Product Model [cmdb_ai_prompt_product_model]
    Field Description
    Name [name] Name of the Microsoft Foundry agent, used to identify the associated prompt model.
    Manufacturer [manufacturer] Cloud provider of the resource. Value is set to Azure.
    Model categories [cmdb_model_category] Model category. Value is set to AI prompt.
    Table 5. AI Model Digital Asset [alm_ai_model_digital_asset]
    Field Description
    Display name [display_name] Name of the foundation model.
    External record reference [external_ref_id] Resource identifier of the foundation model.
    Model [model] References the AI Model Product Model [cmdb_ai_model_product_model] table.
    Asset type [model_category] Asset type of the model. Value is set to AI model.
    Vendor [vendor] Provider of the foundation model.
    Configuration Item [ci] References the AI Model Deployment [cmdb_ci_ai_model_deployment] table.
    Table 6. AI Model Product Model [cmdb_ai_model_product_model]
    Field Description
    Name [name] Name of the foundation model.
    Model number [model_number] Model ID assigned by Microsoft Foundry.
    Version [version] Version of the foundation model.
    Description [description] Description of the foundation model.
    Manufacturer [manufacturer] Provider of the foundation model.
    Model categories [cmdb_model_category] Model category. Value is set to AI model.

    Data stored in CMDB tables

    The AI Agent Topology Mapping application populates data in the CMDB when running the Microsoft Foundry patterns.

    Table 7. AI Function [cmdb_ci_function_ai]
    Field Description
    Name [name] Name of the Microsoft Foundry agent.
    Object ID [object_id] Unique identifier of the Microsoft Foundry agent.
    Description [short_description] Description of the Microsoft Foundry agent.
    Manufacturer [manufacturer] Cloud provider of the resource. Value is set to Azure.
    Operational status [operational_status] Operational status of the resource. Default value is Operational.
    Install Status [install_status] Install status of the resource. Default value is Installed.
    Comments [comments] Resource type identifier. Value is set to Azure::Foundry::Agent.
    Table 8. Azure AI Foundry [cmdb_ci_azure_ai_foundry]
    Field Description
    Name [name] Name of the Microsoft Foundry service.
    Object ID [object_id] Unique identifier of the Microsoft Foundry service.
    Description [short_description] Description of the resource. Value is set to Azure Foundry Service.
    Operational status [operational_status] Operational status of the resource. Default value is Operational.
    Install Status [install_status] Install status of the resource. Default value is Installed.
    Azure Service Type [azure_service_type] Azure resource type.

    For example: microsoft.cognitiveservices/accounts.
    Azure Service Kind [azure_service_kind] Resource kind of the Microsoft Foundry service.

    For example: AIServices.
    Table 9. Azure AI Project [cmdb_ci_azure_ai_project]
    Field Description
    Name [name] Name of the Microsoft Foundry project.
    Object ID [object_id] Unique identifier of the Microsoft Foundry project.
    Comments [comments] Azure region where the Microsoft Foundry project is deployed.
    Operational status [operational_status] Operational status of the resource. Default value is Operational.
    Install Status [install_status] Install status of the resource. Default value is Installed.
    Model number [model_number] Internal identifier of the Microsoft Foundry project.
    Azure Project Kind [azure_project_kind] Resource kind of the Microsoft Foundry project.

    For example: AIServices.
    Table 10. AI Model Deployment [cmdb_ci_ai_model_deployment]
    Field Description
    Name [name] Name of the AI model available in Microsoft Foundry.
    Object ID [object_id] Resource identifier of the AI model.
    Description [short_description] Description of the AI model.
    Model number [model_number] Model name, used as an identifier.
    Manufacturer [manufacturer] Provider of the AI model.

    For example: Microsoft, Anthropic, or OpenAI.
    Attributes [attributes] Lifecycle status of the model as reported by the API.

    For example: Stable or Deprecated.
    Comments [comments] Azure resource type identifier. Value is set to Microsoft.CognitiveServices/locations/models.
    Operational status [operational_status] Operational status of the resource. Default value is Operational.
    Install Status [install_status] Install status of the resource. Default value is Installed.

    Dependency Views map

    On the Dependency Views map, you can view discovered Microsoft Foundry resources and the relationships between them.

    Figure 2. Microsoft Foundry dependency view
    Microsoft Foundry CIs and connections on a Dependency Views map

    CI relationships

    The Microsoft Foundry patterns create the following relationships and references to support Microsoft Foundry discovery. References link to records in other tables and don't appear in the CI Relationship [cmdb_rel_ci] table.

    Table 11. CI relationships
    CI/Table Relationship CI/Table
    AI Function [cmdb_ci_function_ai] Hosted on::Hosts Azure Datacenter [cmdb_ci_azure_datacenter]
    Azure AI Project [cmdb_ci_azure_ai_project] Contains::Contained by AI Function [cmdb_ci_function_ai]
    Resource Group [cmdb_ci_resource_group] Contains::Contained by AI Function [cmdb_ci_function_ai]
    AI Function [cmdb_ci_function_ai] Deployed as::Deployment of AI System Digital Asset [alm_ai_system_digital_asset]
    Azure AI Foundry [cmdb_ci_azure_ai_foundry] Hosted on::Hosts Azure Datacenter [cmdb_ci_azure_datacenter]
    Resource Group [cmdb_ci_resource_group] Contains::Contained by Azure AI Foundry [cmdb_ci_azure_ai_foundry]
    Azure AI Foundry [cmdb_ci_azure_ai_foundry] Contains::Contained by Azure AI Project [cmdb_ci_azure_ai_project]
    Azure AI Project [cmdb_ci_azure_ai_project] Hosted on::Hosts Azure Datacenter [cmdb_ci_azure_datacenter]
    Resource Group [cmdb_ci_resource_group] Contains::Contained by Azure AI Project [cmdb_ci_azure_ai_project]
    AI Function [cmdb_ci_function_ai] Depends on::Used by AI Model Deployment [cmdb_ci_ai_model_deployment]
    AI Model Deployment [cmdb_ci_ai_model_deployment] Hosted on::Hosts Azure Datacenter [cmdb_ci_azure_datacenter]
    AI Model Deployment [cmdb_ci_ai_model_deployment] Used by::Uses AI Model Digital Asset [alm_ai_model_digital_asset]
    Table 12. CI references
    CI/Table Field Referenced CI/Table
    AI System Digital Asset [alm_ai_system_digital_asset] Model [model] AI System Component Product Model [cmdb_ai_system_component_product_model]
    AI System Digital Asset [alm_ai_system_digital_asset] AI prompts [ai_prompts] AI Prompt Digital Asset [alm_ai_prompt_digital_asset]
    AI System Digital Asset [alm_ai_system_digital_asset] AI models [ai_models] AI Model Digital Asset [alm_ai_model_digital_asset]
    AI System Digital Asset [alm_ai_system_digital_asset] Configuration Item [ci] AI Function [cmdb_ci_function_ai]
    AI Prompt Digital Asset [alm_ai_prompt_digital_asset] Model [model] AI Prompt Product Model [cmdb_ai_prompt_product_model]
    AI Prompt Digital Asset [alm_ai_prompt_digital_asset] Configuration Item [ci] AI Function [cmdb_ci_function_ai]
    AI Model Digital Asset [alm_ai_model_digital_asset] Model [model] AI Model Product Model [cmdb_ai_model_product_model]
    AI Model Digital Asset [alm_ai_model_digital_asset] Configuration Item [ci] AI Model Deployment [cmdb_ci_ai_model_deployment]
    Key Value [cmdb_key_value] Configuration item [configuration_item] Azure AI Foundry [cmdb_ci_azure_ai_foundry]
    Key Value [cmdb_key_value] Configuration item [configuration_item] Azure AI Project [cmdb_ci_azure_ai_project]

    Azure tag discovery

    The Azure - AI Service Foundry pattern collects tags and populates them in the Key Value [cmdb_key_value] table.

    Table 13. Key Value [cmdb_key_value]
    Field Description
    Key [key] Tag name.
    Value [value] Tag value.
    Configuration item [configuration_item] References the Azure AI Foundry [cmdb_ci_azure_ai_foundry] table.

    The Azure - AI Service Foundry Project pattern collects tags and populates them in the Key Value [cmdb_key_value] table.

    Table 14. Key Value [cmdb_key_value]
    Field Description
    Key [key] Tag name.
    Value [value] Tag value.
    Configuration item [configuration_item] References the Azure AI Project [cmdb_ci_azure_ai_project] table.