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 Configurar um agente avançado, abra o editor visual e selecione API HTTP.
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 e todos os nodes.