HTTP Request ca unealtă și Custom Code Tool în n8n & Automatizări AI

Cum dai agentului acces la orice API REST cu nodul HTTP Request folosit ca unealtă și la cod propriu cu Custom Code Tool.

Configurare nod & expresie
AI Agent -> Tool: HTTP Request (Optimize Response: JSON | HTML | Text)
AI Agent -> Tool: Custom Code Tool (Description, Language: JavaScript | Python, intrarea în query)

Ce face HTTP Request ca unealtă și Custom Code Tool

Nodul HTTP Request se poate folosi ca nod obișnuit sau atașat la AI Agent ca unealtă; parametrii (URL, query, corp) se pot completa de model cu $fromAI(). Nodul vechi HTTP Request Tool este eliminat în n8n 3.0; înlocuitorul este chiar nodul HTTP Request conectat la portul Tool.

Doar ca unealtă, HTTP Request are opțiunea Optimize Response, care reduce datele trimise modelului. Pentru JSON alegi Field Containing Data și Include Fields (All, Selected, Exclude). Pentru HTML alegi Selector (CSS) (implicit body), Return Only Content și Truncate Response. Pentru text, doar trunchierea. Max Response Characters are implicit 1000.

Custom Code Tool rulează cod JavaScript sau Python scris de tine. Description spune agentului când să-l folosească, iar intrarea de la agent este în variabila query. $fromAI() nu funcționează în acest nod.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
Optimize Response Doar ca unealtă: reduce răspunsul trimis modelului. Tipuri: JSON, HTML, Text.
Field Containing Data / Include Fields JSON: partea din răspuns folosită și câmpurile incluse (All, Selected, Exclude; notație cu punct pentru câmpuri imbricate).
Selector (CSS) / Return Only Content / Elements To Omit HTML: elementul păstrat, eliminarea tag-urilor și selectorii excluși.
Truncate Response / Max Response Characters Limitează mărimea răspunsului. Implicit 1000 de caractere.
Description (Custom Code Tool) Când trebuie folosită unealta și ce intrare așteaptă.
Language (Custom Code Tool) JavaScript sau Python.
query Intrarea primită de la agent, în codul Custom Code Tool.

Exemple practice

Exemplul 1: Vremea prin HTTP Request ca unealtă

GET https://api.open-meteo.com/v1/forecast?latitude={{ $fromAI('lat', 'Latitudinea', 'number') }}&longitude={{ $fromAI('lon', 'Longitudinea', 'number') }}¤t_weather=true
Optimize Response: on, JSON, Include Fields: Selected, Fields: current_weather

Exemplul 2: Custom Code Tool în JavaScript (exemplul din documentație)

let myString = query;
return myString.toLowerCase();

Greșeli frecvente și bune practici

  • Construiești pe nodul vechi HTTP Request Tool. Folosește nodul HTTP Request atașat la portul Tool.
  • Trimiți modelului pagini HTML întregi. Optimize Response cu Return Only Content și Truncate Response reduce tokenii.
  • Scrii $fromAI() în codul unui Custom Code Tool; acolo citești query.

Comenzi înrudite