Skip to content

Tools

The nine tool cards: search, RAG, vision, calculation, URLs, summary, time, MCP, and webhooks — all fields.

Updated on Sep 02, 2026

Tools connect to an Agent's slots (becoming tools the model calls) or chain in pipeline from the side. All save configuration to data.config.

Tools · web_search · Google search

Searches the web and returns title, link, and snippet for each result.

num_resultsnumberpadrão: 5

How many results to return.

regionstring

Search region (e.g., `br`, `us`). Empty = global.

time_filterstring

Time window (`day`, `week`, `month`, `year`). Empty = any time.

safe_searchbooleanpadrão: true

Sensitive content filter.

site_domainsstring

Restrict to domains (e.g., `gov.br, wikipedia.org`).

Knowledge (RAG)

Tools · rag_search · your knowledge bases

Semantic search across your knowledge bases (ingested documents). Select one or multiple bases — from KBs or assistants.

rag_idsstring[]obrigatório

IDs of the bases queried.

top_knumberpadrão: 3

How many passages to return per query.

min_scorenumberpadrão: 0.7

Minimum relevance (0–1) for a passage to be included.

languagestring

Force the query language. Empty = auto-detect.

Vision (OCR)

Tools · vision · reads images

Gives the agent eyes: describes images and extracts text (OCR) from attachments sent by the user.

modelstring

Vision model used. The platform default is already selected.

Calculator

Tools · calculate · exact math

Evaluates mathematical expressions with precision — the model delegates the calculation instead of guessing. No configuration: connect to the slot and go.

Fetch URL

Tools · fetch_url · opens pages

Downloads and extracts content from web pages. In a pipeline after Web Search, opens results automatically.

max_urlsnumberpadrão: 5

How many URLs to open when coming from a search pipeline.

depthnumberpadrão: 1

Navigation depth from the starting page.

timeoutnumberpadrão: 30

Timeout per page, in seconds.

extract_textbooleanpadrão: true

Extract clean text instead of raw HTML.

use_readabilitybooleanpadrão: true

Reader mode: removes menus, ads, and footers.

extract_metadatabooleanpadrão: true

Include title, author, and date when available.

follow_redirectsbooleanpadrão: true

Follow redirects.

max_content_lengthnumberpadrão: 10000

Content size cutoff for extracted text (characters).

stealthbooleanpadrão: false

Stealth mode for sites that block bots.

use_browserbooleanpadrão: false

Render with browser (pages that depend on JavaScript). Slower.

Summarize

Tools · summarize · condenses content

Summarizes what comes through the pipeline (opened pages, search results) with a dedicated model — the agent receives only the essentials.

modelstringobrigatório

Model that performs the summary.

styleparagraph | bullet_points | key_facts | custompadrão: paragraph

Summary format.

custom_promptstring

The prompt, when `style` = `custom`.

max_lengthnumberpadrão: 500

Target size in words.

languagestringpadrão: pt-BR

Summary language.

focusstring

What to focus on (e.g., "prices and deadlines").

include_sourcesbooleanpadrão: true

Cites sources in the summary.

include_metadatabooleanpadrão: true

Includes title/author/date of contents.

include_user_questionbooleanpadrão: false

Appends the user's original question to the summary context.

Current Time

Tools · get_current_time · reliable date and time
timezone_namestring (IANA)padrão: America/Sao_Paulo

Response timezone.

formatfull | date | timepadrão: full

`full` = `2024-03-15 14:30:45` · `date` = date only · `time` = time only.

MCP

Tools · mcp · Model Context Protocol servers

Connects MCP (Model Context Protocol) servers to the agent. Credentials come from Integrations in the organization; tools from each server are discovered automatically and you enable them one by one. The url/headers fields in credentials accept {{variables}} — resolved with values from Startup and the request.

servers[].credentialIdstringobrigatório

The MCP credential registered in Integrations.

servers[].namestring

Server name (display and tool prefix).

servers[].providerstring

Integration provider.

servers[].tools[]{name, enabled}[]

The discovered tools — only `enabled` ones are available to the agent.

Webhook

Tools · webhook · your APIs become tools

Transforms any HTTP API into agent tools: each configured route becomes a tool with name, description, and typed parameters — the model learns when and how to call it. It's the most powerful card for integrating your system, and the only one with its own page.

config.baseUrlstringobrigatório

API base URL (e.g., `https://api.store.com/v1`).

config.auth.typenone | bearer | api_key | basic | custom_headerpadrão: none

Authentication applied to all routes — token, key (header or query), username/password, or custom header.

config.timeoutnumber (ms)padrão: 30000

Timeout for calls.

config.routes[]WebhookRoute[]obrigatório

Each route becomes a tool: `name`, `description`, `whenToUse`, `method`, `path`, `parameters[]`, `bodyTemplate`.

config.retryOnError / maxRetriesboolean / numberpadrão: true / 2

Retries **network** failures (status ≥ 400 returns immediately, no retry).

Webhook: the complete reference

How a route becomes a tool, what the model sees, parameter substitution rules, authentication, errors, combinations with other cards, and ready-made applications.

Open the Webhook page
Was this page helpful?