> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Goals

> Understand what the agent was trying to accomplish in your product.

## What are Agent Goals?

Tool call logs show you *what* happened in a session, but not *why*. Agent Goals use AI to classify the goal behind each session, turning raw event data into actionable insight about what your users are trying to do and whether they were successful.

Agent goals was built with a full product workflow in mind, helping you answer questions like:

* What are the most common use cases for agents using my product?
* How often are those use cases successful vs. not?
* What are new use cases?

## How Goals Work

AgentCat's AI analyzes patterns across your project's sessions to generate a set of goals. To start classifying goals, we need a minimum threshold of sessions and tool calls so our algorithm can begin clustering and classifying common goals:

| Requirement    | Threshold                     |
| -------------- | ----------------------------- |
| **Sessions**   | \~200 sessions in the project |
| **Tool calls** | \~1,000 tool call events      |

Once these thresholds are met, AgentCat begins periodically discovering goals based on samples of sessions and classifying all new sessions into a goal once the session has completed.

## Session Goal

In each [Session Replay](/features/session-replay), you can find the session goal. The session goal includes information that helps you understand what the goal was for that session and whether it was achieved or not.

<Frame>
  <img src="https://mintcdn.com/mcpcat/1ZBpCsjHOX5lBBUE/images/session-goal-card.png?fit=max&auto=format&n=1ZBpCsjHOX5lBBUE&q=85&s=29d032bf8b57f390e5b94b395b4ebc52" alt="session goal card" width="400" data-path="images/session-goal-card.png" />
</Frame>

| Property        | Description                                                                       |
| --------------- | --------------------------------------------------------------------------------- |
| **Name**        | A short label for the goal                                                        |
| **Description** | A longer explanation of the user intent                                           |
| **Status**      | Whether the goal was **accomplished** or **failed** for a given session           |
| **Reasoning**   | AI-generated explanation of why the goal was classified as accomplished or failed |

Goals go through different states depending on whether you're looking at a project or an individual session:

* **Learning:** The project doesn't have enough data to generate goals
* **Processing:** This individual session is still being analyzed or has not yet completed
* **Active:** Goals are available and ready to view

## Goal Success Rate

<Frame>
  <img src="https://mintcdn.com/mcpcat/1ZBpCsjHOX5lBBUE/images/goal-success-rate.png?fit=max&auto=format&n=1ZBpCsjHOX5lBBUE&q=85&s=b65a3b2253718276992f1172a1ba2c6e" alt="goal success rate" width="2430" height="1384" data-path="images/goal-success-rate.png" />
</Frame>

On the [Dashboard](/features/dashboard), you can see an overview of the agent goals across your entire project. You can see the distribution of goals across all recent sessions, how often a goal was succeeding or failing, and a graph of goal success rate over time.

Use this to identify goals where users frequently fail. These are your highest-impact improvement opportunities.

## Filtering by Goal

On the sessions list page, a **Goals** filter becomes available once goals are active for your project. Use it to find all sessions where agents had a specific goal. For example, filter to "Debug authentication flow" to see every session where an agent was trying to debug auth.
