(Beta) AI Agents
An AI agent is a logical, runtime entity that autonomously plans and executes tasks toward a goal by coordinating multiple AI and non-AI components, such as AI models, tools, memory, data sources, and other services. Harness identifies an AI agent when it observes these components working together in a coordinated execution pattern.
The AI Agents page under Discovery provides a centralized view of the AI agents that Harness discovers in your applications. It helps you understand the AI models used by these agents, the sensitive data detected in their prompt and response traffic, and the environments in which they operate.
What you will learn from this topic
By the end of this topic, you will be able to:
Understand the ways to leverage the information available on the page.
Understand the widgets and information available on the AI Agents page.
Understand the information displayed in the AI agent inventory and use filters to find specific agents.
Understand the sensitive data detected in agent prompt and response traffic.
Understand how to leverage the information available on the page.
Agent discovery signals
Agent discovery uses available runtime telemetry to identify AI agents and map their dependencies. For applications where the hosting service exposes entry and exit calls, Harness analyzes these interactions to identify AI models and downstream components, including services, MCP servers, and third-party APIs.
For applications using Server-Sent Events (SSE), SSE capture is supported by the tracing agent where applicable, enabling Harness to analyze streaming interactions as part of agent discovery.
Use the latest supported version of the Harness tracing agent for the best discovery experience, as newer versions improve the capture of large request and response bodies, providing more complete telemetry for analysis.
Understand the AI agents view
The AI Agents page provides an overview of the AI agents discovered in your environment. The page includes widgets summarizing agent discovery, exposure, and AI model usage, followed by an inventory of discovered agents.
Widgets
The widgets at the top of the page provide a high-level view of the discovered AI agents.
Total Agents — Displays the number of AI agents discovered in the last 24 hours.
Internal vs Internet-Facing Agents — Displays the distribution of discovered AI agents based on the exposure of their trigger API endpoints. An Internet-facing agent is triggered via an API endpoint exposed to the internet, whereas an Internal agent is triggered via an API endpoint not exposed to the internet.
Most Used AI Models — Displays the number of discovered AI agents that invoke each AI model.
You can hide these widgets by clicking the Visualizations (
) icon in the top-right corner of the page.
AI agent inventory
The AI agent inventory lists the AI agents that Harness discovers in your environment. It allows you to review key information about each agent, including the AI models it uses, the environment in which it operates, and any sensitive data detected in its prompt and response traffic.
The inventory displays the following information for each AI agent:
AI Agent Details
Description
Agent Name
The name of the AI agent.
Sensitive Data (Prompt/Response)
The number of affected calls and the types of sensitive data detected in the agent's prompt and response traffic. The percentage next to each data type represents the percentage of affected calls in which that data type was detected. For example, Phone 53% means that Phone was detected in 53 percent of the affected calls for that agent.
AI Models
The AI models invoked by the agent.
Model Vendors
The vendors of the AI models used by the agent.
Environment
The environment associated with the agent.
Call Count
The number of calls associated with the agent.
Discovered
The time at which Harness discovered the agent.
You can use the Environment controls at the top of the page to control the agents and activity displayed in the inventory. You can also download the data displayed in the inventory as a CSV file by clicking the Download (
) icon. When downloading the data, you can specify the number of rows to download.
To investigate an individual agent further, select it from the inventory to view its details. For more information, see AI agent details.
Filters
The AI Agents page provides filters that you can use to narrow the agents displayed in the inventory. To open the filter pane, click the Filter (
) icon in the top-left corner of the page.
The filter pane includes the following tabs:
Tab
Description
Filters
Lists the filters available for AI agents.
Saved
Lists the filters that you have saved for later use.
Recent
Lists the filters that you have recently applied.
Under Filters, you can filter agents by:
Agent Name
AI Models
Environment
Internet-Facing Agent
For example, to view only internet-facing agents, click the filter icon, select Internet-Facing Agent, and set it to True. The following demo illustrates how to do this:
Leverage the AI Agents view
Once you understand the information available on the AI Agents page, you can use it to build an overview of the agents operating in your environment and identify those that require further investigation. The widgets help you understand agent exposure and AI model usage, while the inventory helps you identify individual agents that invoke specific models or have sensitive data detected in their prompt and response traffic.
When you want to focus your investigation, use the available filters, Environment selector, and time period selector to narrow the inventory. For example, you can use the available filters to focus on internet-facing agents or agents that invoke a specific AI model. After identifying an agent that requires further investigation, you can select it from the inventory to view its details.
Last updated
Was this helpful?