API požiadavka
Komponent API požiadavka vám umožňuje prepojiť vaše toky s externými API odosielaním prispôsobiteľných HTTP požiadaviek a spracovaním odpovedí.
Opis komponentu
Ako funguje komponent API požiadavka
Komponent API požiadavka
Komponent API požiadavka je univerzálny nástroj navrhnutý na uľahčenie HTTP požiadaviek vo vašich AI workflowoch. Umožňuje vášmu workflowu komunikovať s externými API alebo webovými službami odosielaním požiadaviek na jednu alebo viacero URL adries a spracovaním odpovedí. Táto schopnosť je nevyhnutná pre úlohy ako získavanie dát, integráciu so službami tretích strán alebo volanie vlastných endpointov ako súčasť automatizovaných či inteligentných procesov.
Čo tento komponent robí?
Tento komponent vám umožňuje nakonfigurovať a odosielať HTTP požiadavky (GET, POST, PATCH, PUT) na zadané URL adresy. Požiadavku môžete prispôsobiť pridaním hlavičiek, parametrov dotazu a tela požiadavky. Podporuje aj spracovanie formulárových dát a nastavenie vlastných timeoutov, vďaka čomu je vhodný pre široké spektrum API interakcií.
Vstupy
Komponent API požiadavka podporuje nasledovné konfigurovateľné vstupy:
| Pole | Popis | Typ | Predvolené/možnosti |
|---|---|---|---|
| URL | Zadajte jednu alebo viac cieľových URL adries, oddelených čiarkou. | Reťazec | |
| Metóda | HTTP metóda, ktorá sa použije pre požiadavku. | Rozbaľovacie menu | GET, POST, PATCH, PUT |
| Hlavičky | Vlastné hlavičky zahrnuté v požiadavke (ako slovník). | Slovník/Dáta | |
| Telo | Dátové payloady pre POST, PATCH alebo PUT požiadavky (ako slovník). | Slovník/Dáta | |
| Parametre dotazu | Kľúč-hodnota páry, ktoré sa pridajú ako parametre dotazu v URL. | Slovník/Dáta | |
| Použiť form data | Prepínanie pre odosielanie dát ako application/x-www-form-urlencoded. | Boolean | false |
| Timeout | Čas (v sekundách) do vypršania požiadavky. | Celé číslo | 5 |
| Cache TTL | Ako dlho uchovávať odpoveď API v cache. Nastavte na ‘Bez cache’ pre vypnutie. | Rozbaľovacie menu | Bez cache, 5 min, … atď. |
| Verbose | Ak je zapnuté, vypisuje podrobné výstupy na ladenie. | Boolean | false |
| Názov nástroja | Názov tohto API nástroja (pre použitie agentmi). | Reťazec | |
| Popis nástroja | Popis na pomoc agentom s používaním tohto nástroja. | Reťazec (viacriadkový) |
Výstupy
Komponent vytvára dva hlavné výstupy:
| Názov výstupu | Typ | Popis |
|---|---|---|
| Dáta | Dáta | Odpoveď z API požiadavky. |
| Nástroj | Nástroj | Sprístupní túto API požiadavku ako “nástroj” pre workflowy využívajúce agenta. |
Prečo používať tento komponent?
- Integrácia: Prepojte váš AI workflow s akýmkoľvek externým API alebo webovou službou a jednoducho rozšírte procesy o nové dáta alebo akcie.
- Flexibilita: Podporuje viacero HTTP metód, vlastné hlavičky, telá aj parametre dotazu—vhodné pre jednoduché aj zložité API volania.
- Cacheovanie: Voliteľné cacheovanie odpovedí zlepšuje výkon a redukuje zbytočné volania API.
- Podpora formulárových dát: Jednoduché odosielanie dát vo formáte form-encoded pre kompatibilné endpointy.
- Pripravené pre agenta: Definujte názvy a popisy nástrojov, aby tento komponent mohli používať agenti v AI workflowoch.
Príklady použitia
- Získavanie dát v reálnom čase (napr. počasie, správy, financie) z verejných API.
- Odosielanie informácií do služby tretích strán (napr. CRM, ticketovací systém).
- Integrácia s vlastnými backend endpointmi pre spracovanie dát alebo automatizáciu workflowov.
- Umožnite LLM agentom volať externé API ako súčasť ich uvažovania alebo vykonávania úloh.
Zhrnutie
Komponent API požiadavka je kľúčovým stavebným prvkom pre každý AI proces, ktorý potrebuje komunikovať s webovými službami alebo externými zdrojmi dát. Ponúka komplexný súbor konfiguračných možností na pokrytie rôznych scenárov HTTP požiadaviek a jeho výstupy môžete využiť priamo alebo sprístupniť ako nástroj pre agentmi riadené AI workflowy.
Príklady flow šablón používajúcich komponent API požiadavka
Aby sme vám pomohli rýchlo začať, pripravili sme niekoľko ukážkových flow šablón, ktoré demonštrujú efektívne využitie komponentu API požiadavka. Tieto šablóny prezentujú rôzne prípady použitia a osvedčené postupy, čo vám uľahčí pochopenie a implementáciu komponentu vo vašich vlastných projektoch.
Najčastejšie kladené otázky
- Čo robí komponent API požiadavka?
Komponent API požiadavka umožňuje vášmu workflowu odosielať HTTP požiadavky (GET, POST, PATCH, PUT) na jednu alebo viacero URL adries, vďaka čomu sa môžete prepojiť s akýmkoľvek externým API alebo webovou službou.
- Môžem si prispôsobiť hlavičky a telo svojich API požiadaviek?
Áno, môžete pridať vlastné hlavičky a obsah tela podľa požiadaviek cieľového API. Obe je možné nastaviť pomocou dátových vstupov alebo slovníkov.
- Podporuje to parametre dotazu a rôzne HTTP metódy?
Samozrejme. Môžete pridať parametre dotazu k svojej URL a vybrať si z rôznych HTTP metód, vrátane GET, POST, PATCH a PUT.
- Môžem cacheovať odpovede API?
Áno, môžete nastaviť, ako dlho sa majú odpovede API uchovávať v cache, alebo cacheovanie úplne vypnúť, čo vám dáva kontrolu nad aktuálnosťou dát a výkonom.
- Je tento komponent vhodný pre integráciu s nástrojmi tretích strán?
Áno, je navrhnutý na bezproblémovú integráciu s prakticky akoukoľvek službou tretích strán, ktorá poskytuje API, a je tak kľúčovým komponentom pre automatizáciu a pokročilé workflowy.
Prepojte toky s akýmkoľvek API
Začnite pridávať dáta v reálnom čase, služby tretích strán alebo vlastné integrácie do svojich tokov pomocou API požiadavky.
Zistiť viac
