Table of Contents

Agents

Learn how to find, inspect, edit, and delete agents in the Management Portal.

Overview

The Agents page lists every agent in your FoundationaLLM instance that you are allowed to view. It replaces the former All Agents and My Agents pages; the old /agents/public and /agents/private addresses redirect here. Use the Ownership filter to narrow the list to agents you own.

Accessing the Agents Page

  1. In the sidebar, select Agents > Agents.
  2. The page opens with the title Agents and the subtitle "View agents to which you have access."

If you hold the Agents Contributor role on the instance, a Create Agent button appears at the top right of the page. See Create a New Agent.

Agent List

The list loads 20 agents at a time, sorted by display name (or by resource name when an agent has no display name). Scroll to the bottom of the list to load the next 20; a "Loading more agents..." indicator appears while the next page loads.

Column Description
Name The agent display name, with the resource name in parentheses underneath.
Description The agent description.
Expiration Date The date the agent expires, if one is set.
Actions View JSON definition, Edit, and Delete icons.

Click the Name, Description, or Expiration Date column header to sort the loaded rows.

On narrow screens, the list is shown as cards instead of a table.

Searching and Filtering

  1. Type in the Search agents box. The search matches the agent name, display name, and description.
  2. The list refreshes automatically once you have typed at least three characters. To search with fewer characters, press Enter or select the search icon.
  3. Select Clear to remove the search text and show all agents again.

Ownership filter

Use the Ownership dropdown next to the search box:

Option Shows
All Every agent you can view.
Primary Owner Agents for which you are the primary owner (the agent's owner user).
Owner Agents on which you hold the Owner role.

The portal keeps your search text and Ownership selection while you move between pages, until you reload the portal.

Refreshing the list

Select the Refresh agents button (refresh icon) at the right of the toolbar to reload the list with the current search and filter.

Viewing an Agent's JSON Definition

  1. In the Actions column, select the View JSON definition icon (</>).
  2. The Agent Definition: [agent name] dialog opens and shows the full agent resource as read-only JSON.
  3. Select Copy JSON to copy the definition to the clipboard, or Close to dismiss the dialog.

This action is available for every agent in the list.

Editing an Agent

  1. In the Actions column, select the Edit icon (pencil).
  2. The agent editor opens at /agents/edit/[agent name].
  3. Change the settings you need, then select Save Changes at the top right of the editor.

The Edit icon is dimmed and cannot be selected when you don't have write permission on the agent. See Create a New Agent for a description of every tab in the editor.

Deleting an Agent

  1. In the Actions column, select the Delete icon (trash can).
  2. The Delete Agent dialog asks: "Are you sure you want to delete the agent "[agent name]"?"
  3. Select Yes to delete the agent, or Cancel to keep it.

The list refreshes after the agent is deleted. The Delete icon is dimmed and cannot be selected when you don't have delete permission on the agent.

Warning: Deleting an agent also deletes the prompts the agent references (for example, its main workflow prompt), except the shared platform prompts. If you attached one of your own prompts to several agents, deleting one of those agents deletes that prompt too. Users can no longer use a deleted agent.

The Management Portal has no action for setting a default agent. To control which agents are highlighted to users, use the Featured Agents tab under Platform > Configuration. See Configuration.

Permissions

Action Requirement
See an agent in the list, view its JSON definition FoundationaLLM.Agent/agents/read on the agent
Edit an agent FoundationaLLM.Agent/agents/write on the agent
Delete an agent FoundationaLLM.Agent/agents/delete on the agent
See the Create Agent button Agents Contributor role on the instance