Troubleshooting AI agent

This AI agent triages an Automated Test Framework (ATF) test failure.

Workflow

The agent analyzes how and why a test has failed and provided a detailed root cause analysis.

1. Fetch the test description and the traced metadata, client logs, and server logs.
2. Starting with probable metadata identify potential causes for the failure, such as errors, exceptions, or unexpected behavior.
3. Examine the test itself for any potential mistakes made while authoring it.
4. Provide a detailed root cause analysis.
5. Determine fixes the user can make.
6. Use the Format RCA tool to format and return the response to the user.

Table 1. Configuration

Field	Description
Allow third party to access this AI agent	When enabled, third-party AI agents can use this agent. This value is off (false) by default. This setting is defined in the AI Agent configs [sn_aia_agent_config] table on the External discoverable field.
Allow AI specialists to access this AI agent	When enabled, AI specialists can use this agent. This value is off (false) by default. When set to true, more configuration options for tools become available so that an AI specialist can map inputs and response templates to tool outputs. This setting is defined in the AI Agent configs [sn_aia_agent_config] table on the Specialist enabled field.
Manage long-term memory	When enabled, all previous user interactions are used as context for the LLM. This value is off (false) by default. This setting is defined by the sn_aia.ltm.enable_long_term_memory system property. For more information, see ServiceNow Otto AI agents reference.
Tools	Scripts Describe test Format RCA Get logs Get traced metadata
Agent roles (ACLs)	atf_triager
Data access roles	atf_triager
Triggers	Optional. None defined by default. An admin can specify triggers if desired. For more information, see Add a trigger to an AI agent.
Channels	Configure an assistant for Virtual Agent or ServiceNow Otto panel using Assistant Designer.
Used in agentic workflows	Not applicable.