Browsing the catalog
- Grid / List toggle — switch between card grid and compact list view
- Search — find agents by name or description
Agent detail modal
The detail modal shows:- Agent name, description, and publisher
- Tags and capabilities overview
- Version picker — if the publisher has released multiple versions (tags), select which one to install
Installing agents
Two installation modes:Add to workspace
Copies the agents from the published workspace into your current active workspace. Your existing agents are unaffected — this is an additive operation. Use this when you want to pull in specific agents from a template and combine them with your own.Clone full workspace
Creates a brand-new workspace based on the published one. All agents, settings, and configurations from the source are cloned. Use this when you want a complete starting point — a new workspace with everything already configured.Cloned workspaces are independent copies. Changes you make to your clone don’t affect the original, and updates to the original aren’t pushed to your clone.
Publishing your workspace
Share your agents with others by publishing your workspace to the catalog. Click Publish from the Dashboard header or from inside the Discover page. Fill in the publish form:| Field | Description |
|---|---|
| Name | OCI-compatible name (lowercase, hyphens allowed, no spaces). E.g., customer-support-starter |
| Tag | Version label. Use semantic versioning (e.g., 1.0.0) or latest |
| Description | What this workspace contains and who it’s for |
| Logo | Optional image representing the workspace in the catalog |
When you publish with a versioned tag (e.g.,
1.0.0), Studio also publishes latest automatically. This ensures users who install without specifying a version always get the most recent one.Version management
Each published workspace can have multiple tags (versions). The detail modal’s version picker lets installers choose which tag to install. To publish a new version of an existing workspace, use the same workspace name with a new tag (e.g.,1.1.0). The latest tag is updated automatically.
Next steps
Workspaces
Understand how workspaces and OCI addressing work.
Dashboard
Manage and test agents in your workspace.