---
sourceDocument: Australia ServiceNow AI Platform Capabilities
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/servicenow-platform

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Business application candidate agent reference

# Business application candidate agent reference {#ariaid-title1}

Release version: Australia  
Updated October 6, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) 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 Business application candidate agent reference

The Business application candidate agent in ServiceNow Australia release is designed to automate the identification and recommendation of business applications related to app services using AI-driven matching.
It includes configurable system properties to control job execution, filtering criteria, AI confidence thresholds, and operational limits.
This agent helps streamline the management of business applications by providing AI-generated candidate recommendations that can be reviewed and accepted or rejected by users with the appropriate roles.
Show full answer Show less  

## Configuration and Key Properties

* **System Properties:** All agent settings use the prefix `snsmgenai.businessappmatching.` and include parameters for filtering, job scheduling, AI processing, and confidence thresholds.
* **Scope and Filtering:** Properties allow customers to specify which app service subclasses to include or exclude, and to skip inactive app services or business applications via encoded query criteria.
* **Job Cadence:** Synchronization and processing jobs run on configurable intervals, with defaults such as 7 days for full sync, 1 hour for processing batches, and 30 minutes for retry polling.
* **Processing Tuning:** Batch size controls the number of app services processed per job (default 1000, max 10,000), while limits on similar entries and negative feedback manage AI inference scope and learning.
* **Confidence Thresholds:** Minimum AI confidence ratings dictate when recommendations or CI relationship candidates are generated (default medium rating = 3). An optional auto-accept confidence setting can automate acceptance of high-confidence matches.
* **User Group Context:** A property determines whether AI includes detailed user and group ownership data from app service records, enriching analysis when enabled.

## Operational Constraints

* The agent supports up to 250,000 app services; exceeding this disables synchronization and requires support intervention for scaling.
* Recommendations are retained for up to two years to balance storage and performance.

## Tables and Roles

* **Tables Used:** The agent utilizes specific CMDB and internal tables to manage processing queues, run states, and store recommendation records for review.
* **Role Requirements:** Access to all agent functionalities requires the `itil` role, which enables job activation, property configuration, recommendation review, and modification of business application data.

## Practical Implications for ServiceNow Customers

By leveraging the Business application candidate agent, customers can automate and optimize the identification of business applications linked to their app services, improving CMDB accuracy and operational efficiency. Configurable properties give customers control over filtering, processing frequency, and confidence thresholds, allowing tuning to their specific environment and trust level in AI recommendations. Understanding operational limits and role requirements ensures proper deployment and governance. This agent is a valuable tool for customers aiming to enhance their service management through AI-driven insights while maintaining control over recommendation validation.  
Reference information for the Business application candidate agent, including system properties, configuration limits, table names, role requirements, and operational constraints.

## System properties {#na-cmdb-agent-biz-app-candidate-ref__section_system_properties}

All agent configuration properties use the prefix `sn_sm_gen_ai.business_app_matching.*`. You can configure the properties to control job behavior, filtering, performance, and AI confidence thresholds.  
Scope and filtering

