Add a reference article with agent session filters (#60546)

Author: sabrowning1

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md

@@ -15,13 +15,7 @@ category:
 {% data reusables.enterprise-accounts.access-enterprise %}
 {% data reusables.enterprise-accounts.ai-controls-tab %}
 1. Towards the top of the page, in the "Agent sessions" section, you will see the three most recent agent sessions in your enterprise. To view all agent sessions from the last 24 hours, click **View all**.
-1. To filter agent sessions, click the search bar at the top of the list, then press <kbd>Space</kbd>. From the dropdown menu that appears, select your filter criteria. The following filters are available:
-
-   * **Agent**: Filter sessions by the agent used, including third-party coding agents and {% data variables.copilot.copilot_coding_agent %}.
-   * **Organization**: Filter sessions by the organization in which the session took place.
-   * **Status**: Filter sessions by their current status, such as queued, in progress, completed, failed, idle waiting for user, timed out, or cancelled.
-   * **Repository**: Filter sessions by the repository in which the session took place.
-   * **User**: Filter sessions by the user who initiated the session.
+1. To filter agent sessions, click the search bar at the top of the list, then press <kbd>Space</kbd>. From the dropdown menu that appears, select your filter criteria. For a list of available filters, see [AUTOTITLE](/copilot/reference/agent-session-filters).
 
 ## Tracking agentic activity in your enterprise through the audit log
 

content/copilot/reference/agent-session-filters.md

@@ -0,0 +1,22 @@
+---
+title: Available filters for agent sessions
+shortTitle: Agent session filters
+intro: 'Search agentic activity in your enterprise with filters for agent sessions.'
+permissions: Enterprise owners
+versions:
+  feature: copilot
+contentType: reference
+category:
+  - Track Copilot usage
+---
+
+The following filters are available for the "Agent sessions" view in your enterprise's AI Controls:
+
+| Filter | Description | Example value |
+| --- | --- | --- |
+| `agent` | Displays activity from a specific agent. | `agent:copilot-coding-agent` |
+| `organization` | Displays activity within a specific organization. | `organization:octocat-org` |
+| `repository` | Displays activity within a specific repository. | `repository:octocat-repo` |
+| `status` | Displays agent sessions with a specific status. | `status:in_progress` |
+| `timeframe` | Displays agent sessions that started within a specific timeframe. | `timeframe:7d` |
+| `user` | Displays agent activity initiated by a specific user. | `user:octocat` |

content/copilot/reference/index.md

@@ -20,6 +20,7 @@ children:
   - /metrics-data
   - /copilot-billing
   - /agentic-audit-log-events
+  - /agent-session-filters
   - /review-excluded-files
   - /copilot-usage-metrics
 contentType: reference