ATOM Documentation

ATOM Marketplace Quick Start Guide

Get started with the ATOM marketplace in 5 minutes.

---

Table of Contents

• Prerequisites
• Step 1: Browse Marketplace
• Step 2: Install Your First Agent
• Step 3: Install Your First Skill
• Step 4: Use Installed Items
• Step 5: Publish Your First Item
• Common Workflows

---

Prerequisites

• **ATOM Account**: Free account on atomagentos.com
• **Plan**: Any plan (Free, Solo, Team, Enterprise)
• **Time**: 5 minutes to get started

**No credit card required** for free tier!

---

Step 1: Browse Marketplace (1 minute)

Access the Marketplace

1. **Log in to ATOM**

• Go to app.atomagentos.com
• Sign in with your credentials

1. **Navigate to Marketplace**

• Click **"Marketplace"** in the left sidebar
• You'll see 4 marketplace types:
• 🤖 **Agents** - Pre-trained AI assistants
• ⚡ **Skills** - Reusable capabilities
• 🎨 **Canvases** - Visual templates
• 🎯 **Domains** - Specialized expertise

1. **Explore**

• Browse featured items
• Check popular categories
• View top-rated items

**✅ Marketplace accessed!**

---

Step 2: Install Your First Agent (2 minutes)

Find and Install an Agent

1. **Go to Agent Marketplace**

1. **Search for an Agent**

• Try searching for: "customer support"
• Or browse: Customer Service category

1. **Select an Agent**

• Click on any agent card
• Read the description
• Check the rating (look for ⭐⭐⭐⭐⭐)
• Review resource requirements

1. **Click "Install"**

• Review installation details
• Click **"Install Agent"**
• Wait for installation (5-10 seconds)

1. **Agent Ready!**

• Agent appears in your Agents list
• Ready to use immediately

**Example Installation:**

Installing: Customer Support Agent
Version: 2.1
Publisher: Acme Corp
Rating: ⭐⭐⭐⭐⭐ (4.8/5)
Resource Impact: Medium

✓ Compatible with Free plan
✓ No additional setup required

[Installing...] → [Done!]

**✅ First agent installed!**

---

Step 3: Install Your First Skill (1 minute)

Find and Install a Skill

1. **Go to Skill Marketplace**

1. **Search for a Skill**

• Try: "data extraction"
• Or browse: Data Processing category

1. **Select a Skill**

• View skill details
• Check input/output examples
• Verify dependencies

1. **Click "Install"**

• Review skill code (optional)
• Click **"Install Skill"**
• Instant installation

**Example Installation:**

Installing: Data Extractor
Type: API
Rating: ⭐⭐⭐⭐ (4.2/5)
Dependencies: None

Input: {text: "Contact: john@example.com", fields: ["email"]}
Output: {"email": "john@example.com", "confidence": 0.95}

[Install] → [Done!]

**✅ First skill installed!**

---

Step 4: Use Installed Items (1 minute)

Use Your New Agent

1. **Open Your Agent**

1. **Start a Conversation**

• Type a message in the chat
• Example: "Help me respond to this customer inquiry..."

1. **Agent Responds**

• Agent processes your request
• Provides helpful response
• Takes action if appropriate

1. **Provide Feedback**

• Click 👍 or 👎 on response
• Helps agent learn and improve

Use Your New Skill

1. **Open Canvas**

1. **Add Skill to Workflow**

• Click **"Add Skill"**
• Search for "Data Extractor"
• Drag onto canvas

1. **Configure Skill**

• Connect data sources
• Set input parameters
• Test the skill

1. **Run Workflow**

• Click **"Run"**
• See results in real-time

**✅ You're using marketplace items!**

---

Step 5: Publish Your First Item (Optional)

Once you've created agents or skills, share them with the community!

Publish a Skill

**Prerequisites:**

• Skill created and tested
• Documentation complete
• No sensitive data

**Steps:**

1. **Navigate to Your Skill**

1. **Fill in Details**

1. **Add Documentation**

• Long description
• Usage examples
• Input/output schemas

1. **Submit**

• Click **"Submit for Review"**
• Wait for approval (1-2 business days)

1. **Published!**

• Appears in marketplace
• Others can install and use

**✅ Item published!**

---

Common Workflows

Workflow 1: Quick Agent Setup (2 minutes)

**Goal**: Get a specialized agent working quickly

1. Marketplace → Agents
2. Search: "sales assistant"
3. Select: ⭐⭐⭐⭐⭐ Sales Agent Pro
4. Click: Install
5. Open agent and start using

**Time**: 2 minutes

**Result**: Fully functional sales agent

---

Workflow 2: Build Custom Workflow (3 minutes)

**Goal**: Create a workflow with marketplace skills

1. Marketplace → Skills
2. Install: "Data Extractor"
3. Install: "Email Sender"
4. Canvas → Create New
5. Add both skills to canvas
6. Connect skills: Extractor → Email Sender
7. Run workflow

