Marketplace

Learn how to integrate Demeterics into your workflows with step-by-step guides and API examples.

Marketplace

Discover and share prompt templates, agent configurations, and workflow bundles in the Demeterics Marketplace.

Beta Feature: The Marketplace is currently in beta. API endpoints may change. Email sales@demeterics.com with subject "Feature Access Request" and feature name "Marketplace" to request access.


Overview

The Marketplace helps you:

  • Accelerate development with pre-built prompt templates
  • Learn best practices from community-tested configurations
  • Share your work and earn recognition
  • Customize and extend templates for your specific needs

Concepts

Promptlets

A promptlet is a reusable prompt section that can be combined with other promptlets to create complete agent prompts.

Categories of promptlets:

Category Description Example
personality Defines the AI's character and tone "Friendly customer support agent"
instructions Core behavioral guidelines "Always greet users by name"
knowledge Domain-specific context "Product catalog and FAQs"
constraints Safety and boundary rules "Never discuss competitor pricing"
format Output formatting instructions "Respond in bullet points"
integration Tool/API usage instructions "Use the order lookup API"

Example promptlet:

{
  "title": "Friendly Support Persona",
  "slug": "friendly-support-persona",
  "category": "personality",
  "content": "You are a friendly, patient customer support agent for {{company_name}}. You speak in a warm, conversational tone and always aim to resolve issues on the first contact. You never express frustration and always thank customers for their patience.",
  "industries": ["retail", "saas"],
  "use_cases": ["customer-support", "onboarding"]
}

Bundles

A bundle is a complete agent configuration that combines multiple promptlets into a ready-to-use template.

Bundle structure:

{
  "name": "E-commerce Support Agent",
  "slug": "ecommerce-support-agent",
  "description": "Complete customer support agent for online stores",
  "category": "support",
  "industries": ["retail", "ecommerce"],
  "use_cases": ["customer-support", "order-tracking"],
  "promptlets": [
    {"order": 1, "title": "Friendly Persona", "content": "You are a friendly..."},
    {"order": 2, "title": "Product Knowledge", "content": "Our store sells..."},
    {"order": 3, "title": "Refund Policy", "content": "Refunds are available within..."}
  ],
  "greeting_message": "Hi! How can I help you with your order today?",
  "suggested_questions": [
    "Where is my order?",
    "How do I return an item?",
    "What's your refund policy?"
  ]
}

Browsing the Marketplace

Dashboard

Navigate to Marketplace in the main menu to browse:

  • Featured - Curated high-quality templates
  • Popular - Most used by the community
  • Recent - Newly published items
  • Categories - Browse by use case

Filtering

Filter marketplace items by:

Filter Options
Category support, sales, marketing, developer, enterprise
Industry retail, saas, healthcare, finance, etc.
Use Case customer-support, lead-gen, onboarding, etc.

Browse promptlets and bundles separately using the tabs at the top of the Marketplace page.


Using Marketplace Items

Preview

Click any marketplace item to see:

  • Full prompt content
  • Variable placeholders
  • Usage examples
  • Community ratings and reviews
  • Author information

Install to Your Account

  1. Click Use This Template
  2. Fill in required variables
  3. Choose destination agent (new or existing)
  4. Click Install

The template is copied to your account and can be customized freely.

Customize

After installation, you own a copy:

  • Edit prompt content
  • Modify variables
  • Add or remove promptlets from bundles
  • Changes don't affect the original marketplace item

Publishing to Marketplace

Beta Access Required: Publishing to the Marketplace requires whitelisted access. Email sales@demeterics.com with subject "Feature Access Request" and feature name "Marketplace Contributions".

Prepare Your Promptlet

  1. Navigate to Agents → Your Agent → Edit
  2. Click Extract Promptlet on a section you want to share
  3. Add metadata:
    • Clear, descriptive name
    • Detailed description
    • Relevant tags
    • Variable documentation

Prepare Your Bundle

  1. Create an agent with the complete configuration
  2. Navigate to Agents → Your Agent → Share
  3. Click Create Bundle
  4. Select which promptlets to include
  5. Document all variables with examples
  6. Add recommended models

Submit for Review

  1. Click Submit to Marketplace
  2. Accept contributor agreement
  3. Wait for review (typically 1-2 business days)
  4. Receive notification of approval or feedback

Review Criteria

Submissions are reviewed for:

  • Quality - Well-written, clear instructions
  • Safety - No harmful or inappropriate content
  • Originality - Not a duplicate of existing items
  • Documentation - Clear variable explanations
  • Testing - Works with recommended models

