Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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 Now Assist 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.

ATF troubleshooting agent has the following users.

UsersDescription
- system\_admin - atf\_test\_admin - atf\_test\_designer - atf\_ws\_designerEither of these 4 roles is required to access the ATF module and test results tables.
atf\_triager + now\_assist\_panel\_user

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 Now Assist panel using the now_assist_panel_user role.

ATF troubleshooting agent benefits

BenefitFeatureUsers
Simplify test failure diagnosisTroubleshoot test failuresatf_triager + now_assist_panel_user

What to explore next

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

Parent Topic:ATF troubleshooting agent