**Time**: 3 minutes

**Result**: Automated data extraction and email workflow

---

Workflow 3: Enhance Existing Agent (5 minutes)

**Goal**: Add skills to your agent

1. Agents → [Select Your Agent]
2. View agent details
3. Click: "Add Skills"
4. Browse marketplace skills
5. Install: "Document Summarizer"
6. Install: "Web Search"
7. Skills added to agent
8. Agent can now use new capabilities

**Time**: 5 minutes

**Result**: Enhanced agent with new skills

---

Workflow 4: Share with Team (2 minutes)

**Goal**: Share marketplace items with your team

1. Marketplace → My Installations
2. Select installed item
3. Click: "Share with Team"
4. Choose team members
5. Send invitation
6. Team members can now use item

**Time**: 2 minutes

**Result**: Team collaboration

---

Workflow 5: Update Installed Items (1 minute)

**Goal**: Keep items up to date

1. Marketplace → My Installations
2. Check for updates
3. Select item with update available
4. View changelog
5. Click: "Update"
6. Updated to latest version

**Time**: 1 minute

**Result**: Latest features and bug fixes

---

Tips for Success

For Browsing

✅ **Use filters** - Narrow down by category, rating, price

✅ **Read reviews** - Learn from other users' experiences

✅ **Check ratings** - Look for 4+ star items

✅ **View examples** - Understand how items work

For Installing

✅ **Start with free items** - Test before buying

✅ **Check compatibility** - Ensure it works with your plan

✅ **Review resources** - Understand resource impact

✅ **Install gradually** - Add items as needed

For Using

✅ **Provide feedback** - Rate items after using

✅ **Read documentation** - Understand capabilities

✅ **Test thoroughly** - Verify it meets your needs

✅ **Customize carefully** - Updates may override changes

For Publishing

✅ **Test thoroughly** - Ensure everything works

✅ **Document well** - Help others understand

✅ **Price fairly** - Consider value and competition

✅ **Support users** - Respond to reviews and questions

---

Quick Reference

Marketplace Types

Keyboard Shortcuts

**Navigation:**

• G + M - Go to Marketplace
• G + A - Go to Agents
• G + C - Go to Canvas

**Marketplace:**

• / - Focus search
• Arrow Keys - Navigate items
• Enter - Open selected item
• Esc - Close modal

---

Troubleshooting

"Installation Failed"

**Solution:**

1. Check plan limits (Free: 3 agents, 10 skills)
2. Verify you have enough resources
3. Try again in a few minutes

"Item Not Found"

**Solution:**

1. Check spelling in search
2. Try different keywords
3. Browse categories instead

"Can't Install - Requires Integration"

**Solution:**

1. Note required integration
2. Go to Integrations
3. Connect required service
4. Return and install item

---

What's Next?

🎓 Learn More

• **Full User Guide** - Complete marketplace documentation
• **API Documentation** - Integrating marketplace via API
• **Federation Protocol** - Cross-instance marketplace

🔗 Connect Integrations

Unlock more capabilities:

• **Slack** - Agent notifications and responses
• **Google Drive** - Document processing
• **Salesforce** - CRM automation
• **Notion** - Knowledge base integration

🚀 Advanced Features

• **Private Marketplace** - Share within organization
• **Federation** - Cross-instance sharing
• **Publishing** - Share your creations
• **Customization** - Tailor items to your needs

---

Pricing Quick Reference

**Marketplace items:**

• Most items are **FREE**
• Paid items: One-time or subscription
• Billed through your ATOM account

---

FAQ

**Q: Do I need to pay to use the marketplace?**

A: No! Browsing is free. Many items are free. Paid items are optional.

**Q: Can I uninstall items?**

A: Yes! Go to "My Installations" and click "Uninstall".

**Q: How do I get support for marketplace items?**

A: Contact the item publisher for item-specific issues.

**Q: Can I share installed items with my team?**

A: Yes! Items are shared across your organization.

**Q: How often are items updated?**

A: Publishers update items regularly. You'll see update notifications.

**Q: What if an item doesn't work as expected?**

A: Check documentation, contact publisher, or leave constructive feedback.

---

Getting Help

**Documentation:** docs.atomagentos.com

**Support:** support@atomagentos.com

**Community:** community.atomagentos.com

**Status:** status.atomagentos.com

---

Checklist

Get started in 5 minutes:

• [ ] Log in to ATOM
• [ ] Navigate to Marketplace
• [ ] Browse available items
• [ ] Install first agent
• [ ] Install first skill
• [ ] Use installed items
• [ ] Provide feedback
• [ ] Explore more items

---

**🎉 Congratulations!** You've completed the ATOM Marketplace Quick Start.

**← Back to Documentation Index** | **Full User Guide →**