> ## Documentation Index > Fetch the complete documentation index at: https://doc.lucidworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Agent Usage > [!TIP] > > This feature is only available to clients who have contracted with Lucidworks for Agent Studio. The Agent Usage screen provides information about request activity for the agents on your site. The screen displays the total number of requests submitted to your agents during a selected time period, a breakdown of requests by generative AI model, and period-over-period comparisons for key metrics. > [card] Key questions to get you started > > Powered by Lucidworks Agent Studio The following interactive tour walks through the duration selector, facets, summary metrics, Total Requests chart, and Generative AI Models table. [Agent Usage tour](https://storage.googleapis.com/demo-forge/demo-forge-agents-usage-tour-shared-player/04-demo/index.html) ## Duration options The date/time range selector at the top of the screen controls the time period for all data displayed on the page. When you change the duration, the summary metrics, the Total Requests chart, and the Generative AI Models table all update to reflect the selected range. Available presets include today, last 24 hours, last week, last month, last 90 days, last quarter, and last year. You can also select a custom range by specifying a start date and an end date. ![Duration options](https://mintcdn.com/lucidworks/r7gIA0XRfb9JEc3F/assets/images/lw-platform/ai-agent-studio/ai-agent-studio-usage-agents-duration.png?fit=max\&auto=format\&n=r7gIA0XRfb9JEc3F\&q=85\&s=69433595b4f53308fd04f062c4b18480) When you select a custom range, the start and end dates are encoded as URL query parameters, which allows you to bookmark or share a view of a specific time period. ## Facets Facets filter all data displayed on the page. When you select one or more facet values, the summary metrics, the Total Requests chart, and the Generative AI Models table all update to reflect only the matching data. If no facets are selected, data for all values displays. ![Facets](https://mintcdn.com/lucidworks/r7gIA0XRfb9JEc3F/assets/images/lw-platform/ai-agent-studio/ai-agent-studio-usage-agents-facets.png?fit=max\&auto=format\&n=r7gIA0XRfb9JEc3F\&q=85\&s=9a6b12246eaca2864a3a8648c1786978) **Agent Types** is the primary facet and narrows the data to one or more specific types of agents. Select one or more values from the facet list to filter by agent type. Deselect a facet value to remove that filter. ## Summary metrics The summary metrics section displays a set of key performance indicator (KPI) cards, each representing a key measurement for the selected duration and facets. The indicators include total number of generative AI requests, the total number of tokens (individual units of information like words or phrases) submitted in requests, and the total number of tokens returned in responses. ![Summary metrics](https://mintcdn.com/lucidworks/r7gIA0XRfb9JEc3F/assets/images/lw-platform/ai-agent-studio/ai-agent-studio-usage-agents-summary-metrics.png?fit=max\&auto=format\&n=r7gIA0XRfb9JEc3F\&q=85\&s=8fb42dc6c45cf4ddda7b70a6943e98a7) Each card displays the following: **Metric name** `string` The name of the measurement. Values are Total Gen AI Requests, Total Gen AI Tokens In, and Total Gen AI Tokens Out. **Current value** `number` The total for the selected time period and facets. For example, you can select the last 90 days and the Product Q\&A agent type facet to view the total number of requests submitted to all Product Q\&A agents during the last 90 days. **Percent change** `number` The difference between the current period and the previous period of equal length. A positive change displays in green and a negative change displays in red. **Trend line** `string` A sparkline (a small line chart without axis information) showing how the metric changed over the selected period. The color of the trend line reflects whether the change is positive or negative. ## Total Requests chart The Total Requests chart is a graphical representation that shows request volume over the selected time period and facets, with each generative AI model displayed as a separate, color-coded portion of the graph. ![Total Requests chart](https://mintcdn.com/lucidworks/r7gIA0XRfb9JEc3F/assets/images/lw-platform/ai-agent-studio/ai-agent-studio-usage-agents-total-requests.png?fit=max\&auto=format\&n=r7gIA0XRfb9JEc3F\&q=85\&s=134faf84da14662424f5cb4df41d177c) **Vertical axis** `number` The number of requests. **Horizontal axis** `string` Time, formatted to the selected duration. For example, if you select the past year, the axis displays one interval per month. **Average requests** `number` The average number of requests per interval for the selected period. The number displays in the top right corner of the chart. The average is calculated by dividing the total number of requests by the number of intervals in the selected time period and facets. For example, if you select the last 90 days for the Conversational Q\&A FAQ agent type, the average is calculated by dividing the total number of requests to that agent type by 90. **Model series** `string` Each generative AI model appears as a separate color-coded section on the chart. The legend below the chart identifies each model by name and color. Click a model in the legend to show or hide that information. If there is no data for the selected time period and facets, the chart displays an empty state message. ## Generative AI Models table The Generative AI Models table lists each generative AI model that received requests during the selected time period. The panel title shows the total number of models in the list, and the panel is collapsible. ![Generative AI Models table](https://mintcdn.com/lucidworks/r7gIA0XRfb9JEc3F/assets/images/lw-platform/ai-agent-studio/ai-agent-studio-usage-agents-generative-ai-models.png?fit=max\&auto=format\&n=r7gIA0XRfb9JEc3F\&q=85\&s=4bb607cd0a6c1b87bc0958c0552316d3) For each model, the following values display: **Name** `string` The name of the generative AI model used by the agents. **Total Requests** `number` The total number of requests submitted to that model for the selected time period and facets. **Total Tokens In** `number` The total number of tokens (individual units of information like words or phrases) submitted in requests to that model for the selected time period and facets. **Total Tokens Out** `number` The total number of tokens (individual units of information like words or phrases) returned in responses from that model for the selected time period and facets. **Last Requested On** `string` The date and time the model last received a request within the selected time period and facets. If there is no data for the selected time period and facets, the table displays an empty state message. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.