The following properties control which app services and business applications are included in processing.
{#na-cmdb-agent-biz-app-candidate-ref__table_scope_filtering__entry__3}

| Property | Default | Description |
|-|-|-|
| `supported_app_service_classes` | (empty) | Comma-separated list of app service subclasses to include. Empty (with empty unsupported list) means all classes are included. |
| `unsupported_app_service_classes` | (empty) | Comma-separated list of app service subclasses to exclude. |
| `app_service_skip_criteria` | `operational_status=2` | Encoded query --- app services that match this criterion are skipped during processing. Default skips inactive services. |
| `business_app_skip_criteria` | `operational_status=2` | Encoded query --- business applications that match this criterion are excluded from matching. Default excludes inactive applications. |
[Table 1. Scope and filtering properties]

{#na-cmdb-agent-biz-app-candidate-ref__table_scope_filtering}  
Job cadence

The following properties control how frequently the Data Synchronization and Processing jobs run.
{#na-cmdb-agent-biz-app-candidate-ref__table_job_cadence__entry__3}

| Property | Default | Description |
|-|-|-|
| `sync_interval_in_seconds` | 604800 (7 days) | How often the Data Sync job re-runs after completing a full synchronization cycle. |
| `batch_interval_in_seconds` | 3600 (1 hour) | How often the Processing job re-fires after completing a batch of recommendations. |
| `retry_interval_in_seconds` | 1800 (30 min) | How often the Processing job polls while waiting for synchronization to finish or AI Search indexing to complete. |
[Table 2. Job cadence properties]

{#na-cmdb-agent-biz-app-candidate-ref__table_job_cadence}  
Processing tuning

The following properties tune AI inference and recommendation generation.
{#na-cmdb-agent-biz-app-candidate-ref__table_processing_tuning__entry__3}

| Property | Default | Description |
|-|-|-|
| `batch_size` | 1000 | Number of app services processed per job execution. Hard cap: 10,000. Adjust this setting for performance on instances with very large numbers of app services. |
| `similar_max_entries` | 100 | Maximum number of similar app service results returned by AI search per inference. Limits AI context and processing time. |
| `negative_feedback_max_entries` | 50 | Maximum number of rejected recommendations used as negative feedback per inference. Limits the number of past rejections the AI considers when learning. |
[Table 3. Processing tuning properties]

{#na-cmdb-agent-biz-app-candidate-ref__table_processing_tuning}  
Confidence thresholds

The following properties control the minimum confidence levels required to generate and auto-accept recommendations.
{#na-cmdb-agent-biz-app-candidate-ref__table_confidence_thresholds__entry__3}

| Property | Default | Description |
|-|-|-|
| `business_app_confidence_minimum_rating` | 3 (Medium) | Minimum AI confidence rating (1=Very Low, 5=Very High) required to create a recommendation. Recommendations with confidence lower than this threshold are silently skipped. Increase this value to see only high-confidence recommendations; decrease to see more candidates. |
| `relationship_confidence_minimum_rating` | 3 (Medium) | Minimum confidence rating required to create a CI relationship candidate when a business application match is found. Affects which related application service links are proposed. |
| `auto_accept_confidence_minimum_rating` | (empty) | If set, recommendations where all confidence scores meet or exceed this value are automatically accepted without human review. Leave empty to require manual review for all recommendations. Tip: Use this setting only when you feel confident after many manual reviews. |
[Table 4. Confidence threshold properties]

{#na-cmdb-agent-biz-app-candidate-ref__table_confidence_thresholds}  
User group context

The following property controls whether the AI includes additional user and group context when analyzing app services.
{#na-cmdb-agent-biz-app-candidate-ref__table_user_group_context__entry__3}

| Property | Default | Description |
|-|-|-|
| `use_all_user_groups_info` | false | When true, the agent gathers all user group and user values from the app service record (expanding user fields into their assignment groups) and includes them in the AI prompt. When false, only the `managed_by_group` value is used. Enable this property for richer context when your services have varied ownership fields populated. |
[Table 5. User group context property]

{#na-cmdb-agent-biz-app-candidate-ref__table_user_group_context}

## Operational constraints {#na-cmdb-agent-biz-app-candidate-ref__section_hard_limits}

{#na-cmdb-agent-biz-app-candidate-ref__table_hard_limits__entry__2}

| Limit | Value |
|-|-|
| Maximum supported app services | 250,000 |
| Recommendation retention | 2 years |
[Table 6. Operational constraints]

{#na-cmdb-agent-biz-app-candidate-ref__table_hard_limits}

If your app service count exceeds 250,000, the synchronization job deactivates itself and sets its state to `unsupported`. This indicates that your data volume exceeds the maximum supported scale. If this occurs,
contact support for guidance on data partitioning or alternative approaches.

Recommendations older than two years are automatically removed from the system to manage storage and improve performance.

## Table references {#na-cmdb-agent-biz-app-candidate-ref__section_table_references}

The agent uses the following tables in the CMDB and internal processing system:
{#na-cmdb-agent-biz-app-candidate-ref__table_references__entry__2}

| Table Name | Purpose |
|-|-|
| `sn_sm_gen_ai_app_service_processing` | Work queue for app service processing jobs. Rows advance through states: ready → in_progress → processed. |
| `sn_sm_gen_ai_processing_entry` | Key/value run state table. Stores `data_synchronization_state` and per-batch processing statistics. |
| `sn_sm_gen_ai_business_app_recommendation` | Recommendation records for human review. Records are numbered with a `BIZ` prefix. Stores proposed business applications, confidence ratings, and related app service candidates. |
[Table 7. Business application candidate agent tables]

{#na-cmdb-agent-biz-app-candidate-ref__table_references}

## Role requirements {#na-cmdb-agent-biz-app-candidate-ref__section_role_requirements}

Access to all Business application candidate agent tables, forms, and configuration requires the `itil` role. This role is required to:

* Activate and deactivate scheduled jobs
* Configure system properties
* View recommendations and work queue entries
* Accept or reject recommendations
* Create or modify business application records and relationships