Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ansa.so/llms.txt

Use this file to discover all available pages before exploring further.

​
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.

​
Categories

CategoryExamples
SearchGoogle Search, Bing, DuckDuckGo
ProductivityCalendar, Task management
CommunicationEmail, SMS, Slack
DataWeather, Stock prices, Currency
E-commerceShopify, 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 TypeDescription
textPlain text input
passwordHidden/masked input (for API keys)
urlURL 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:
CategoryExamples
EngagementWelcome message, time on page
ConversionExit intent, pricing page
E-commerceCart abandonment, product view
Lead GenerationScroll depth, content engagement
SupportHelp page assistance
FeedbackSurvey prompts

​
Installing Trigger Templates

  1. Go to Agent → Triggers → Browse Templates
  2. Select a template
  3. Customize conditions if needed
  4. Install
Some trigger templates include associated form templates that are installed together.

​
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" }
  ]
}
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" }
  ]
}
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:
  1. Build and test the tool in your agent
  2. Contact us with the tool configuration
  3. 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

​
See Also