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

# Agent marketplace

> Discover and use agents shared within your ClickHouse Cloud organization

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Beta feature. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

The Agent Marketplace is where you browse, search, and run agents that other people in your organization have shared with you. It also includes agents your admin has published organization-wide. Open it from the **Agent Marketplace** option in the left sidebar.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/marketplace/marketplace.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=d52674fa073a87727ce0d381d697ce46" alt="Chat surface with the Agent Marketplace option highlighted in the left sidebar" size="lg" width="3840" height="1934" data-path="images/cloud/agent-builder/marketplace/marketplace.webp" />

<h2 id="browse">
  Browse
</h2>

Agents are grouped into categories — for example, *General*, *Human Resources*, *Research & Development*, *Finance*, *IT*, *Sales*. Switch between categories with the tabs at the top of the marketplace. Each agent card shows the name, an icon, and the category it belongs to.

Use the search bar to find an agent by name or keyword across all categories.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/marketplace/browse.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=07d8b3b60aff66128ae5731e501acce7" alt="Agent Marketplace view with the title, search bar, category tabs (General, Human Resources, Research and Development, Finance, IT, Sales, After Sales, All), and an agent card visible" size="lg" width="3840" height="1934" data-path="images/cloud/agent-builder/marketplace/browse.webp" />

<h2 id="open-an-agent">
  Open an agent
</h2>

Click any agent card to open its detail view. From here you can:

* **Start Chat** - open a new chat with the agent.
* **Pin** - add the agent to your favorites for quick access.
* **Copy link** - share a direct link to the agent.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/marketplace/use-agent.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=a5f733b890d41932ec14483b33c2777b" alt="Agent detail modal showing the agent name, an icon, and Pin, Copy link, and Start Chat actions" size="md" width="1032" height="718" data-path="images/cloud/agent-builder/marketplace/use-agent.webp" />

<h2 id="publish-your-own">
  Publish your own
</h2>

To make an agent discoverable in the marketplace, share it with the right scope from the [sharing and access](/docs/products/cloud/features/ai-ml/agents/sharing-and-access) panel. The visibility levels:

* **Private** - only you can see it. Not in the marketplace.
* **Shared with users or groups** - visible to those principals. Shows up in their marketplace.
* **Organization-wide** - visible to everyone in the org. Subject to your admin's marketplace permissions.

Categorize your agent and write a clear description before publishing — those fields drive both search and the categorized browse experience.

<h2 id="admin-controls">
  Admin controls
</h2>

Org admins can:

* Curate the set of categories shown in the marketplace.
* Promote individual agents to the organization-wide view.
* Allow or restrict marketplace access per role.

See [sharing and access](/docs/products/cloud/features/ai-ml/agents/sharing-and-access) for the permission model.