Wybierz uprawnienia dla agenta AI
Każde uprawnienie, które może posiadać token API lub połączona aplikacja, co ono umożliwia, który zestaw wstępny je zawiera oraz które role (właściciel, administrator, edytor, twórca treści) mogą je przyznać.
Każdy token API i połączona aplikacja posiada zestaw uprawnień (możliwości), które decydują o tym, co agent może robić w Twoim obszarze roboczym. Ten artykuł zawiera listę wszystkich uprawnień, wyjaśnia, co umożliwiają, który zestaw wstępny je zawiera oraz które role mogą je przyznać.
Jak działają uprawnienia
- Agent działa jako osoba, która utworzyła token, w ramach uprawnień przysługujących tej osobie. Nigdy nie może zrobić więcej niż jego właściciel w aplikacji i widzi tylko te nagrania, filmy oraz kolekcje, które może widzieć jego właściciel.
- Twoja rola decyduje o tym, co możesz przyznać. W kreatorze tokenów i na ekranie łączenia uprawnienie, którego Twoja rola nie może przyznać, jest wyszarzone z komunikatem „Twoja rola nie może tego przyznać.” (lub „Tylko właściciele, administratorzy i edytorzy mogą przyznać uprawnienia do publikowania.” w przypadku publikacji). Zestaw wstępny zawierający takie uprawnienie jest wyszarzony z komunikatem „Twoja rola nie może przyznać wszystkich możliwości w tym zestawie.”
- Rola jest sprawdzana przy każdym wywołaniu, a nie tylko podczas tworzenia tokena. Jeśli rola właściciela zmieni się później, wywołania wymagające uprawnienia, którego nowa rola nie pozwala, są odrzucane, a token wyświetla Przekracza uprawnienia roli na liście tokenów: „Rola właściciela uległa zmianie. Wywołania wymagające przekreślonych możliwości są odrzucane.”
- Każde uprawnienie ma swój rodzaj, wyświetlany jako plakietka w kreatorze: Odczytano, Edytuj, Opublikuj, Zarządzaj lub Wydaje kredyty.
- Agent widzi tylko te narzędzia (MCP) i punkty końcowe (REST), na które pozwalają jego uprawnienia. Wywołanie narzędzia, którego nie posiada, zwraca błąd „Ten token nie posiada możliwości ….”
Zestawy wstępne
Pierwszy krok kreatora tokenów (Do czego to służy?) oferuje zestawy wstępne. Wybranie jednego z nich zaznacza jego uprawnienia; możesz zmienić dowolne z nich w następnym kroku, a kreator wyświetli wtedy Dostosowane wraz z opcją Resetuj do zestawu wstępnego.
| Zestaw wstępny | Opis na ekranie | Uprawnienia |
|---|---|---|
| Autor | „Agenci tworzą szkice; osoba sprawdza i publikuje.” | content:read, articles:write, changelog:write, media:write |
| Wydawca | „Zaufana automatyzacja, która może zmieniać to, co widzą czytelnicy.” | Wszystkie uprawnienia witryny dokumentacji z wyjątkiem help:read i insights:read |
| Asystent wsparcia | „Odpowiedzi z opublikowanych dokumentów. Nic więcej.” | help:read |
| Tylko do odczytu | „Badania, audyty i sprawdzanie tłumaczeń.” | content:read |
| Analityk | „Czyta treść i sygnały od czytelników, aby sugerować poprawki.” | content:read, insights:read |
| Producent | „Tworzy szkice treści i rozpoczyna płatne prace w ramach limitów wydatków.” | Autor, plus site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Agent obszaru roboczego | „Wszystko, co agent może zrobić w tym obszarze roboczym, w ramach limitów wydatków.” | Wszystkie uprawnienia z wyjątkiem help:read |
Producent i Agent obszaru roboczego zawierają credits:spend, więc kreator prosi o podanie limitów wydatków w kroku Limity. Zobacz Kontrola wydatków i zatwierdzeń agenta.
Zestawy wstępne Autor, Wydawca, Asystent wsparcia, Tylko do odczytu oraz Analityk są przeznaczone dla witryn dokumentacji.
Uprawnienia do filmów
| Uprawnienie | Rodzaj | Co umożliwia |
|---|---|---|
library:read |
Odczytano | „Odczyt nagrań, filmów, artykułów i transkrypcji, które właściciel może widzieć”: wyświetlanie biblioteki i nagrań, odczyt elementu, jego transkrypcji i artykułu oraz pobranie kodu osadzenia. |
videos:create |
Edytuj | „Cytowanie i żądanie filmów, artykułów z nagrań oraz tłumaczeń”: prośba o wycenę i żądanie filmów instruktażowych, demonstracji produktów, czyszczenia i stylizowanych filmów z nagrania, klipów społecznościowych, artykułów z nagrania oraz tłumaczeń filmów. Rozpoczęcie płatnej pracy wymaga również credits:spend. |
videos:export |
Edytuj | „Eksportowanie filmów i pobieranie kodów osadzenia”: renderowanie MP4 w 1080p (domyślnie), 2K lub 4K, zawsze 60 kl./s oraz uzyskanie linku do pobrania. Eksporty nie kosztują kredytów. |
materials:write |
Edytuj | „Dodawanie obrazów, filmów i plików PDF do przesłanych plików obszaru roboczego używanych do nowych filmów”. |
Uprawnienia obszaru roboczego
| Uprawnienie | Rodzaj | Co umożliwia |
|---|---|---|
credits:spend |
Wydaje kredyty | „Wydawanie kredytów na wycenione prace, w ramach limitów tokena”. To drugi klucz, którego wymaga każde rozpoczęcie płatnej pracy, obok uprawnienia do danej pracy (na przykład videos:create). |
jobs:read |
Odczytano | „Widoczność zadań rozpoczętych przez inne tokeny właściciela”. Token zawsze widzi własne zadania; to uprawnienie dodaje zadania innych tokenów właściciela. Pozwala również agentowi anulować zadanie i odczytać saldo kredytów obszaru roboczego. |
Uprawnienia do dokumentacji
Dotyczą one witryn dokumentacji. W sekcji Limity → Witryny dokumentacji, token obejmuje Wszystkie witryny („Każda witryna dokumentacji w tym obszarze roboczym, w tym nowe.”) lub Wybrane witryny.
| Uprawnienie | Rodzaj | Co umożliwia |
|---|---|---|
content:read |
Odczytano | „Odczyt witryn, stron, artykułów (również szkiców), wersji, dziennika zmian i stron witryny”. Także ustawień witryny, wyglądu, nawigacji i przekierowań. |
articles:write |
Edytuj | „Tworzenie szkiców artykułów i edycja artykułów, które nie są opublikowane”. Tłumaczenie artykułu (płatne) wymaga również credits:spend. |
structure:write |
Edytuj | „Tworzenie i edycja sekcji, przenoszenie, ukrywanie i zmienianie nazw stron”. |
site-pages:write |
Edytuj | „Edycja stron witryny, takich jak strona główna, kontakt i prawne”. Generowanie lub tłumaczenie strony witryny za pomocą AI (płatne) wymaga również credits:spend. |
changelog:write |
Edytuj | „Tworzenie i edycja wpisów dziennika zmian jako szkiców”. |
media:write |
Edytuj | „Przesyłanie obrazów”. |
site:publish |
Opublikuj | „Publikowanie: zmiana tego, co widzą czytelnicy, edycja opublikowanej treści, oznaczanie stron jako gotowe”. Także publikowanie i usuwanie wpisów dziennika zmian oraz przywracanie poprzedniej wersji witryny. |
insights:read |
Odczytano | „Odczyt statystyk witryny: luki w wyszukiwaniu, pytania bez odpowiedzi i opinie o stronach”. Z articles:write może również oznaczyć lukę jako uzupełnioną. |
site:configure |
Zarządzaj | „Zmiana ustawień witryny, wyglądu i nawigacji” oraz dodawanie przekierowań. |
sites:create |
Zarządzaj | „Tworzenie nowych witryn dokumentacji”. |
help:read |
Odczytano | „Wyszukiwanie tylko opublikowanych, publicznych stron (asystent wsparcia)”. Token posiadający tylko to uprawnienie nie widzi niczego innego. |
Kto może co przyznać
| Uprawnienie | Właściciel | Administrator | Edytor | Twórca treści |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Tak | Tak | Tak | Tak |
library:read |
Tak | Tak | Tak | Tak |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Tak | Tak | Tak | Tak |
videos:export |
Tak | Tak | Tak | Tak |
videos:create, materials:write, credits:spend |
Tak | Tak | Nie | Tak |
site:publish, site:configure |
Tak | Tak | Tak | Nie |
sites:create |
Tak | Tak | Nie | Nie |
Twórca treści może nadać tokenowi credits:spend, ale płatna praca wymagająca zatwierdzenia jest zawsze zatwierdzana przez właściciela obszaru roboczego lub administratora, nigdy przez samego właściciela tokena. Zobacz Kontrola wydatków i zatwierdzeń agenta.
Niedostępne jeszcze dla agentów
Agenci nie mogą jeszcze przeprowadzać badań witryn internetowych, nagranych instruktaży ani publikować filmów na innych platformach. Tych uprawnień nie można przyznać.