OpenAPI Toolkit naloži OpenAPI (Swagger) specifikacijo (YAML ali JSON) in vsak izbrani endpoint pretvori v ločeno orodje. Agent tako lahko kliče celoten REST API brez ročnega nastavljanja vsakega Request Get/Post.
Kdaj uporabiti
- Imate obstoječi REST API z OpenAPI 3.0 / Swagger specifikacijo.
- Želite, da agent uporablja več endpointov (npr. iskanje, podrobnosti, ustvarjanje).
- Želite avtomatsko shemo parametrov iz specifikacije namesto ročnega Body/Query Params Schema.
Nastavitve v Flowise
Vnos specifikacije
| Parameter |
Opis |
| Input Type |
Upload File – naložite lokalno .yaml/.json datoteko. Provide Link – URL do OpenAPI datoteke (npr. https://api.example.com/openapi.json). |
| OpenAPI File |
Naložite datoteko (pri Input Type = Upload File). |
| OpenAPI Link |
URL do specifikacije (pri Input Type = Provide Link). |
Izbira strežnika in endpointov
| Parameter |
Opis |
| Server |
Izberite kateri servers vhod iz specifikacije uporabiti (base URL). |
| Available Endpoints |
Multi-izbira: katere endpointe želite izpostaviti kot orodja. Ostali ne bodo na voljo agentu. |
Opcijski parametri
| Parameter |
Opis |
| Return Direct |
Če je vključeno, se izhod orodja vrne neposredno uporabniku brez nadaljnje obdelave s strani agenta. |
| Headers |
JSON z glavami, ki jih želite poslati z vsakim klicem (npr. {"Authorization": "Bearer <token>"}). |
| Remove null parameters |
Odstrani parametre z vrednostjo null iz zahteve. |
| Custom Code |
Funkcija za prilagoditev izhoda orodja (npr. formatiranje ali filtriranje). |
Credentials
Odvisno od API-ja: če specifikacija zahteva securitySchemes, jih nastavite v credentialu in povežite z nodeom. Za preprost API key pogosto zadostuje polje Headers z Bearer tokenom ali x-api-key.
Uporaba v Agentflow V2
- Dodajte Tool → OpenAPI Toolkit.
- Naložite OpenAPI datoteko ali vnesite link.
- Izberite Server (base URL) in Available Endpoints.
- V Headers vnesite API ključ, če je potreben.
- Povežite orodje z agentom. Agent bo videl vsak izbrani endpoint kot ločeno orodje z opisom iz specifikacije.
Omejitve in nasveti
- Specifikacija mora biti veljavna OpenAPI 3.x (ali 2.0, če ga runtime podpira).
- Za zelo velike specifikacije izberite le potrebne endpointe, da se zmanjša število orodij in tokenov.
- Če API zahteva OAuth2 ali kompleksno avtentikacijo, preverite, ali je podprta v credentialih Flowise.
Povezave