Shared Agents

The Agent Marketplace lets you install pre-built AI agents that come with curated training data and a configured persona. Instead of building an agent from scratch, you can install one that already knows about ecommerce metrics, customer support best practices, project management, or any other domain — and start using it immediately.

Shared agents work alongside the existing App Marketplace. While apps add tools to your existing agents, shared agents are complete agents you install into your company with their own knowledge base, persona, and recommended configuration.

How shared agents work

When you install a shared agent from the marketplace, the system creates a real agent in your company:

• A new agent appears in your Agents list with the template’s persona and recommended model
• The agent gets access to the publisher’s curated training data (read-only)
• You also get a private knowledge overlay where you can add your own company-specific information
• The agent counts toward your plan’s agent limit

When the agent searches its knowledge base, it transparently searches both your private overlay and the publisher’s training data, with your entries taking priority.

Tip

Think of it like hiring a specialist who already has domain expertise (the training data) but can also learn your specific processes and systems (your overlay).

Browsing and installing

Navigate to the Marketplace page in the dashboard sidebar. You will see two top-level tabs: Apps and Agents.

1. Click the Agents tab

   The Agents tab shows all available agent templates, organised with the same Installed and Available sub-tabs as the Apps section.

2. Browse available agents

   Each agent card shows the name, description, category, trust tier badge, and install count. Agent cards have an AI badge to distinguish them from regular app tools.

3. Click Install Agent

   You will be prompted to customise the agent’s name (or accept the default). The system checks that you have not exceeded your plan’s agent limit and that any required app dependencies are installed.

4. Start chatting

   The agent appears in your Agents list immediately, ready to use. It already has access to the publisher’s training data, so you can start asking domain-specific questions straight away.

Caution

Installed agents count toward your plan’s agent limit. Check your current usage on the Usage & Billing page before installing.

Training data architecture

Shared agents use a layered knowledge system:

Publisher's training data

The curated knowledge base created by the agent’s publisher. This is read-only for installers and contains domain expertise, best practices, reference material, and other structured knowledge. It is versioned and snapshotted with each release.

Your private overlay

A private knowledge index where you can add company-specific information. Your entries take priority over the training data when results overlap. This is the same knowledge base every agent gets — you manage it from the agent’s Knowledge tab.

When you search your agent’s knowledge (or the agent searches automatically during conversations), both layers are queried in parallel and results are merged. Your private entries always take priority if there are duplicates.

Version pinning and updates

Shared agents use version pinning for stability:

• Persona and configuration are pinned to the version you installed. The publisher can release updates, but your agent keeps its current persona until you choose to update.
• Training data is also pinned to a snapshot taken at the time of the version release. The publisher can continue editing their working copy without affecting your agent.

When the publisher releases a new version, you will see an update notification. You can review the changes and update when you are ready — updates re-apply the persona template and switch to the new training data snapshot.

Note

Version updates never delete your private knowledge overlay. Your company-specific additions are always preserved.

Uninstalling

Uninstalling a shared agent deprovisions it completely:

• The agent is removed from your Agents list
• The agent’s Durable Object, conversation history, and private knowledge are deleted
• Access to the publisher’s training data snapshot is revoked
• The agent no longer counts toward your plan limit

Caution

Uninstalling is permanent. Any conversations and private knowledge entries for this agent will be lost. Consider exporting important data before uninstalling.

Publishing your own agents

You can share your agents with the Sprigr community by publishing them to the marketplace.

1. Go to your agent’s page

   Navigate to the agent you want to publish in the Agents section of the dashboard.

2. Click Publish to Marketplace

   This opens a form where you create a sanitised public version of your agent. Your live agent stays private — the published template is a separate configuration.

3. Configure the public template

   Fill in the public name, description, category, and tags. Edit the persona to use template variables like {company_name} and {agent_name} — these get resolved for each company that installs the agent. Remove any company-specific information.

4. Optionally include training data

   You can export your agent’s knowledge base into the template’s training index. This becomes the curated training data that installers receive.

5. Submit for review

   Private and shared templates are available immediately. If you want your agent listed publicly, it goes through a review process to ensure quality and safety.

Managing training data

After publishing, you can manage your agent template’s training data from the marketplace:

1. Navigate to Marketplace > find your agent > click it
2. Click Training Data to open the training data management page
3. Add individual entries, edit existing ones, or import in bulk via JSON upload
4. Use the search bar to find and verify specific entries

You can also seed training data via the Sprigr MCP server from your local AI tools, or through the API programmatically.

Tip

When you publish a new version, the current training data is frozen into an immutable snapshot. Installers pin to snapshots, so you can freely edit your working training data without affecting anyone.

Recommended app dependencies

Agent templates can declare required or optional app dependencies. For example, an ecommerce agent might recommend the Shopify connector app for full functionality. When a company tries to install the agent, the system checks for missing required dependencies and prompts them to install those apps first.

Next steps

Ready to browse available agents? Head to the Marketplace page in your dashboard and click the Agents tab.

Want to build a custom tool instead? See Creating Custom Apps for the App IDE walkthrough.

For programmatic access to the marketplace, see MCP Overview.