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

# Agents management

> Find, filter, and manage agents in your workspace.

Open **Manage Agents** to find agents, review their usage, and manage the agents you can edit. To build a new agent, click **Create agent**. See [Create your first agent](https://docs.ruby.ad/docs/user-documentation/agents/create-your-first-agent.md) for a walkthrough.

## Search and browse agents

Use the search bar to find agents by name or description. Choose a tab to browse:

| Tab | What you see |
| :- | :- |
| **Workspace** | Active agents created in your workspace that you can access. |
| **Ruby** | Default agents provided by Ruby. |
| **Archived** | Archived agents that you can access. |

Agents are sorted by usage by default. When you search, results are sorted by relevance unless you have chosen another sort order. Click **Name**, **Usage**, or **Last edited** to sort by that column. Use the pagination controls below the table to browse more results.

Hover over an agent's name to read its description. Click its row to open the details panel. The table also shows access, model, editors, tags, and feedback. Hover over **Feedback** values to see the positive and negative counts.

**Usage** is the number of active users in the last 30 days. A dash means usage data is unavailable.

## Filter agents

Click **Filters**, select a category, and choose the values you want. Click **Apply** to update the list.

| Filter | Use it to find agents by |
| :- | :- |
| **Access** | **Published** or **Not published** status. |
| **Editors** | People who can edit the agent. Select your name, marked **(You)**, to find agents you can edit. |
| **Models** | The model the agent uses. |
| **Skills** | Skills added to the agent. |
| **Tags** | Tags assigned to the agent. |
| **Spaces** | Spaces the agent requires access to. |
| **Usage** | A range of active users, selected with the slider. |

You can combine filters with your search. Filter options reflect the agents matching your search and the other selected filters. **Access** and **Usage** are not available on the **Ruby** tab.

Applied filters appear above the table. Remove a filter with its **×** button, or click **Clear all** to reset all filters. You can also reset selections with **Clear filters** inside the filter panel. To share a filtered view, copy the page URL. The link preserves the tab and filters; recipients see only agents they can access.

### View hidden agents as an admin

On the **Workspace** tab, open **Filters**, select **Hidden agents**, and click **Apply**. This includes unpublished agents from other members and agents that use restricted spaces. Admins can also see all archived workspace agents on the **Archived** tab.

## Manage agents

Open an agent's **...** menu to edit it, copy its ID, view more information, duplicate it, or archive it. Available actions depend on your permissions.

To update several agents, select their checkboxes. Use **Change tag**, **Set model**, **Unpublish**, or **Archive** in the action bar. You can select active workspace agents you edit; admins can select any active workspace agent. Tag changes also respect your workspace's publishing permissions.

The header checkbox selects eligible agents on the current page. You can add selections from other pages. Changing the search, filters, tab, or sort order clears the selection.

To restore an archived agent, open it from the **Archived** tab and click **Restore** in its details panel. You must be an editor or a workspace admin.

### Become an editor as an admin

As a workspace admin, you can open any agent in the Agent Builder, even if you are not one of its editors. In that case, the builder opens in view-only mode with a banner indicating that you are not an editor of the agent.

To make changes, click the **Become an editor** button, available both in the banner and in the **Editors & Access** section of the agent's settings. This adds you to the agent's editors list, after which you can edit and save the agent like any other editor.

The same applies to skills: admins can view any skill in the Skill Builder and click **Become an editor** to add themselves as editors before saving changes.

## Before removing a member

When you remove a member from the workspace, or when user provisioning (SCIM) removes them, Ruby permanently deletes every trigger they created. Deleted triggers can't be restored.

Before removing someone:

1. Under **Programmatic Usage > Automations**, look for their name in the **Owner** column and note the triggers you want to keep.
2. Add another editor to the agents they edit. Unpublished agents can only be used by their editors. To add yourself, see [Become an editor as an admin](#become-an-editor-as-an-admin).
3. After the removal, recreate the triggers you need. A recreated trigger runs on behalf of the person who creates it, so they need access to the agent and must connect their own accounts for tools that use personal credentials.

On plans with [audit logs](https://docs.ruby.ad/docs/user-documentation/admins/audit-logs/audit-logs.md), each deleted trigger appears as a `trigger.deleted` event with its name and agent, but not its schedule or instructions.

## Tags

Tags help organize agents in your workspace and make them easier to find. Think of them as **labels** that describe what an agent does, which team uses it, or its purpose.

As an administrator, you play a key role in organizing your workspace's agents through tags. Here's how to set up and manage an effective tagging system.

### Set up tags

Only administrators can create tags. To create one, open an agent in the Agent Builder, type the tag name in the **Tags** section of the agent's settings, and click **Create "tag name"**. The new tag is added to the agent and becomes available for all agents in the workspace.

### Assign tags to agents

Use the tag selector in an agent's **Tags** cell to add or remove tags. To update several agents at once, select them and click **Change tag**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.