Test and Monitor AI Agents

This page explains how to test your AI agents to validate their behavior and monitor their performance over time. Following these steps helps you ensure your AI agents run as expected and identify areas for improvement.

Test the AI agent

Test the AI agent to make sure it behaves as expected. Testing helps you validate the inputs, outputs, and tool interactions in a controlled environment.

To test your AI agent:

1. Go to the Test tab.
2. Include any Inputs needed for additional context.

   Tip:  You can configure input values for simple data types while testing directly in the interface or when saving a test case. Complex data types, such as record types, custom data types (CDTs), and maps, can't be configured in the Test tab.

3. Click TEST. The Agent Response panel displays a summary of the AI agent's activity and a detailed step-by-step history of how it processed the request.

Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to close

For best practices on designing testable AI agents, see Best Practices for Designing AI Agents.

You can review the history of each step the AI agent executed. Click See Details under each step to learn what happened in that part of the process.

Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to close

Monitor AI agents

Use the Monitor tab to track how your AI agents are performing. Monitoring helps you understand how AI agents are being used, identify performance issues, and spot AI agents that may need instruction or tool refinements.

You can monitor your AI agents from two places:

1. The Monitor tab in the main navigation panel. This screen displays a log of all AI agent requests, including their current status and detailed metadata. Use this view to track the progress of each request, identify issues, and review historical activity. From this screen, you can click a Request ID to view detailed information about the AI agent's processing steps and outputs.
   

   Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to close

2. The AI agent-specific Monitor tab. To view request activity for a specific AI agent, open the AI agent and go to its Monitor tab. This shows only the requests handled by that AI agent.
   

   Scroll or drag to pan · ⌘+/⌘− to zoom · Esc to close

You can also view all AI agent runs across all AI agents in the AI Agents Activity tab of the Monitor view.

AI agent summary table

Each row in the table shows key metrics for an AI agent:

Field	Description
Run ID	A unique identifier for each request. Click to view the full request details.
Version	The version number of the AI agent that processed the request.
Status	The current state of the request.
Agent Name	The name of the AI agent that handled the request.
Request	A description of the request.
Token Usage	The number of tokens consumed during the AI agent's processing.
Tool Calls	The number of tools the AI agent used while processing the request.
Initiator	The person who initiated the request.
Duration	The time the AI agent took to complete the request.
Start Time	The date and time when the AI agent request began processing.

Feedback