Overview
The Marketplace is your one-stop shop for discovering and installing pre-configured AI agents. These agents come with specialized capabilities, tools, and instructions ready to use in your workflows. This guide walks you through the complete installation process.
Accessing the Marketplace
1. Log into your DIMA workspace
2. Click "Tools" in the sidebar
3. Select "Marketplace"
Browsing Available Agents
Marketplace Layout
The marketplace displays agents in several sections:
- Hero Slider: Featured and popular agents at the top
- Trending Section: Most downloaded and popular agents
- AI Agents Section: Complete catalog of available agents
Finding Agents
Search Bar
- Type keywords to search by agent name, description, or capabilities
- Search filters results across all categories
Category Filter
- Use the dropdown to filter by category
- Select "Agents" to view only AI agents
- Select "All Categories" to see everything
Department Filter
- Filter by use case or department
- Examples: Research & Analysis, Content Creation, Data Processing
Agent Cards
Each agent card shows:
- Agent Image: Visual preview or avatar
- Agent Name: Title of the agent
- Price Badge: Credits required or "FREE"
- Download Count: Number of times installed
- Content Type Badge: Shows "AGENT"
- Status Badges:
- "Purchased": Green badge if you've already bought this agent
- "Update": Orange badge if a newer version is available
Viewing Agent Details
Opening the Detail Modal
Click any agent card to open a detailed view with comprehensive information.
Detail Modal Contents
- Agent Avatar: Large image or avatar
- Agent Name: Full title
- Status Indicators: Purchase status, update availability
Main Information
Description
- What the agent does
- Its role and capabilities
- Use cases and examples
Tools & Skills
- List of tools the agent can use
- Capabilities and integrations
- Special features
Version Information
- Current installed version (if already installed)
- Latest available version
- Update availability indicator
Pricing
- Credit cost (or "FREE")
- Your current credit balance
- Purchase status
Additional Details
- Download count
- Last updated date
- Agent provider information
- Example use cases
Purchase Process (Paid Agents)
If an agent costs credits and you haven't purchased it yet, you'll need to purchase it before installation.
Purchase Flow
1. Click "Hire Agent"
- System checks if you've already purchased the agent
- If not purchased, purchase modal appears
2. Purchase Confirmation Modal
- Shows agent name and price
- Displays your current credit balance
- Shows credits required vs. available
3. Confirm Purchase
- Click "Purchase" to confirm
- Credits are deducted from your balance
- Purchase is recorded globally (works across all workspaces)
4. Insufficient Credits
- If you don't have enough credits, an error message appears
- Shows required amount vs. available amount
- You'll need to add credits before proceeding
Already Purchased Agents
- Agents you've purchased show a green "Purchased" badge
- No additional purchase needed for future installations
- Can install to multiple workspaces without re-purchasing
Workspace Selection
Opening Workspace Selector
After clicking "Hire Agent" (or after purchase), the workspace selection modal appears.
Selecting Workspaces
Workspace List
- Shows all your available workspaces
- Favorites (starred) appear at the top
- Search bar to filter workspaces
Workspace Status Indicators
- Available: Can be selected (gray border)
- Selected: Checked and highlighted (beige/gold border)
- Already Installed: Shows green checkmark, cannot select
- Displays "Added" status
- Indicates agent already exists in that workspace
Selecting Multiple Workspaces
- Click workspace cards to toggle selection
- Select as many workspaces as needed
- Selected count shown in confirmation button
Search Functionality
- Type workspace name to filter
- Search by name, description, or slug
- Clear search to show all workspaces
Confirming Installation
1. Select one or more workspaces
2. Click "Install to X Workspace(s)" button
3. Installation process begins automatically
Installation Completion
Success State
When installation completes successfully:
Visual Confirmation
- Large agent avatar/image displayed
- Green checkmark badge on avatar
- "Successfully added agent" message
Next Steps
Single Workspace:
- "Open in [Workspace Name]" button appears
- Click to navigate directly to the agent in that workspace
- Opens the AI Agents page with the agent selected
Multiple Workspaces:
- List of installed workspaces shown
- Click any workspace name to navigate there
- Each workspace button opens that workspace's agent view
Partial Success
If some workspaces succeeded and others failed:
Visual Indicators
- Yellow warning badge on avatar
- "Installed, but some workspaces failed" message
- List of failed workspaces with error details
Error Details
- Each failed workspace shows:
- Workspace name
- Error message explaining the failure
- "Failed" status badge
Actions Available
- Navigate to successfully installed workspaces
- Review error messages for failed installations
- Try installation again if needed
Complete Failure
If all installations failed:
Visual Indicators
- Red error icon displayed
- "Installation failed" message
- List of all workspaces with failure reasons
Recovery Options
- "Try again" button: Retries installation
- "Contact support" link: Opens support email
After Installation
Finding Installed Agents
1. Navigate to Tools → AI Agents
2. Click **"Agents"** tab
3. Your installed agent appears in the list
Using Installed Agents
In Chat
- Type `@` followed by agent name
- Select from dropdown
- Agent is ready to use immediately
In Workflows
- Add agent to workflow in Workflow Editor
- Configure agent settings as needed
- Use in your automated workflows
Agent Configuration
- Click agent card to edit settings
- Modify instructions, tools, or model
- Customize for your specific needs
Updating Installed Agents
Checking for Updates
- Agents with available updates show "Update" badge on marketplace cards
- Detail modal shows version comparison
- Update button appears in detail modal
Update Process
1. Open agent detail modal
2. Click **"Update"** button (if available)
3. Update downloads and installs automatically
4. Success notification shows new version number
5. Agent updates across all installed workspaces
Update Benefits
- Get latest features and improvements
- Bug fixes and security updates
- Enhanced capabilities
- Better performance
Best Practices
Before Installation
1. Review Agent Details: Read description, tools, and examples
2. Check Requirements: Ensure you have necessary credits
3. Plan Workspaces: Decide which workspaces need the agent
4. Check Existing Installations: Avoid duplicate installations
During Installation
1. Don't Close Modal: Let installation complete
2. Monitor Progress: Watch for any errors
3. Wait for Completion: Don't navigate away during installation
After Installation
1. Test the Agent: Try using it in chat or workflow
2. Review Configuration: Check agent settings
3. Customize if Needed: Adjust instructions or tools
4. Monitor Updates: Check for new versions periodically
Troubleshooting
Installation Fails
Common Issues:
- Insufficient credits (for paid agents)
- Network connectivity problems
- Workspace permissions issues
- Agent package corruption
Solutions:
- Check your credit balance
- Verify internet connection
- Ensure workspace access permissions
- Try installation again
- Contact support if issues persist
Agent Not Appearing
After Installation:
- Refresh the AI Agents page
- Check correct workspace
- Verify installation completed successfully
- Check for error messages
Purchase Issues
Credits Not Deducted:
- Check purchase confirmation
- Verify credit balance
- Contact support if purchase didn't complete
Already Purchased But Asking to Purchase:
- Refresh marketplace page
- Clear browser cache
- Contact support
Update Issues
Update Button Not Appearing:
- Refresh marketplace page
- Check if update is actually available
- Verify you have an installed version
Update Fails:
- Check network connection
- Verify workspace permissions
- Try updating again
- Contact support if persistent
Tips
- Free Agents: Try free agents first to understand the system
- Multiple Workspaces: Install to multiple workspaces in one go
- Updates: Regularly check for agent updates
- Favorites: Star frequently used workspaces for faster selection
- Search: Use search to quickly find specific agents
- Details: Always review agent details before installing
Summary
Installing agents from the marketplace is a straightforward process:
1. Browse the marketplace to find agents
2. Review agent details and capabilities
3. Purchase if required (one-time, works across all workspaces)
4. Select workspaces where you want the agent
5. Monitor installation progress
6. Use the agent in chat or workflows
The marketplace makes it easy to discover and install powerful AI agents that can enhance your workflows and productivity. Once installed, agents are immediately available for use across your selected workspaces.