Commercial Agents & Marketplace

​

Overview

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

​

Publishing a Commercial Agent

​

Step 1: Build & Test Your Agent

​

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

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)

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"
}

{
  "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."
  }
}

​

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)

​

Agent Card Display

​

Try Before You Create

• 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)

• 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)

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

​

Customization

• ✅ 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

• 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

• 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)

• Track usage and revenue
• Download reports
• Manage subscriptions

​

For Agent Creators

​

Best Practices for Commercial Success

​

Agent Categories

​

Publishing Checklist

​

Permissions & Access Control

​

Who Can Create Commercial Agents?

​

Who Can Modify Commercial Agents?

​

Deleting Commercial Agents

• 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

GET /v1/marketplace/agents

{
  "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

GET /v1/marketplace/agents/{agentId}

​

Clone Commercial Agent

# 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"
}

{
  "success": true,
  "agent": {
    "id": "agent_your123",
    "name": "My Support Agent",
    "message": "Agent created successfully"
  }
}

​

Legal & Compliance

​

Terms of Service

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

• 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

​

Next Steps