Ferramentas
Os nove cards de ferramenta: busca, RAG, visão, cálculo, URLs, resumo, hora, MCP e webhooks — todos os campos.
Atualizado em 01 de set. de 2026
Ferramentas conectam nos slots de um Agent (viram tools que o modelo chama) ou se encadeiam em pipeline pela lateral. Todas gravam a configuração em data.config.
web_search · busca no GooglePesquisa na web e devolve título, link e snippet de cada resultado.
num_resultsnumberpadrão: 5Quantos resultados retornar.
regionstringRegião da busca (ex.: `br`, `us`). Vazio = global.
time_filterstringJanela temporal (`day`, `week`, `month`, `year`). Vazio = qualquer época.
safe_searchbooleanpadrão: trueFiltro de conteúdo sensível.
site_domainsstringRestringe a domínios (ex.: `gov.br, wikipedia.org`).
rag_search · suas bases de conhecimentoBusca semântica nas suas bases de conhecimento (documentos ingeridos). Selecione uma ou várias bases — de KBs ou de assistants.
rag_idsstring[]obrigatórioIDs das bases consultadas.
top_knumberpadrão: 3Quantos trechos retornar por consulta.
min_scorenumberpadrão: 0.7Relevância mínima (0–1) para um trecho entrar.
languagestringForça o idioma da consulta. Vazio = detecta.
vision · lê imagensDá olhos ao agente: descreve imagens e extrai texto (OCR) de anexos enviados pelo usuário.
modelstringModelo de visão usado. O padrão da plataforma já vem selecionado.
calculate · matemática exataAvalia expressões matemáticas com precisão — o modelo delega a conta em vez de "chutar". Sem configuração: conecte no slot e pronto.
fetch_url · abre páginasBaixa e extrai o conteúdo de páginas web. Em pipeline após a Busca Web, abre os resultados automaticamente.
max_urlsnumberpadrão: 5Quantas URLs abrir quando vier de um pipeline de busca.
depthnumberpadrão: 1Profundidade de navegação a partir da página inicial.
timeoutnumberpadrão: 30Timeout por página, em segundos.
extract_textbooleanpadrão: trueExtrai texto limpo em vez do HTML bruto.
use_readabilitybooleanpadrão: trueModo leitura: remove menus, anúncios e rodapés.
extract_metadatabooleanpadrão: trueInclui título, autor e data quando disponíveis.
follow_redirectsbooleanpadrão: trueSegue redirecionamentos.
max_content_lengthnumberpadrão: 10000Corte de tamanho do conteúdo extraído (caracteres).
stealthbooleanpadrão: falseModo discreto para sites que bloqueiam robôs.
use_browserbooleanpadrão: falseRenderiza com navegador (páginas que dependem de JavaScript). Mais lento.
summarize · condensa conteúdoResume o que chega pelo pipeline (páginas abertas, resultados de busca) com um modelo dedicado — o agente recebe só o essencial.
modelstringobrigatórioModelo que faz o resumo.
styleparagraph | bullet_points | key_facts | custompadrão: paragraphFormato do resumo.
custom_promptstringO prompt, quando `style` = `custom`.
max_lengthnumberpadrão: 500Tamanho alvo em palavras.
languagestringpadrão: pt-BRIdioma do resumo.
focusstringNo que concentrar (ex.: "preços e prazos").
include_sourcesbooleanpadrão: trueCita as fontes no resumo.
include_metadatabooleanpadrão: trueInclui título/autor/data dos conteúdos.
include_user_questionbooleanpadrão: falseAnexa a pergunta original do usuário ao contexto do resumo.
get_current_time · data e hora confiáveistimezone_namestring (IANA)padrão: America/Sao_PauloFuso horário da resposta.
formatfull | date | timepadrão: full`full` = `2024-03-15 14:30:45` · `date` = só a data · `time` = só a hora.
mcp · servidores Model Context ProtocolConecta servidores MCP (Model Context Protocol) ao agente. As credenciais vêm de Integrações na organização; as tools de cada servidor são descobertas automaticamente e você habilita uma a uma. Campos url/headers das credenciais aceitam {{variaveis}} — resolvidas com os valores do Início e do request.
servers[].credentialIdstringobrigatórioA credencial MCP cadastrada em Integrações.
servers[].namestringNome do servidor (exibição e prefixo das tools).
servers[].providerstringProvedor da integração.
servers[].tools[]{name, enabled}[]As tools descobertas — só as `enabled` ficam disponíveis ao agente.
webhook · suas APIs viram toolsTransforma qualquer API HTTP em ferramentas do agente: cada rota configurada vira uma tool com nome, descrição e parâmetros tipados — o modelo aprende quando e como chamar. É o card mais poderoso para integrar seu sistema, e o único com página própria.
config.baseUrlstringobrigatórioURL base da API (ex.: `https://api.loja.com/v1`).
config.auth.typenone | bearer | api_key | basic | custom_headerpadrão: noneAutenticação aplicada a todas as rotas — token, chave (header ou query), usuário/senha ou header customizado.
config.timeoutnumber (ms)padrão: 30000Timeout das chamadas.
config.routes[]WebhookRoute[]obrigatórioCada rota vira uma tool: `name`, `description`, `whenToUse`, `method`, `path`, `parameters[]`, `bodyTemplate`.
config.retryOnError / maxRetriesboolean / numberpadrão: true / 2Retenta falhas de **rede** (status ≥ 400 volta na hora, sem nova tentativa).
Webhook: a referência completa
Como uma rota vira tool, o que o modelo vê, as regras de substituição de {{parâmetros}}, autenticação, erros, combinações com outros cards e aplicações prontas.