Żądanie API
Komponent Żądanie API pozwala połączyć Twoje przepływy z zewnętrznymi API, wysyłając konfigurowalne żądania HTTP i obsługując odpowiedzi.
Opis komponentu
Jak działa komponent Żądanie API
Komponent Żądanie API
Komponent Żądanie API to wszechstronne narzędzie zaprojektowane do obsługi żądań HTTP w ramach Twoich workflow AI. Umożliwia Twojemu przepływowi interakcję z zewnętrznymi API lub usługami internetowymi poprzez wysyłanie żądań do jednego lub kilku adresów URL oraz przetwarzanie odpowiedzi. Ta funkcjonalność jest niezbędna do zadań takich jak pobieranie danych, integracja z usługami firm trzecich czy wywoływanie własnych endpointów w ramach procesów automatycznych lub inteligentnych.
Co robi ten komponent?
Ten komponent pozwala skonfigurować i wysłać żądania HTTP (GET, POST, PATCH, PUT) do określonych adresów URL. Możesz dostosować żądanie, dodając nagłówki, parametry zapytania oraz ciało żądania. Obsługuje również przesyłanie danych formularza oraz ustawianie własnych limitów czasu, dzięki czemu nadaje się do szerokiego zakresu interakcji z API.
Wejścia
Komponent Żądanie API obsługuje następujące konfigurowalne wejścia:
| Pole | Opis | Typ | Domyślne/Opcje |
|---|---|---|---|
| URL | Wprowadź jeden lub więcej docelowych adresów URL, oddzielonych przecinkami. | Tekst | |
| Metoda | Metoda HTTP używana do żądania. | Lista rozwijana | GET, POST, PATCH, PUT |
| Nagłówki | Własne nagłówki do dołączenia do żądania (jako słownik). | Słownik/Dane | |
| Ciało | Dane do wysłania dla żądań POST, PATCH lub PUT (jako słownik). | Słownik/Dane | |
| Parametry zapytania | Pary klucz-wartość do dodania jako parametry zapytania w adresie URL. | Słownik/Dane | |
| Użyj danych formularza | Przełącznik wysyłania danych jako application/x-www-form-urlencoded. | Boolean | false |
| Limit czasu | Czas (w sekundach) do upłynięcia limitu żądania. | Liczba całkowita | 5 |
| Cache TTL | Jak długo buforować odpowiedź API. Ustaw na ‘Brak bufora’, aby wyłączyć. | Lista rozwijana | Brak bufora, 5 min, … |
| Verbose | Jeśli włączone, drukuje szczegółowe informacje do debugowania. | Boolean | false |
| Nazwa narzędzia | Nazwa dla tego narzędzia żądania API (do wykorzystania przez agentów). | Tekst | |
| Opis narzędzia | Opis, który pomaga agentom zrozumieć, jak używać tego narzędzia. | Tekst (wieloliniowy) |
Wyjścia
Komponent generuje dwa główne wyjścia:
| Nazwa wyjścia | Typ | Opis |
|---|---|---|
| Dane | Dane | Dane odpowiedzi z żądania API. |
| Narzędzie | Narzędzie | Udostępnia to żądanie API jako „narzędzie” dla agentowych przepływów pracy. |
Dlaczego warto używać tego komponentu?
- Integracja: Połącz swój workflow AI z dowolnym zewnętrznym API lub usługą internetową, łatwo wzbogacając procesy o nowe dane lub akcje.
- Elastyczność: Obsługuje różne metody HTTP, własne nagłówki, ciała żądań i parametry zapytania – nadaje się zarówno do prostych, jak i złożonych wywołań API.
- Buforowanie: Opcjonalnie buforuje odpowiedzi, by poprawić wydajność i ograniczyć zbędne żądania API.
- Obsługa danych formularza: Umożliwia łatwe przesyłanie danych zakodowanych jak formularz do zgodnych endpointów.
- Przyjazny agentom: Zdefiniuj nazwę i opis narzędzia, aby komponent mógł być wykorzystywany jako narzędzie przez agentowe workflow AI.
Przykładowe zastosowania
- Pobieranie danych w czasie rzeczywistym (np. pogoda, wiadomości, finanse) z publicznych API.
- Przesyłanie informacji do usługi firm trzecich (np. CRM, system biletowy).
- Integracja z własnymi endpointami backendu w celu przetwarzania danych lub automatyzacji procesów.
- Umożliwienie agentom LLM wywoływania zewnętrznych API w ramach rozumowania lub realizacji zadań.
Podsumowanie
Komponent Żądanie API to kluczowy element każdego procesu AI, który musi komunikować się z usługami internetowymi lub zewnętrznymi źródłami danych. Oferuje szeroki zestaw opcji konfiguracyjnych umożliwiających obsługę różnorodnych scenariuszy żądań HTTP, a jego wyjścia można wykorzystywać bezpośrednio lub udostępniać jako narzędzie dla agentowych workflow AI.
Przykłady szablonów przepływu wykorzystujących komponent Żądanie API
Aby pomóc Ci szybko zacząć, przygotowaliśmy kilka przykładowych szablonów przepływu, które pokazują, jak efektywnie używać komponentu Żądanie API. Te szablony prezentują różne przypadki użycia i najlepsze praktyki, ułatwiając zrozumienie i implementację komponentu w Twoich własnych projektach.
Najczęściej zadawane pytania
- Do czego służy komponent Żądanie API?
Komponent Żądanie API umożliwia Twojemu przepływowi wysyłanie żądań HTTP (GET, POST, PATCH, PUT) do jednego lub wielu adresów URL, co pozwala łączyć się z dowolnym zewnętrznym API lub usługą internetową.
- Czy mogę dostosować nagłówki i ciało moich żądań API?
Tak, możesz dodać własne nagłówki i treść ciała, aby dopasować się do docelowego API. Oba elementy mogą być ustawione za pomocą wejść danych lub słowników.
- Czy obsługuje parametry zapytania oraz różne metody HTTP?
Oczywiście. Możesz dodać parametry zapytania do adresu URL i wybrać jedną z wielu metod HTTP, w tym GET, POST, PATCH i PUT.
- Czy mogę buforować odpowiedzi API?
Tak, możesz skonfigurować, jak długo odpowiedzi API mają być buforowane, lub całkowicie wyłączyć buforowanie, co daje kontrolę nad świeżością danych i wydajnością.
- Czy ten komponent nadaje się do integracji z narzędziami firm trzecich?
Tak, został zaprojektowany do bezproblemowej integracji z praktycznie każdą usługą zewnętrzną udostępniającą API, dzięki czemu jest kluczowym komponentem automatyzacji i zaawansowanych przepływów pracy.
Połącz przepływy z dowolnym API
Zacznij dodawać dane w czasie rzeczywistym, usługi zewnętrzne lub własne integracje do swoich przepływów za pomocą Żądania API.
Dowiedz się więcej
