Click: agent AI przez API we własnej aplikacji

Do czego służy Click? Proste wyjaśnienie

Click to zarządzana usługa uruchamiania agentów AI przez API. Deweloper przekazuje klucz modelu, instrukcje i dozwolone narzędzia, a Click obsługuje wywołania modelu i narzędzi, historię rozmowy oraz odzyskiwanie wykonania. Aplikacja odbiera wyniki przez API, strumień zdarzeń lub webhooki.

Przykładem jest asystent w produkcie, który analizuje CSV i przygotowuje raport. Twoja aplikacja kontroluje użytkowników, dostęp do danych i zatwierdzanie działań; Click dostarcza warstwę wykonawczą. Usługę prowadzi Click AI Labs, Inc. Rozwiązanie pasuje do zadań wieloetapowych i pracy w tle, ale wymaga integracji backendu oraz sprawdzania wyników.

Koszt platformy a koszt modeli AI

Publiczne ceny miesięczne w USD sprawdzono 3 listopada 2026 r. na oficjalnej stronie cennika. Nie są to potwierdzone kwoty końcowe w PLN z podatkiem.

• Free: 0 USD/miesiąc. Dwie równoczesne sesje rezydentne, 100 MB plików oraz miesięcznie godzina zarządzanego sandboxa, godzina przeglądarki i 100 wyszukiwań.
• Pro: 199 USD/miesiąc. 50 sesji rezydentnych, 10 GB oraz miesięcznie po 100 godzin sandboxa i przeglądarki, a także 5000 wyszukiwań.
• Enterprise: indywidualna cena i limity.

BYOK oznacza korzystanie z własnych kluczy modelu. Koszt dostawcy modelu oraz zewnętrznych usług trzeba uwzględnić osobno. Pojemność plików jest limitem bieżącym, nie nowym miesięcznym przydziałem. Zarządzane zasoby są wspólne dla tenanta; Free odnawia się według miesięcy kalendarzowych UTC, Pro według opłaconego okresu rozliczeniowego.

Do współbieżności liczą się aktywne i bezczynne sesje z runtime, z wyłączeniem standby. Wyczerpany limit może zablokować narzędzie lub zatrzymać pracę. Dokumentacja wskazuje brak automatycznych opłat za przekroczenie.

Pierwsze uruchomienie agenta przez API

1. Przygotuj klucz API Click i klucz obsługiwanego dostawcy modelu. Tworzenie i zmiana zasobów wymagają według dokumentacji weryfikacji karty, z możliwymi wyjątkami dla istniejących kont. Weryfikacja nie pobiera opłaty i nie uruchamia płatnej subskrypcji.
2. Zapisz klucz modelu przez POST /credentials i zachowaj ID poświadczenia. Klucze przechowuj w backendzie.
3. Wybierz model odpowiedniego dostawcy z GET /models.
4. Utwórz agenta przez POST /agents, określając instrukcje i uprawnienia. Zachowaj latest_version.id, a następnie wywołaj POST /sessions.
5. Wyślij zadanie do POST /sessions/{session_id}/submissions. request_id pozwala przy ponowieniu uzyskać pierwotne zgłoszenie.
6. Poczekaj na done, cancelled lub failed. Odczytaj wskazaną odpowiedź albo przyczynę niepowodzenia.

HTTP 202 potwierdza jedynie zapisanie wejścia. Powiąż sesję z dokumentem lub zgłoszeniem, aby kolejne pytania korzystały z jej historii. Przed zwróceniem danych sprawdzaj uprawnienia użytkownika.

Własne narzędzia, sandbox i pliki wynikowe

Click łączy serwery MCP Streamable HTTP i własne endpointy HTTP dostępne przez publiczny HTTPS. Połączenie wymaga osobnego przyznania narzędzi. Narzędzia HTTP opisują argumenty przez JSON Schema i otrzymują JSON POST; dokumentowany timeout wynosi 120 sekund.

Endpoint może sprawdzać krótkotrwały token ograniczony do danego klienta. Twoja aplikacja nadal odpowiada za uwierzytelnianie, budżety, zatwierdzanie operacji i reguły biznesowe.

Dostępne są wyszukiwanie w sieci, automatyzacja przeglądarki i operacje plikowe lub polecenia w sandboxie. Dokumentacja obejmuje także Blaxel, Daytona i własne dane Browserbase. Warunki i koszty zewnętrznych dostawców wymagają osobnego sprawdzenia.

Przy plikach użyj sandboxa Click: prześlij wejście przez POST /files, wskaż ID w zadaniu i zleć publikację wyniku przez publish_file. Następnie pobierz listę artifacts i plik przez GET /files/{file_id}. Roboczy plik sandboxa nie zastępuje trwałego opublikowanego wyniku; sprawdź jego zawartość.

Strumień postępu i zadania w tle

GET /sessions/{session_id}/events rozpoczyna się pełnym snapshotem, po którym przychodzą zmiany tekstu, narzędzi i statusu. Przy ponownym połączeniu nowy snapshot zastępuje stan lokalny. Rozłączenie nie przerywa pracy; standby zamyka strumień.

Podpisane webhooki submission.updated i artifact.created umożliwiają odbiór wyniku bez stale otwartej strony. Po powiadomieniu odczytaj aktualny stan zasobu, zanim zaktualizujesz dane produktu.

Dane użytkowników oraz uprawnienia aplikacji

Polityka prywatności obejmuje instrukcje, wiadomości, pliki, dane narzędzi i poświadczenia. Treści mogą trafić do dostawców modeli i narzędzi w celu wykonania zadania; mogą obowiązywać ich odrębne polityki.

Pracownicy Click mogą uzyskiwać dostęp do treści przy wdrożeniu, wsparciu, diagnostyce i ulepszaniu usługi. Retencja zależy od uzasadnionych potrzeb, bez jednego stałego terminu. Przetwarzanie może odbywać się w USA i innych krajach. Nie daje to gwarancji polskiej lokalizacji danych, zerowej retencji ani ogólnego zakazu treningu.

Sekrety umieszczaj w ustawieniach poświadczeń, a nie w wiadomościach lub plikach. Polityka wyklucza przesyłanie szczególnie wrażliwych danych regulowanych.

Najczęstsze pytania

Czy Click ma darmowy plan?

Tak, Free ma ograniczone zasoby. Dostawca modelu może naliczać osobne opłaty, a tworzenie zasobów zwykle wymaga weryfikacji karty.

Czy abonament obejmuje koszty modelu?

Udokumentowana ścieżka korzysta z własnych kluczy dostawcy. Uwzględnij koszty modelu osobno i sprawdź aktualny katalog przez GET /models.

Czy agent może używać własnych API i narzędzi?

Tak, przez MCP lub własne narzędzia HTTPS z jawnymi uprawnieniami. Kontrola dostępu klientów i zgody na istotne działania pozostają w aplikacji.

Oficjalne zasoby dla programistów

• Dokumentacja API: narzędzia, zdarzenia, webhooki i pliki.
• Szybki start: konfiguracja pierwszego agenta i sesji.
• Warunki i wsparcie: zasady usługi i oficjalna droga kontaktu.