Tools e Ferramentas

Ferramentas ampliam o que um agente consegue fazer. Em vez de só responder texto, ele pode consultar bases de conhecimento, chamar APIs, gerar imagens, transferir a conversa para outro agente ou intervir com um humano.

Tipos de ferramentas

O SquadOS trabalha com três grupos principais:

• Ferramentas nativas: recursos integrados ao SquadOS — consultar base, gerar imagem, HTML para imagem, transferir para agente, intervenção humana, anotações de conversa, AutoLearn, AutoPrompt, data/hora. Veja a lista completa em Ferramentas Nativas — Visão Geral.
• Ferramentas HTTP customizadas: chamadas REST configuradas no nível da organização ou do agente. Veja Ferramentas HTTP Customizadas.
• Integrações externas (Composio): conectores prontos para Gmail, Slack, Google Sheets, Notion, e centenas de outros serviços. Veja Ferramentas e demais guias da seção.

Aba Ferramentas

Na aba Ferramentas do editor do agente você vê todas as ferramentas conectadas a ele, com indicador de status (verde = pronta, amarelo = precisa de configuração).

Cada linha mostra:

• ícone e nome da ferramenta;
• identificador técnico (o nome que a IA usa);
• status atual;
• ações de editar e remover.

Adicionando uma ferramenta

Clique em + Adicionar Ferramenta. A tela abre com duas seções:

• Ferramentas Nativas — lista todas as nativas que ainda não estão ativas neste agente.
• Outras Ferramentas — integrações Composio e ferramentas HTTP customizadas da organização. Se nenhuma estiver disponível, aparece o link Ativar ferramentas em Admin que leva para /admin/tools.

Clique na ferramenta desejada. Se ela tem configuração (URL de webhook, modelo de imagem, bases de conhecimento, etc.), abre o formulário inline. Se não tem (ex.: Data e Hora Atual), é ativada com um clique e fica disponível imediatamente.

Como a IA decide usar uma ferramenta

A IA considera principalmente:

• a descrição da ferramenta (definida na própria ferramenta);
• a descrição dos parâmetros;
• as instruções no prompt do agente;
• a pergunta do usuário;
• o histórico da conversa.

Descrições claras são essenciais. Diga o que a ferramenta faz, quando usar e quais dados são obrigatórios.

Boas práticas

• Conecte apenas ferramentas que o agente realmente precisa — cada ferramenta ativa consome contexto e pode confundir o modelo.
• Prefira ferramentas específicas a ferramentas genéricas demais.
• Teste cada ferramenta antes de publicar o agente.
• Use parâmetros obrigatórios quando a chamada não puder funcionar sem eles.
• Oriente o prompt para o agente perguntar antes de chamar uma ferramenta sem dados suficientes.

Segurança

Segredos e tokens ficam armazenados no servidor, criptografados. A IA recebe apenas a definição da ferramenta e os parâmetros permitidos, nunca as credenciais.