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

# Commercial Agents & Marketplace

> Publish your agents to the marketplace and monetize your AI creations — or discover pre-built agents for your business.

## Overview

The **TalkifAI Marketplace** is a commercial platform where you can:

1. **Publish** your agents for others to use
2. **Discover** pre-built agents for common use cases
3. **Monetize** your AI creations
4. **Share** agents within your organization or globally

**Agent Visibility Modes:**

| Mode           | Who Can Access           | Best For                          |
| -------------- | ------------------------ | --------------------------------- |
| **Private**    | Only you + org admins    | Personal projects, testing        |
| **Public**     | All organization members | Team collaboration                |
| **Commercial** | Anyone (marketplace)     | Monetization, public distribution |

***

## Publishing a Commercial Agent

### Step 1: Build & Test Your Agent

Before publishing:

<Check>Agent handles 20+ test conversations successfully</Check>
<Check>System prompt is polished and professional</Check>
<Check>All functions work correctly</Check>
<Check>Voice quality is excellent</Check>
<Check>Edge cases are handled gracefully</Check>
<Check>Agent provides genuine value to users</Check>

<Warning>
  Commercial agents represent your brand. Poor quality agents receive negative reviews and damage your reputation.
</Warning>

### Step 2: Prepare Agent for Publication

1. **Complete Agent Profile:**
   * Professional name (e.g., "E-Commerce Support Pro" not "Test Bot")
   * Clear description explaining what it does
   * Comprehensive system prompt
   * All necessary functions configured

2. **Set Appropriate Pricing:**
   * Consider your costs (API usage, development time)
   * Research similar agents in marketplace
   * Start competitive, adjust based on demand

3. **Create Documentation:**
   * Usage instructions
   * Supported use cases
   * Limitations and requirements
   * Support contact information

### Step 3: Change Visibility to Commercial

**Via Studio:**

1. Go to **Agent Settings → Visibility**
2. Select **Commercial**
3. Fill in marketplace details:
   * **Category**: Customer Support, Sales, Healthcare, etc.
   * **Pricing**: Free (paid coming soon)
4. Click **Create Agent** (for new agents) or **Update Agent** (for existing)

**Note:** Your agent will appear in the marketplace immediately after creation. There's currently no formal review process, but ensure your agent meets quality standards.

**Via API:**

```bash theme={null}
POST /api/agents
Authorization: Bearer YOUR_SESSION_TOKEN
Content-Type: application/json

{
  "name": "E-Commerce Support Pro",
  "description": "Professional customer support agent for e-commerce...",
  "mode": "commercial",
  "agentArchitecture": "pipeline",
  "model": "gpt_4o_mini",
  "stt": "deepgram",
  "voiceId": "cartesia-voice-123",
  "sysMsg": "You are a professional customer support agent...",
  "languages": ["english"],
  "organizationId": "org_your123"
}
```

**Response:**

```json theme={null}
{
  "success": true,
  "agent": {
    "id": "agent_commercial123",
    "name": "E-Commerce Support Pro",
    "mode": "commercial",
    "message": "Commercial agent created successfully. It will be available in the marketplace."
  }
}
```

**Permissions:** Only organization **Owners** and **Admins** can create commercial agents. Members can only create private or public agents.

***

## Marketplace Discovery

### Browse Available Agents

1. Go to **Studio → Marketplace**
2. Browse all commercial agents
3. Filter by:
   * **Search**: Search by name, description, or organization
   * **Category**: Support, Sales, Healthcare, Finance, etc. (coming soon)

**Current Implementation:** All commercial agents from all organizations are shown. Filtering by category is planned for future releases.

### Agent Card Display

Each agent shows:

| Field            | Information                      |
| ---------------- | -------------------------------- |
| **Name**         | Agent name                       |
| **Description**  | Brief description                |
| **Organization** | Creator organization name        |
| **Architecture** | Pipeline or Realtime             |
| **Actions**      | Try Now, Delete (if owner/admin) |

### Try Before You Create

**Demo Mode:**

* Click **Try Now** on any agent card
* Opens demo page at `/demo?agentId={id}`
* Test in browser with voice or chat
* No credit card required for demo
* No activation or commitment needed

***

## Using Commercial Agents

### Try an Agent (Demo)

**Demo Mode:**

* Click **Try Now** on any agent card
* Opens demo page in browser
* Test the agent with voice or chat
* No credit card required
* No activation needed

### Activate an Agent (Copy to Your Org)

