Chamada HTTP (infraestrutura)

O que é

A Chamada HTTP é o tipo de ferramenta nativa por baixo de toda ferramenta HTTP customizada que você cria. Cada endpoint configurado (URL, método, autenticação, parâmetros) é registrado internamente como uma instância de Chamada HTTP — e o agente chama cada um pelo nome técnico que você definiu.

Você não adiciona “Chamada HTTP” diretamente no menu de ferramentas nativas. Ela existe sob outro fluxo: o de criar uma ferramenta HTTP customizada.

Onde você realmente configura

A criação e configuração das ferramentas HTTP acontece em Ferramentas no menu lateral:

Ferramentas → Ativas → + Nova Ferramenta Customizada

Uma vez criada, a ferramenta aparece em OUTRAS FERRAMENTAS quando você clica em + Adicionar Ferramenta dentro de qualquer agente da organização.

A documentação detalhada do fluxo de criação está em Ferramentas HTTP Customizadas.

Quando usar

Sempre que o agente precisa conversar com um sistema externo que não está coberto pelas integrações Composio nem pelas outras ferramentas nativas:

• API interna da sua empresa (CRM proprietário, ERP, sistema de billing).
• Webhook customizado de automação (Zapier, Make, n8n) que você quer o agente acionar.
• Serviço público sem integração pronta (qualquer REST API).
• Cálculo ou processamento que vive em um backend seu.

Como o agente invoca

Cada ferramenta HTTP que você configura aparece para o modelo com:

• o nome técnico que você definiu;
• a descrição que você escreveu;
• a lista de parâmetros que ela aceita.

O agente decide chamar uma ferramenta HTTP específica quando a pergunta do usuário casa com a descrição da ferramenta. A qualidade da descrição e dos nomes dos parâmetros é o que mais influencia esse comportamento.

Quando chamada, o SquadOS monta a requisição HTTP no servidor, injeta credenciais (se configuradas), envia, recebe a resposta e devolve o resultado ao agente.

Por que essa ferramenta aparece nessa lista

O http_api é tecnicamente uma ferramenta nativa porque compartilha a mesma infraestrutura interna das outras (registro, validação, execução). Mas do ponto de vista de uso, o caminho de configuração é completamente diferente — você não vai no menu de ferramentas nativas e clica em “Chamada HTTP”. Você vai em Ferramentas → + Nova Ferramenta Customizada e configura o endpoint.

Limitações e notas

• Configuração detalhada está em outro doc. Veja Ferramentas HTTP Customizadas para o passo a passo de URL, método, autenticação, body template e parâmetros.
• Credenciais ficam no servidor. Tokens e segredos são armazenados criptografados — o modelo nunca recebe o segredo, só o resultado da chamada.
• Teste antes de publicar. Cada ferramenta HTTP tem um teste no próprio formulário; ela só é considerada configurada (verde) depois de um teste com sucesso.
• Escopos disponíveis: ferramentas HTTP são criadas no escopo da organização e qualquer agente pode ativar. Não há escopo por agente (criação separada por agente).