Tool Types

Built-in Tools

JavaScript

Write custom server-side JavaScript code for complex business logic, data transformations, or calculations.

When to use: You need custom logic that isn't covered by other tool types, or you want to combine multiple operations into a single tool.

Configuration:

• Code - Your JavaScript code runs in a secure server environment
• Connection (optional) - Access database connections from your code

Example:

// Calculate order total with discounts
const subtotal = inputs.items.reduce((sum, item) => sum + item.price * item.quantity, 0);
const discount = inputs.couponCode ? subtotal * 0.1 : 0;
return {
  subtotal,
  discount,
  total: subtotal - discount
};

Your code has access to:

• inputs - The input values provided by the agent
• Database connections (if configured)

SQL

Run SQL queries against your database connections. Perfect for fetching, updating, or analyzing data.

When to use: You need to query a relational database like PostgreSQL, MySQL, or SQLite.

Configuration:

• Connection - Select a database connection (configured in Connections)
• Code - Your SQL query

Example:

SELECT o.id, o.total, c.name as customer_name
FROM orders o
JOIN customers c ON o.customer_id = c.id
WHERE o.status = {{status}}
ORDER BY o.created_at DESC
LIMIT 10

Use {{variableName}} syntax to insert input values safely (prevents SQL injection).

HTTP Call

Make HTTP requests to any external API or web service.

When to use: You need to call an external REST API that doesn't have a pre-configured connection.

Configuration:

Example:

• Method: POST
• URL: https://api.example.com/users/{{userId}}/orders
• Headers: Authorization: Bearer {{apiKey}}
• Body: {"items": {{items}}}

API Connection

Call APIs using your pre-configured API connections. The connection handles authentication automatically.

When to use: You have a reusable API connection set up and want to make authenticated calls without managing credentials in the tool.

Configuration:

This is similar to HTTP Call, but authentication is handled by the connection.

MongoDB Query (MQL)

Run MongoDB aggregate pipeline queries against your MongoDB databases.

When to use: You need to query a MongoDB database with complex aggregation pipelines.

Configuration:

Each aggregate stage has:

• Condition - When to include this stage (use true for always)
• Stage - The MongoDB aggregation stage as JSON

Example stages:

// Stage 1: Match documents
{ "$match": { "status": "active" } }

// Stage 2: Group and count
{ "$group": { "_id": "$category", "count": { "$sum": 1 } } }

GraphQL

Execute GraphQL queries against any GraphQL endpoint.

When to use: You need to query a GraphQL API, especially when you want fine-grained control over the data returned.

Configuration:

AI Generated Query mode: When enabled, you provide the schema (SDL) and examples. The AI writes queries based on user requests instead of using a fixed query.

RAG Search

Search your knowledge bases using semantic (vector) search. Returns relevant document chunks that the agent can reference.

When to use: You want the agent to answer questions using your uploaded documents.

Configuration:

The tool automatically:

1. Converts the search query to a vector embedding
2. Finds the most similar document chunks
3. Returns the relevant text for the agent to use

Notifications

Send messages via Slack or SMS.

When to use: You want the agent to notify users or teams about events, alerts, or updates.

Slack Configuration

SMS Configuration

Audio/Video Transcription

Convert audio or video files to text transcriptions.

When to use: You need to transcribe recordings, podcasts, meeting recordings, or any audio/video content.

Configuration:

Provider-specific options:

OpenAI Whisper:

• Model: whisper-1
• Response format: json, text, srt, verbose_json, or vtt

AssemblyAI:

• Model: best or nano
• Speaker labels: Identify different speakers
• Include timestamps: Add timing information

All providers:

• Max file size limit (optional)