Marketplace API

Note: The Marketplace API is in beta. Endpoints are subject to change.

List Promptlets

curl "https://api.demeterics.com/api/v1/marketplace/promptlets?category=personality&page=1&per_page=20" \
  -H "Authorization: Bearer dmt_your_api_key"

Query Parameters:

Parameter Type Description
category string Filter by category
industry string Filter by industry
use_case string Filter by use case
page int Page number (default: 1)
per_page int Results per page (default: 20)

Response:

{
  "promptlets": [
    {
      "id": "pmt_abc123",
      "slug": "friendly-support-persona",
      "title": "Friendly Support Persona",
      "description": "A warm, helpful customer support personality",
      "category": "personality",
      "industries": ["retail", "saas"],
      "use_cases": ["customer-support"],
      "clone_count": 1523,
      "is_official": true,
      "author_name": "Demeterics Team"
    }
  ],
  "total": 45,
  "page": 1,
  "per_page": 20
}

Get Promptlet Details

curl https://api.demeterics.com/api/v1/marketplace/promptlets/friendly-support-persona \
  -H "Authorization: Bearer dmt_your_api_key"

Clone Promptlet to Your Agent

curl -X POST https://api.demeterics.com/api/v1/marketplace/promptlets/friendly-support-persona/clone \
  -H "Authorization: Bearer dmt_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_xyz789"
  }'

List Bundles

curl "https://api.demeterics.com/api/v1/marketplace/bundles?category=support" \
  -H "Authorization: Bearer dmt_your_api_key"

Response:

{
  "bundles": [
    {
      "id": "bnd_abc123",
      "slug": "ecommerce-support-agent",
      "name": "E-commerce Support Agent",
      "description": "Complete customer support agent for online stores",
      "category": "support",
      "industries": ["retail", "ecommerce"],
      "use_cases": ["customer-support", "order-tracking"],
      "promptlet_count": 4,
      "clone_count": 892,
      "is_official": true,
      "author_name": "Demeterics Team",
      "greeting_message": "Hi! How can I help you today?",
      "suggested_questions": ["Where is my order?", "How do I return an item?"]
    }
  ],
  "total": 23,
  "page": 1,
  "per_page": 20
}

Apply Bundle to Agent

curl -X POST https://api.demeterics.com/api/v1/marketplace/bundles/ecommerce-support-agent/apply \
  -H "Authorization: Bearer dmt_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_xyz789"
  }'

Response:

{
  "status": "success",
  "agent_id": "agt_xyz789",
  "applied_at": "2025-01-29T12:00:00Z"
}

List Categories

curl https://api.demeterics.com/api/v1/marketplace/categories \
  -H "Authorization: Bearer dmt_your_api_key"

Customer Support

Pre-built agents for common support scenarios:

  • General Support - FAQ handling, ticket creation
  • E-commerce - Order tracking, refunds, shipping
  • SaaS - Onboarding, billing, feature requests
  • Technical - Troubleshooting, documentation lookup

Sales & Marketing

Lead generation and nurturing:

  • Lead Qualification - BANT scoring, handoff to sales
  • Product Demos - Interactive feature walkthroughs
  • Pricing Questions - Quote generation, plan comparison
  • Event Registration - Webinar and conference signups

Developer Tools

Technical use cases:

  • Code Review - Style checks, security scanning
  • Documentation - API docs, README generation
  • DevOps - Incident response, runbook execution
  • Testing - Test case generation, bug reporting

Enterprise

Specialized enterprise templates:

  • HR Onboarding - Employee questions, policy lookup
  • IT Helpdesk - Password resets, access requests
  • Legal - Contract review, compliance questions
  • Finance - Expense policies, budget inquiries

Best Practices

Writing Good Promptlets

  1. Be specific - Clear instructions produce better results
  2. Use variables - Make templates customizable with {{variable_name}}
  3. Include examples - Show the AI what good output looks like
  4. Test thoroughly - Try with multiple models and edge cases
  5. Document well - Explain what each variable does

Creating Effective Bundles

  1. Logical order - Arrange promptlets in a sensible sequence
  2. Minimal overlap - Each promptlet should have a distinct purpose
  3. Consistent tone - Ensure promptlets work together stylistically
  4. Reasonable defaults - Provide sensible default variable values
  5. Model testing - Verify bundle works with recommended models

What's Next?