Exploring ATF troubleshooting agent

---
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/now-assist-for-creator/atf-troubleshooting-agent-explore.html
release: australia
product: Now Assist for Creator
classification: now-assist-for-creator
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [ATF troubleshooting agent, Use agentic AI, ServiceNow Otto for Creator, Build, AI Workflow Factory Prime, Agentic app development, 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 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/now-assist-for-creator/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/now-assist-for-creator/test-agent-install.md)
-   [Use](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/now-assist-for-creator/atf-troubleshooting-agent-test-failure.md)

**Parent Topic:**[ATF troubleshooting agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/now-assist-for-creator/atf-troubleshooting-agent-landing-page.md)