**Important:** Commercial agents cannot be directly "activated" — you create a copy in your organization.

**Process:**

1. Find agent in **Marketplace**
2. Note the agent configuration (name, description, system prompt, etc.)
3. Click **List Your Agent** or go to **Agents → Create Agent**
4. Create a new agent with **similar configuration**
5. Customize for your needs:
   * System prompt (adapt for your use case)
   * Voice (optional change)
   * Functions (add your API keys)
   * Knowledge bases (link your docs)
6. Set mode to **Commercial** (if you want to publish your version)
7. Click **Create Agent**

<Note>
  **Commercial agents are templates.** You don't "clone" them directly — instead, use them as inspiration to create your own agents with similar configurations. The marketplace showcases what's possible, and you can build your own version.
</Note>

### Customization

After creating your agent, it's **yours to modify**:

* ✅ Edit system prompt
* ✅ Change voice and settings
* ✅ Add/remove functions
* ✅ Link your knowledge bases
* ✅ Adjust for your use case
* ✅ Publish as your own commercial agent (optional)

### Pricing Models

**Current Model:**

* **Free to Use** — All marketplace agents are currently free
* **You Pay API Costs** — You pay for your own API usage (LLM, TTS, STT)
* **No Revenue Sharing Yet** — Revenue sharing is planned for future releases

**Future Model (Coming Soon):**

* **Paid Agents** — Creators can set prices
* **Revenue Share:** \~70% to creator, \~30% to TalkifAI platform
* **Monthly Payouts** — Via Stripe or similar
* **Minimum Payout:** \$50 (typical threshold)

**Earnings Dashboard (Coming Soon):**

* Track usage and revenue
* Download reports
* Manage subscriptions

***

## For Agent Creators

### Best Practices for Commercial Success

<CardGroup cols={2}>
  <Card title="Solve a Real Problem" icon="target">
    Focus on specific use cases. "E-commerce returns handler" performs better than "General support bot".
  </Card>

  <Card title="Professional Quality" icon="star">
    Invest in excellent voice quality, natural prompts, and thorough testing. First impressions matter.
  </Card>

  <Card title="Clear Documentation" icon="book">
    Provide setup instructions, use case examples, and troubleshooting guides.
  </Card>

  <Card title="Responsive Support" icon="envelope">
    Offer email support. Respond to user questions within 24-48 hours.
  </Card>

  <Card title="Regular Updates" icon="rotate">
    Improve your agent based on user feedback. Add features, fix issues, stay current.
  </Card>

  <Card title="Competitive Pricing" icon="dollar-sign">
    Research similar agents. Price fairly for the value provided. (When paid agents launch)
  </Card>
</CardGroup>

### Agent Categories

**Popular Categories:**

| Category             | Examples                          |
| -------------------- | --------------------------------- |
| **Customer Support** | Order tracking, returns, FAQs     |
| **Sales**            | Lead qualification, product demos |
| **Healthcare**       | Appointment booking, triage       |
| **Finance**          | Payment reminders, account info   |
| **Real Estate**      | Property inquiries, scheduling    |
| **Education**        | Tutoring, course information      |
| **Hospitality**      | Reservations, concierge           |
| **Legal**            | Initial consultation, intake      |

### Publishing Checklist

Before publishing your commercial agent:

<Check>Agent handles 20+ test conversations successfully</Check>
<Check>System prompt is polished and professional</Check>
<Check>All functions work correctly</Check>
<Check>Voice quality is excellent</Check>
<Check>Edge cases are handled gracefully</Check>
<Check>Agent provides genuine value to users</Check>
<Check>Clear description and documentation</Check>

<Warning>
  Commercial agents represent your brand. Poor quality agents receive negative feedback and damage your reputation.
</Warning>

***

## Permissions & Access Control

### Who Can Create Commercial Agents?

| Role       | Can Create Commercial                 |
| ---------- | ------------------------------------- |
| **Owner**  | ✅ Yes                                 |
| **Admin**  | ✅ Yes                                 |
| **Member** | ❌ No (can create private/public only) |

### Who Can Modify Commercial Agents?

| Agent Mode     | Who Can Edit                |
| -------------- | --------------------------- |
| **Private**    | Creator + org owners/admins |
| **Public**     | Creator + org owners/admins |
| **Commercial** | Only org owners/admins      |

<Warning>
  Commercial agents cannot be edited by members — only owners and admins. This prevents accidental changes to public-facing agents.
