---
title: "Launching an Agent"
description: "Run a Cloud Agent on-demand from the Agent Catalog."
diataxis: how-to
applies_to:
  product: "nirmata-ai-agents"
audience: ["platform-engineer"]
last_updated: 2026-04-16
url: https://docs.nirmata.io/docs/control-hub/agent-hub/cloud-agents/agent-launch/
---


You can launch any Cloud Agent on-demand from the [Agent Catalog](../agent-catalog/). The agent starts immediately, executes against the target you specify, and produces a report when it finishes.

## Launch Steps

1. Open **Agent Hub → Cloud Agents → Agent Catalog**.
2. Find the agent you want to run and click **Launch**.
3. Fill in the launch form:
   - **Target cluster** — required for agents that run against a cluster. The dropdown shows all clusters connected to your Control Hub instance.
   - **Namespace** — required for agents scoped to a namespace (shown only when applicable).
   - **Additional inputs** — agent-specific parameters such as resource names, severity thresholds, or output format. Each field includes a description of what it expects.
4. Click **Run** to start the agent.

## After Launch

Once launched, the run appears immediately in [Agent Runs](../agent-runs/) with status **Running**. You can:

- Follow **live execution logs** and step-by-step progress (for Workflow agents).
- Wait for the run to complete and then view or download the **report**.

## Disconnected Clusters

If the selected cluster is disconnected at launch time, the run will retry automatically before being marked as **Failed**. Check cluster connectivity under **Cluster Management** if a run is stuck retrying.

## Permissions

Some agents require specific Kubernetes RBAC permissions on the target cluster. The Agent Catalog entry for each agent lists its required permissions. Verify these are in place before launching — the agent runs under a scoped service account that is provisioned automatically and cleaned up after the run completes.