Ferramentas Nativas — Visão Geral

Ferramentas nativas são recursos integrados ao SquadOS que você pode habilitar em qualquer agente sem precisar configurar credenciais externas, contas em terceiros ou endpoints. Funcionam direto: você ativa, salva (quando precisa de configuração) e o agente passa a poder usar.

Onde habilitar

Na aba Ferramentas do agente, clique em + Adicionar Ferramenta. A tela abre com duas seções:

• FERRAMENTAS NATIVAS — lista as nativas ainda não ativas neste agente.
• OUTRAS FERRAMENTAS — integrações Composio e ferramentas HTTP customizadas da organização.

Clique na ferramenta desejada. Algumas ativam direto (sem configuração); outras abrem um formulário inline para configurar.

Depois de ativa, a ferramenta aparece na lista da aba Ferramentas com indicador verde (pronta) ou amarelo (precisa de configuração).

Ferramentas nativas vs. ferramentas externas

A distinção importa porque o esforço de configuração é bem diferente.

• Ferramentas nativas (este grupo): código embutido na plataforma. A maioria não tem configuração nenhuma — você só ativa. Algumas pedem um pequeno setup (escolher um modelo de imagem, URL de webhook, bases de conhecimento). Não consomem créditos extras além do uso normal do agente, exceto quando indicado (ex.: geração de imagem usa o modelo de imagem ativo).
• Ferramentas Composio: integrações com serviços terceiros (Gmail, Slack, Notion, etc.). Exigem conectar uma conta OAuth ou API key e escolher quais ações habilitar. Configuradas em Ferramentas no menu lateral.
• Ferramentas HTTP customizadas: chamadas REST que você mesmo define. Veja Ferramentas HTTP Customizadas.

Lista de ferramentas nativas

Ferramenta	O que faz
Data e Hora Atual	Retorna data e hora correntes em GMT/UTC.
HTML para Imagem	Renderiza HTML/CSS em imagem (criativos, posts, cards).
Intervenção Humana	Desliga a IA na conversa e dispara webhook para um humano assumir.
Gerar Imagem	Cria imagens a partir de um prompt textual.
Ler Anotações	Lê anotações salvas na conversa atual.
AutoLearn	Registra automaticamente perguntas que o agente não soube responder.
Consultar Base de Conhecimento	Faz busca semântica nas bases de conhecimento da organização.
Enviar Múltiplas Mensagens	Permite ao agente quebrar a resposta em várias mensagens separadas.
Transferir para agente	Passa a conversa para outro agente especializado da mesma organização.
Gravar Anotações	Salva ou atualiza anotações na conversa atual.
AutoPrompt	Permite ao agente editar o próprio prompt durante a conversa (modo sandbox).
Chamada HTTP	Infraestrutura interna de ferramentas HTTP customizadas — configurada via fluxo próprio.

Como o agente decide qual chamar

Para cada ferramenta ativa, o agente recebe:

• o nome e a descrição da ferramenta;
• a lista de parâmetros e o que cada um significa;
• o prompt do agente (suas instruções).

A partir disso, o modelo decide sozinho quando faz sentido chamar cada ferramenta. Você controla esse comportamento principalmente pelo prompt do agente: se você escreve “use a ferramenta X quando o usuário pedir Y”, o modelo passa a seguir.

Boas práticas:

• Habilite só o que o agente realmente precisa — cada ferramenta ativa consome contexto e pode confundir o modelo.
• Descreva no prompt os casos de uso de ferramentas menos óbvias.
• Teste em uma conversa real após habilitar uma nova ferramenta.

Requisitos do modelo

Todas as ferramentas nativas dependem de o modelo escolhido para o agente suportar tool calls (function calling). A maior parte dos modelos modernos (GPT-5 family, Claude 4.x, Gemini 2.x e 3.x, Llama 3.1+) suporta. Se você escolher um modelo sem suporte a tools, as ferramentas ficam invisíveis para ele.