</Warning>

### Deleting Commercial Agents

**Restrictions:**

* Only org owners/admins can delete
* Creator can delete if also owner/admin
* Deleted agents cannot be recovered
* Existing users keep their copies

***

## API Reference

### List Commercial Agents

```bash theme={null}
GET /v1/marketplace/agents
```

**Query Parameters:**

| Param      | Type   | Description                |
| ---------- | ------ | -------------------------- |
| `category` | string | Filter by category         |
| `search`   | string | Search by name/description |
| `page`     | number | Page number                |
| `limit`    | number | Items per page             |

**Response:**

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "agent_commercial123",
      "name": "E-Commerce Support Pro",
      "description": "Professional customer support agent...",
      "category": "customer_support",
      "organization": {
        "name": "AI Solutions Inc",
        "slug": "ai-solutions"
      },
      "rating": 4.8,
      "users": 1250,
      "pricing": "free"
    }
  ]
}
```

### Get Agent Details

```bash theme={null}
GET /v1/marketplace/agents/{agentId}
```

### Clone Commercial Agent

**Note:** The marketplace doesn't have a direct "clone" feature. Instead, create your own agent based on the commercial agent's configuration.

```bash theme={null}
# Create your own agent inspired by marketplace agent
POST /api/agents
Authorization: Bearer YOUR_SESSION_TOKEN
Content-Type: application/json

{
  "name": "My Support Agent",
  "description": "Based on E-Commerce Support Pro",
  "mode": "public",
  "agentArchitecture": "pipeline",
  "model": "gpt_4o_mini",
  "stt": "deepgram",
  "voiceId": "cartesia-voice-123",
  "sysMsg": "You are a professional customer support agent...",
  "languages": ["english"],
  "organizationId": "org_your123"
}
```

**Response:**

```json theme={null}
{
  "success": true,
  "agent": {
    "id": "agent_your123",
    "name": "My Support Agent",
    "message": "Agent created successfully"
  }
}
```

***

## Legal & Compliance

### Terms of Service

**Agent Creators Must:**

* Own or have rights to all content
* Not infringe intellectual property
* Not include harmful or malicious code
* Comply with applicable laws
* Provide accurate descriptions

**Prohibited Content:**

* Hate speech or discrimination
* Medical/legal advice (without disclaimers)
* Adult or explicit content
* Political campaigning
* Spam or misleading information

### User Data & Privacy

* Commercial agents process user data
* Creators **cannot** access user conversation data
* All data handled per TalkifAI privacy policy
* GDPR and CCPA compliant

### Dispute Resolution

* Users can report problematic agents
* TalkifAI reviews and removes violating content
* Creators can appeal removal decisions
* Repeated violations → account suspension

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="My agent isn't appearing in marketplace">
    **Check:**

    1. Is mode set to `commercial`?
    2. Are you an Owner or Admin? (Members can't create commercial agents)
    3. Refresh the marketplace page
    4. Check browser console for errors

    **Fix:** Verify agent mode and permissions, then refresh.
  </Accordion>

  <Accordion title="How do I update my commercial agent?">
    **Process:**

    1. Edit agent in Studio (Agents → Edit)
    2. Make your changes
    3. Click **Update Agent**
    4. Changes apply immediately
    5. For major changes, notify existing users

    **Note:** All users see your updated version immediately.
  </Accordion>

  <Accordion title="Can I remove my agent from marketplace?">
    **Yes:**

    1. Go to agent settings
    2. Change mode from `commercial` to `private` or `public`
    3. Agent removed from marketplace immediately
    4. Existing users keep their copies
    5. New users cannot discover it
  </Accordion>

  <Accordion title="How do I support users of my agent?">
    **Best Practices:**

    * Provide email support in documentation
    * Respond within 48 hours
    * Create FAQ/troubleshooting guide
    * Monitor user feedback
    * Update agent based on common issues
  </Accordion>

  <Accordion title="Can members delete commercial agents?">
    **No.** Only Owners and Admins can delete commercial agents.

    **Reason:** Commercial agents are public-facing and affect your organization's reputation. Members can only delete their own private or public agents.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Browse Marketplace" icon="store">
    Discover pre-built agents for your use case.
  </Card>

  <Card title="Publish Your Agent" icon="rocket">
    Share your creation with the world.
  </Card>

  <Card title="Agent Templates" icon="file">
    Start with proven templates for common use cases.
  </Card>
</CardGroup>