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știquery.