Marketplace

Overview

The Marketplace provides ready-to-use tool templates that you can install in seconds:

Pre-configured — Tools are set up with best practices
One-click install — Just add your API keys
Categorized — Find tools by use case
Free and premium — Many templates are free

Browsing the Marketplace

Navigate to Agent → Tools → Marketplace to browse available templates.

Category	Examples
Search	Google Search, Bing, DuckDuckGo
Productivity	Calendar, Task management
Communication	Email, SMS, Slack
Data	Weather, Stock prices, Currency
E-commerce	Shopify, WooCommerce, Stripe

Template Information

Each template shows:

Name and description — What the tool does
Category and icon — Visual identification
Install count — Popularity indicator
Required configuration — API keys or settings needed
Free/Premium — Pricing status

Installing a Template

1. Select Template

Click on a template to view details:

Full description
Input parameters
Example usage
Required configuration

2. Provide Configuration

Most templates require some configuration:

{
  "requiredConfig": [
    {
      "key": "api_key",
      "label": "API Key",
      "type": "password",
      "placeholder": "sk-...",
      "helpText": "Get your API key from the dashboard",
      "helpUrl": "https://example.com/api-keys"
    }
  ]
}

Config Type	Description
`text`	Plain text input
`password`	Hidden/masked input (for API keys)
`url`	URL input

3. Install

Click Install to add the tool to your agent. The template’s placeholders are replaced with your configuration:

Before: https://api.example.com?key=${api_key}
After:  https://api.example.com?key=sk-your-actual-key

Configuration Substitution

Templates use ${config_key} placeholders that are replaced during installation:

In URLs

{
  "httpUrl": "https://api.weatherapi.com/v1/current.json?key=${weather_api_key}&q=${city}"
}

In Headers

{
  "httpHeaders": {
    "Authorization": "Bearer ${api_token}",
    "X-Api-Key": "${secondary_key}"
  }
}

In Mock Responses

{
  "mockResponse": "Welcome to ${company_name}! How can I help?"
}

Managing Installed Tools

After installation, tools appear in your agent’s Tools list:

Edit — Modify configuration or behavior
Enable/Disable — Toggle without deleting
Delete — Remove from agent

Installed tools reference the original template via templateId, allowing you to see template updates.

Trigger Templates

The Marketplace also includes trigger templates for common engagement patterns:

Category	Examples
Engagement	Welcome message, time on page
Conversion	Exit intent, pricing page
E-commerce	Cart abandonment, product view
Lead Generation	Scroll depth, content engagement
Support	Help page assistance
Feedback	Survey prompts

Installing Trigger Templates

Go to Agent → Triggers → Browse Templates
Select a template
Customize conditions if needed
Install

Some trigger templates include associated form templates that are installed together.

Popular Templates

Weather API

Get current weather conditions:

{
  "name": "get_weather",
  "description": "Get weather when user asks about weather conditions.",
  "httpUrl": "https://api.weatherapi.com/v1/current.json?key=${api_key}&q=${location}",
  "requiredConfig": [
    { "key": "api_key", "label": "WeatherAPI Key", "type": "password" }
  ]
}

Google Search

Search the web:

{
  "name": "web_search",
  "description": "Search the web for current information.",
  "httpUrl": "https://www.googleapis.com/customsearch/v1?key=${google_key}&cx=${search_engine_id}&q=${query}",
  "requiredConfig": [
    { "key": "google_key", "label": "Google API Key", "type": "password" },
    { "key": "search_engine_id", "label": "Search Engine ID", "type": "text" }
  ]
}

Contact Form

Basic contact form with Slack notification:

{
  "name": "contact_support",
  "description": "Show contact form when user needs human help.",
  "executionType": "form",
  "formSchema": {
    "fields": [
      { "name": "email", "label": "Email", "type": "email" },
      { "name": "message", "label": "Message", "type": "textarea" }
    ]
  },
  "formPostActions": [
    { "type": "slack", "webhookUrl": "${slack_webhook}", "messageTemplate": "New contact: {{email}}\n{{message}}" }
  ],
  "requiredConfig": [
    { "key": "slack_webhook", "label": "Slack Webhook URL", "type": "url" }
  ]
}

Shopify Product Search

Search Shopify products:

{
  "name": "search_products",
  "description": "Search products when user asks about items.",
  "httpUrl": "${shopify_store}/admin/api/2024-01/products.json?title=${query}",
  "httpHeaders": {
    "X-Shopify-Access-Token": "${shopify_token}"
  },
  "displayConfig": {
    "type": "product_carousel"
  },
  "requiredConfig": [
    { "key": "shopify_store", "label": "Store URL", "type": "url", "placeholder": "https://your-store.myshopify.com" },
    { "key": "shopify_token", "label": "Access Token", "type": "password" }
  ]
}

Creating Custom Templates

Currently, templates are managed by the Ansa team. To suggest a template:

Build and test the tool in your agent
Contact us with the tool configuration
We’ll review and potentially add it to the Marketplace

Best Practices

Security

Protect API keys — Use password-type config fields
Review permissions — Understand what access tools need
Rotate keys — Update API keys periodically

Testing

Test before deploying — Use the chat playground
Check error handling — Try edge cases
Monitor usage — Watch for API quota issues

Maintenance

Check for updates — Templates may be improved
Review periodically — Remove unused tools
Keep configs current — Update expired keys

Getting Started

User Guides

Use Cases

Developer Guides

Tools & Forms

Integrations

API Reference

Support

Marketplace

Overview

Browsing the Marketplace

Categories

Template Information

Installing a Template

1. Select Template

2. Provide Configuration

3. Install

Configuration Substitution

In URLs

In Headers

In Mock Responses

Managing Installed Tools

Trigger Templates

Installing Trigger Templates

Popular Templates

Weather API

Google Search

Contact Form

Shopify Product Search

Creating Custom Templates

Best Practices

Security

Testing

Maintenance

See Also

​Overview

​Browsing the Marketplace

​Categories

​Template Information

​Installing a Template

​1. Select Template

​2. Provide Configuration

​3. Install

​Configuration Substitution

​In URLs

​In Headers

​In Mock Responses

​Managing Installed Tools

​Trigger Templates

​Installing Trigger Templates

​Popular Templates

​Weather API

​Google Search

​Contact Form

​Shopify Product Search

​Creating Custom Templates

​Best Practices

​Security

​Testing

​Maintenance

​See Also

Overview

Browsing the Marketplace

Categories

Template Information

Installing a Template

1. Select Template

2. Provide Configuration

3. Install

Configuration Substitution

In URLs

In Headers

In Mock Responses

Managing Installed Tools

Trigger Templates

Installing Trigger Templates

Popular Templates

Weather API

Google Search

Contact Form

Shopify Product Search

Creating Custom Templates

Best Practices

Security

Testing

Maintenance

See Also