Agent Gallery
Agent Gallery OperationsRunning Agents

Running Agents

Walk through launching, validating, and stopping agents in Agent Gallery.

Use this guide to launch and test an agent, from locating it in the catalog to shutting it down once your checks are complete.

Before You Start

Login required

Running agents (clicking the run button) requires you to be logged in to the gallery. Refer to Logging In to Agent Gallery if you need to authenticate.

1. Open the Agent Details Page

  1. From the gallery home, search or browse to the agent you need to execute.
  2. Select the agent card to open its detail view and review it.

Agent detail page showing status, description, and run controls

2. Launch the Agent

  1. Choose Run (top-right hand corner button) to open the launch dialog.
  2. Select a hardware allocation, which will specify the limits (CPU, RAM) for your agent.
  3. Enter any API keys or configuration settings - some agents have an optional section that you can expand for more configuration options.
  4. Select Connect to provision the agent.

Run Agent dialog with environment options and the Connect button highlighted

3. Confirm the Agent Starts

  • When the run succeeds, Agent Gallery shows a confirmation message (green popup at the buttom). You should see the Run button showing Running once the agent has been provisioned. Use Go to Agent to open the run console immediately.

Agent started confirmation dialog with Go to Agent call-to-action

4. Test the Agent Session

  1. In the run console, send a few representative prompts to ensure the agent behaves as expected.
  2. Capture evidence of successful outputs or anomalies so you can report them later.

Chat interface displaying a test conversation with the running agent

5. Shut Down the Agent

  • When validation is complete, choose Shutdown Agent from the run console to release resources.

Shutdown agent confirmation banner

6. Review Active Runs

  • Return to the Running Agents page (redirects automatically if you shutdown an agent) to verify the agent no longer appears in the active list. If it remains, you can shutdown by clicking the Delete icon.

Running Agents tab showing current active runs