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

# Intents

> How Intents (ApplicationActions) work in the Portal

In Maitai, an **Intent** is a specific action type within an Application. In the API and codebase, an Intent is represented as an `ApplicationAction`.

Intents are the unit that most Portal screens use to organize:

* request history
* analytics (activity and fault rate)
* configuration

## Where to find Intents

You can reach an Intent in a few ways:

* **From an Application**: open `/application/:applicationId` and click the **Intents** tab, then click an intent row.
* **From an Intent Group**: open `/intent-group/:intentGroupId` and use the **Intents** tab to navigate into a specific application’s intent.

An Intent’s detail page is:

* `/application/:applicationId/intent/:actionId`

## Intent list (within an Application)

On the Application page’s **Intents** tab, the Portal lists each intent with:

* **Intent Name** (the `action_type`)
* **Date Created**
* **Last Activity**
* **Requests** (count)

Clicking a row opens the intent detail page.

## Intent detail page

The intent detail page includes:

* breadcrumb navigation back to Applications and the Application
* the intent name (`action_type`)
* a **description** and **tags** (as displayed from the intent metadata in the Portal)

### Tabs on an Intent

The Portal intent page has these tabs:

* **Overview**
* **Requests**
* **Datasets**
* **Models**
* **Configuration**

#### Overview

<img src="https://mintcdn.com/maitai-cbe2cd27/o70b7aP0pbkBNV82/images/observe/intents/Observe_Intents_Overview.png?fit=max&auto=format&n=o70b7aP0pbkBNV82&q=85&s=8adc0db95448dd1c8d02c72eb5c6bddf" alt="Intent Overview" width="1695" height="796" data-path="images/observe/intents/Observe_Intents_Overview.png" />

The Overview tab includes:

* a link to the **Intent Group** associated with this intent
* key metrics (request count, last activity, created date)
* analytics charts:
  * **Request Activity**
  * **Fault Rate**

#### Requests

<img src="https://mintcdn.com/maitai-cbe2cd27/o70b7aP0pbkBNV82/images/observe/intents/Observe_Intents_Requests.png?fit=max&auto=format&n=o70b7aP0pbkBNV82&q=85&s=e39cde809df07aefa84a604af82640a9" alt="Intent Requests" width="1698" height="877" data-path="images/observe/intents/Observe_Intents_Requests.png" />

The Requests tab shows request history for this intent, with:

* a date range filter
* a paginated requests table

From here you’ll typically drill into a specific request to debug behavior.

#### Datasets

<img src="https://mintcdn.com/maitai-cbe2cd27/o70b7aP0pbkBNV82/images/observe/intents/Observe_Intents_Datasets.png?fit=max&auto=format&n=o70b7aP0pbkBNV82&q=85&s=ff4823d3efd7d988c9c458ca1613f8ee" alt="Intent Datasets" width="1688" height="587" data-path="images/observe/intents/Observe_Intents_Datasets.png" />

The Datasets tab is labeled **"Datasets & Compositions"** and includes:

* **New Composition** and **New Dataset** buttons (these jump you into Forge with this intent pre-selected)
* sub-tabs for:
  * **Datasets**
  * **Compositions**

<Tip>
  This is an “observe to build” bridge: you can identify an intent with issues, then quickly start creating datasets/compositions for fine-tuning work.
</Tip>

#### Models

The Models tab shows models associated with this intent (as presented by the Portal’s models table).

#### Configuration

The Configuration tab exposes intent-level configuration with:

* **Reset to Default**
* **Save Changes**

This is where you tune how Maitai runs requests for this intent.

For details on configuration fields, see [Configuration](/examples/configuration).

## How Intents relate to Intent Groups and Test Sets

* **Intent Groups** group intents across applications by shared action type. From an Intent’s Overview tab, you can click through to its Intent Group.
* **Test Sets** are organized by **Intent Group** in the Portal (not directly by Application Intent). See [Test Sets](/test/test_sets/creation).
