# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-10-30T16:33:11.883Z

## Página

- Título: API HTTP
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-agentes-avancados/api-http
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Monta uma requisição HTTP e disponibiliza a integração como capacidade do agente.

## Seções

- Onde configurar
- Campos principais
- Entradas, saídas e execução
- Exemplo de uso
- Cuidados
- Como testar

## Conteúdo da página

# API HTTP

Use **API HTTP** quando um sistema externo oferece uma API comum. O próprio bloco permite montar a consulta completa e selecionar o que deve voltar para a IA.

## Onde configurar

Acesse :ScreenEntry{href="https://my.agilize.app/config/agent-builder" label="Configurar um agente avançado" path="Configurações > Configuração Básica > IA > Agentes Avançados > Construtor Agentes Avançados"}, abra o editor visual e selecione **API HTTP**.

![Configuração do bloco API HTTP no construtor de Agentes Avançados](/docs/screenshots/agentes-avancados/api-http.png)

## Campos principais

| Campo | Como configurar |
| --- | --- |
| **Esta integração** | Declare consulta ou alteração de informações. |
| **Requisição HTTP** | Defina método, URL, autenticação e demais campos oferecidos pelo editor de requisição. |
| **Entradas da ferramenta** | Defina parâmetros e sua origem: conversa, contexto ou valor fixo. |
| **Campos devolvidos ao agente** | Um caminho por linha para reduzir a resposta aos dados necessários. |
| **Quando oferecer esta capacidade** | Descreva a finalidade do negócio e quando usar. |
| **Resposta para simulação** | Exemplo de retorno JSON para testes com ações simuladas. |
| **Confirmação no uso interno** | Revise para integrações que alteram dados. |

## Entradas, saídas e execução

Recebe uma entrada e possui **Depois · sequência**. As variáveis da requisição vêm das entradas declaradas. O resultado selecionado fica disponível para a resposta e para a continuação configurada.

## Exemplo de uso

Monte uma consulta GET a uma API de pedidos com o código informado pela pessoa. Selecione apenas situação e previsão no retorno. O endpoint e os campos exatos dependem da API contratada.

## Cuidados

Mantenha o domínio da URL fixo. Requisições de escrita precisam ser declaradas como alteração; não exponha uma operação destrutiva como consulta. Sem seleção de campos, o retorno continua sujeito ao limite de tamanho; respostas grandes podem exigir reduzir a projeção. Não coloque segredos no prompt.

## Como testar

Simule retorno válido, parâmetro ausente e erro. Depois valide uma consulta real controlada. Confira que dados sensíveis desnecessários não são devolvidos à IA.

Veja [Testar o agente](/docs/configuracao/inteligencia-artificial/agentes-avancados/testar-agente) e [todos os nodes](/docs/configuracao/referencias/nodes-agentes-avancados).