---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/application-development

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Test Agent guidelines

# Test Agent guidelines {#ariaid-title1}

Release version: Australia  
Updated April 22, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Leverage the full potential of Test Agent by following these guidelines.

## Supported metadata {#test-agent-exceptions__section_vcg_xyq_ghc}

Test Agent supports the following metadata:

* sys_ui_action
* sys_ui_policy
* sys_ui_policy_action
* sys_ui_policy_rl_action
* sys_script_client
* sys_ui_script
* sys_data_policy2
* sys_ui_action_role
* sys_ui_action_view
* sys_ui_base_theme
* sys_ui_form
* sys_ui_formatter
* sys_ui_macro
* sys_ui_message
* sys_ui_related_list
* sys_ui_section
* sys_ui_view
* sys_ui_title
* sys_ui_style
* sys_ui_theme
* sys_ui_page
* sys_ui_context_menu
* sys_ui_list
* sys_ui_list_control
* sys_ui_list_control_embedded
* sys_ui_list_script_client
* sys_ui_list_script_server
* sys_ui_related_list
* sys_user_role
* sys_app_application
* sp_widget
* sp_instance
* sys_security_acl_role
* sys_script
* sys_app_module
* sysevent_email_action
* sys_report
* sys_security_acl
* catalog_ui_policy
* catalog_ui_policy_action
* sp_theme
* sp_widget
* sys_sg_universal_link_path_segment
* sys_sg_sections_screen_m2m_section
* sys_sg_location_tracking_details
* sys_highlighted_value_condition
* sys_sg_card_size
* sys_sg_custom_map_config
* sys_sg_empty_state
* sys_aw_form_header_secondary_values
* sys_aw_registered_scripting_modal
* sys_template
* sys_sg_alert
* sys_aw_form_header
* sys_script_include
* sys_scriplet_function
* sys_ui_extension_instance
* sys_playbook_experience_action_assignment_map
* sys_df_data_filtration
* sys_email_address_filt_domain
* sys_atf_step
* sys_atf_test
* sys_atf_step_config
* atf_input_variable
{#test-agent-exceptions__ul_z13_1zq_ghc}

## Exceptions {#test-agent-exceptions__section_bck_bs5_fhc}

Test Agent doesn't support the following metadata:

* Flows
* Configurable workspace steps
* Custom UI test steps
* Custom test steps
{#test-agent-exceptions__ul_whn_4s5_fhc}

## Scope and availability {#test-agent-exceptions__section-scope-and-availability}

Test Agent is available in the following environments and scopes:
{#test-agent-exceptions__table_dcc_y2n_y3c__entry__2}

| Dimension | Supported values |
|-|-|
| Authoring environment | ServiceNow IDE or ServiceNow Studio |
| Application scope | Global, custom, store |
| Test types | ATF unit tests, ATF functional tests |
| Execution target | Cloud runner lanes |
[Table 1. Test Agent scope and availability]

{#test-agent-exceptions__table_dcc_y2n_y3c}

## Example prompts {#test-agent-exceptions__section_rmf_vbl_cjc}

* Write an ATF test in the global scope to validate that an employee can order a laptop from the Service Catalog.
* Write an ATF test to validate that internal IT knowledge articles are not visible to self‑service users.
* Write an ATF test to validate that all mandatory fields on the Incident form are completed before submission.

{#test-agent-exceptions__ul_v4j_ycl_cjc}  
Note:  
The examples above are prompts for authoring ATF tests in the global scope. To run a test, prompt to execute the ATF test by specifying its name or sys_id. To troubleshoot a failure, prompt to triage the failed ATF test by providing the test name or the sys_id of the test result.