Zrozumienie agentów AI i API
Co agenci AI, tacy jak Claude, ChatGPT, Claude Code, Codex i Cursor, mogą robić w Twoim obszarze roboczym Clevera, sposoby ich łączenia, plany (Pro i wyższe), limity, role, koszty i bezpieczeństwo.
AI agents & API pozwala aplikacjom AI, takim jak Claude, ChatGPT, Claude Code, Codex i Cursor, oraz Twoim własnym skryptom, pracować w Twoim obszarze roboczym Clevera: wyszukiwać nagrania, żądać wideo, klipów społecznościowych i artykułów, eksportować wideo oraz pracować nad witrynami dokumentacji. Sam decydujesz, co dokładnie może robić każdy agent, ile kredytów może wydać i kiedy wymagana jest zgoda użytkownika.
Co mogą robić agenci
| Obszar | Co może robić agent |
|---|---|
| Wideo | Wyświetlanie i odczytywanie Twoich nagrań, wideo, artykułów i transkrypcji; żądanie wideo instruktażowych, demonstracji produktów, wideo po edycji i stylizowanych na podstawie nagrania, klipów społecznościowych, artykułów z nagrania oraz tłumaczeń wideo; eksport plików MP4 do 4K; dodawanie obrazów, wideo i plików PDF do Twoich przesłanych materiałów. |
| Witryny dokumentacji | Odczytywanie, tworzenie wersji roboczych, organizowanie, tłumaczenie i publikowanie stron witryny dokumentacji oraz dziennika zmian, odpowiadanie czytelnikom z opublikowanych stron, odczytywanie statystyk czytelników oraz zmienianie ustawień witryny lub tworzenie witryn. |
Agenci nie potrafią jeszcze przeprowadzać badań stron internetowych ani nagranych instruktaży.
Agent składa zapytanie; własna sztuczna inteligencja Clevera tworzy wideo lub artykuł w ten sam sposób, jak podczas uruchamiania tego procesu w aplikacji. Agent nigdy nie widzi więcej, niż mógłby zobaczyć jego właściciel: nagrania w prywatnej kolekcji pozostają ukryte, chyba że właściciel tokena ma do nich dostęp.
Sposoby łączenia
| Sposób | Dla | Skonfiguruj w |
|---|---|---|
| Token API | Claude Code, Codex CLI, Cursor, dowolny klient MCP oraz Twoje własne skrypty przez REST API | Tokeny → Nowy token. Zobacz Tworzenie tokena API. |
| Połączona aplikacja | Claude (claude.ai) i ChatGPT jako niestandardowy łącznik; brak tokena, logujesz się samodzielnie | Aplikacja, z adresem URL łącznika z Połączone aplikacje. Zobacz Łączenie aplikacji i agentów AI. |
| REST API | Skrypty i usługi backendowe | Token API. Zobacz Korzystanie z REST API. |
Serwer MCP znajduje się pod https://app.clevera.ai/mcp, a REST API pod https://app.clevera.ai/api/v1.
Znajdowanie strony
Otwórz menu obszaru roboczego i wybierz AI agents & API. W witrynach dokumentacji znajduje się to również na stronie głównej dokumentacji oraz w menu Ustawienia witryny. Strona („Pozwól Claude, Codex, ChatGPT i swoim skryptom pracować w tym obszarze roboczym.”) posiada pięć kart, każda z licznikiem:
| Karta | Co się tam znajduje |
|---|---|
| Tokeny | Twoje tokeny API; właściciele i administratorzy widzą każdy token. Zarządzaj tokenami API |
| Połączone aplikacje | Adres URL łącznika oraz aplikacje połączone przez użytkowników. Łączenie aplikacji i agentów AI |
| Żądania agenta | Płatna praca oczekująca na zatwierdzenie przez użytkownika, z plakietką liczbową oraz historią. Kontrola wydatków i zatwierdzeń agenta |
| Webhooki | Podpisane powiadomienia dla Twoich własnych systemów. Konfiguracja webhooków |
| Aktywność | Co zrobili agenci. Odczytywanie aktywności agenta |
Plany
AI agents & API jest dostępne w planach Pro, Biznes i Niestandardowe. Obejmuje to tokeny API, łączniki dla Claude i ChatGPT oraz webhooki.
W planach Free i Starter strona wyświetla komunikat „AI agents & API są zawarte w planie Pro”: „Przejdź na Pro, aby pozwolić Claude, ChatGPT i swoim skryptom pracować w tym obszarze roboczym. Istniejące tokeny i aplikacje przestaną działać do tego czasu; nadal możesz je tutaj unieważnić.” Kliknij Przejdź na Pro. Zablokowane elementy sterujące informują: „Dostęp do API i agentów jest dostępny w planie Pro i wyższych”, „Łączniki Claude.ai i ChatGPT są dostępne w planie Pro i wyższych” lub „Webhooki są dostępne w planie Pro i wyższych”.
| Limit | Pro, Biznes, Niestandardowe |
|---|---|
| Aktywne tokeny API na obszar roboczy | 50 |
| Połączone aplikacje na osobę | 20 |
| Webhooki na obszar roboczy | 10 |
| Zatwierdzaj automatycznie poniżej maksymalnie | Pro i Biznes: 500 kredytów. Niestandardowe: 1000 kredytów. |
Jeśli obszar roboczy opuści plan Pro
Nic nie jest usuwane, ale wszystko zostaje wstrzymane do momentu ponownego przejścia na wyższy plan:
| Po przejściu na Starter lub Free | |
|---|---|
| Tokeny API | Pozostają na liście i można je unieważnić. Każde wywołanie jest odrzucane: „API agenta nie jest dostępne w planie tego obszaru roboczego. Jest dostępne w planie Pro i wyższych.” Nie można ich wygenerować ponownie (Wygeneruj ponownie klucz otwiera okno dialogowe aktualizacji). |
| Połączone aplikacje | Pozostają na liście i można je odłączyć. Ich wywołania kończą się niepowodzeniem; Claude lub ChatGPT mogą jedynie poinformować, że nie udało się połączyć. |
| Webhooki | Pozostają na liście, ale nic nie jest wysyłane. Wyślij zdarzenie testowe i Ponów dostarczenie informują: „Webhooki nie są dostępne w Twoim planie.” |
| Żądania agenta | Zatwierdź informuje: „Dostęp do API i agentów nie jest dostępny w Twoim planie.” Odrzuć nadal działa. |
| Nowe tokeny | „Dostęp do API i agentów nie jest dostępny w Twoim planie.” |
Powrót do planu Pro sprawia, że tokeny, aplikacje i webhooki znów działają. Tokeny nadal wygasają w swoich pierwotnych terminach.
Kto może co robić
Agent działa jako osoba, która utworzyła jego token lub go połączyła, w ramach uprawnień wynikających z roli tej osoby. Nigdy nie może zrobić więcej, niż ta osoba mogłaby zrobić w aplikacji, a rola jest sprawdzana przy każdym wywołaniu, więc zmiana roli wchodzi w życie natychmiast.
| Zadanie | Właściciel | Administrator | Redaktor | Twórca treści |
|---|---|---|---|---|
| Tworzenie tokenów i łączenie aplikacji dla siebie | Tak | Tak | Tak | Tak |
| Wyświetlanie i unieważnianie każdego tokena i aplikacji w obszarze roboczym | Tak | Tak | Tylko własne | Tylko własne |
| Nadanie agentowi uprawnień do żądania wideo i wydawania kredytów | Tak | Tak | Nie | Tak |
| Nadanie agentowi uprawnień do publikowania witryn dokumentacji | Tak | Tak | Tak | Nie |
| Zatwierdzanie płatnej pracy, o którą proszą agenci | Tak | Tak | Nie | Nie |
| Zarządzanie webhookami | Tak | Tak | Nie | Nie |
Pełna lista znajduje się w Uprawnienia agenta.
Ile to kosztuje
- Wywołania API i MCP są bezpłatne: odczytywanie, wyszukiwanie, cytowanie i sprawdzanie zadania nie kosztują kredytów. Podobnie jest z eksportem wideo.
- Praca wykorzystująca AI kosztuje kredyty, tak samo jak podczas uruchamiania jej w aplikacji: wideo, klipy społecznościowe, artykuły z nagrań, tłumaczenia i strony witryny wygenerowane przez AI.
- Agent może rozpocząć płatną pracę tylko za pomocą tokena, który posiada
credits:spend. Każde rozpoczęcie jest najpierw wyceniane i sprawdzane pod kątem limitów wydatków tokena, a użytkownik zatwierdza je, chyba że znajduje się ono poniżej linii Zatwierdzaj automatycznie poniżej dla danego tokena. Zobacz Kontrola wydatków i zatwierdzeń agenta.
Jak Clevera dba o bezpieczeństwo agentów
- Tokeny zawsze wygasają: po 7 dniach, 30 dniach, 90 dniach lub 1 roku. Nie ma opcji „nigdy”.
- Klucze są wyświetlane tylko raz. Clevera przechowuje tylko odcisk palca i pokazuje ostatnie cztery znaki.
- Minimalny dostęp. Każdy token posiada tylko te uprawnienia, witryny dokumentacji i adresy IP, które wybierzesz.
- Ludzie zatwierdzają wydatki. Agent nie może zatwierdzić własnych wydatków; może to zrobić tylko właściciel obszaru roboczego lub administrator.
- Wyciekłe tokeny są unieważniane. Token Clevera znaleziony w publicznym repozytorium GitHub jest automatycznie unieważniany.
- Nietypowa aktywność jest zatrzymywana. Serie odrzuconych wywołań powodują unieważnienie tokena; serie zmian lub wydatków wstrzymują go, a właściciel otrzymuje powiadomienie.
- Wszystko jest rejestrowane w aktywność, przechowywane przez 13 miesięcy. Edycje witryny dokumentacji przez agenta są również widoczne w historii strony jako „Agent nazwa (token)”.