Agents
See the agent instances you connected, when each was last active, and edit, revoke or delete them.
In the console: Agent Authority › Agents
This screen is in the user portal, so it shows what you see when you sign in as a user, not as an admin. It lists the agent instances you connected to the gateway, with their status and when each last made a call. It shows only your own agent instances, even when your role grants org-wide access.
Summary cards
| Card | Shows |
|---|---|
| Total Agents | Your registered agent instances |
| Active Agents (24h) | Your agent instances with activity in the last 24 hours |
| Tool Executions (24h) | Tool calls your agents made in the last 24 hours |
Agent instance list
| Column | Shows |
|---|---|
| Agent | The instance's display name and its owner. A button to copy the instance ID appears when you hover over the row. |
| Runtime | The client the agent reported, its version, and the agent type |
| Tags | Tags on the agent type |
| Status | Active (a call in the last 24 hours), Idle, Never Connected, or Revoked |
| Last Active | When the instance last made a call, or Never |
| Created | When the instance was registered |
Search by name with Search agents.... Filter by Agent (the agent type) or by Tag. Sort by Agent, Last Active or Created; the list starts with the newest.
With no agents and no filters, the screen shows No agents connected yet and a Connect your agent button.
Agent detail page
Selecting an agent's name opens its detail page.
- Overview – the Agent Identity card (instance ID, client ID, and the client's details), recent activity for this instance, and when it was created, updated and last used.
- Effective Access – what this instance can reach under the current policies.
Actions
- Connect – opens Connect your agent, where you pick an agent and follow its setup steps.
- Edit – opens Edit Agent, where you change the Display Name.
- Revoke access – clears all active tokens and consents for the agent, after you confirm. You can grant access again at any time. It appears only for agents that signed in with an OAuth client, and only in a console that supports revocation.
- Delete – removes the agent instance, after you confirm. This can't be undone. Deleting an OAuth agent revokes its access first.
Edit, Revoke access and Delete are in each row's actions menu, and as buttons on the detail page.
Permissions
The Agents menu item needs view_agent_instances.
- Connect, Edit, Revoke access and Delete –
manage_agent_instancesfor the agent's owner. - Active Agents (24h) –
view_agent_analytics. - Tool Executions (24h) –
view_tool_analytics. - Recent activity on the detail page –
view_audit. - Effective Access tab –
view_policies.
Related
- User portal – what the user portal is and who uses it
- End-user guide – the end user's guide to the portal