---
title: Exploring ATF troubleshooting agent
description: ATF troubleshooting agent streamlines the process of figuring out why tests are failing on specific metadata.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/application-development/automated-test-framework-atf/atf-troubleshooting-agent-explore.html
release: australia
product: Automated Test Framework \(ATF\)
classification: automated-test-framework-atf
topic_type: concept
last_updated: "2026-03-12"
reading_time_minutes: 1
breadcrumb: [ATF troubleshooting agent, Automated Test Framework \(ATF\), Testing and debugging applications, Building applications]
---

# Exploring ATF troubleshooting agent

ATF troubleshooting agent streamlines the process of figuring out why tests are failing on specific metadata.

## ATF troubleshooting agent overview

Use ATF troubleshooting agent to simplify test failure diagnosis on specific metadata.

## ATF troubleshooting agent users

AI agents use [role masking](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/implement-aias-security-new.md) to determine which users can access them. Ones installed with your applications have specific roles that come included with the application. If you select **Users with specific roles** for user access, you must configure the security controls to include these roles. For the instructions to change the security controls, see [Define security controls for an AI agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/define-sec-controls-aia.md).

ATF troubleshooting agent has the following users.

<table id="table_ph5_fns_xjb"><thead><tr><th>

Users

</th><th>

Description

</th></tr></thead><tbody><tr><td>

-   system\_admin
-   atf\_test\_admin
-   atf\_test\_designer
-   atf\_ws\_designer

</td><td>

Either of these 4 roles is required to access the ATF module and test results tables.

</td></tr><tr><td>

atf\_triager + now\_assist\_panel\_user

</td><td>

This role is required to access metadata tables to accurately troubleshoot test failure reasons. This role allows you to have the following access:-   Read-only access to test/step result tables
-   Read-only access to any sys\_metadata
-   Read-only access to syslog
-   Read/write access to sn\_atf\_assist\_triage\_output

**Note:** You can access the ServiceNow Otto panel using the now\_assist\_panel\_user role.

</td></tr></tbody>
</table>## ATF troubleshooting agent benefits

|Benefit|Feature|Users|
|-------|-------|-----|
|Simplify test failure diagnosis|[Troubleshoot test failures](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-troubleshooting-agent-test-failure.md)|atf\_triager + now\_assist\_panel\_user|

## What to explore next

To learn more about configuring and using ATF troubleshooting agent, see:

-   [Install ATF troubleshooting agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/test-agent-install.md)
-   [Use](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-troubleshooting-agent-test-failure.md)