Łączenie agentów AI z witrynami dokumentacji
Pozwól Claude Code, Codex, ChatGPT lub własnym skryptom tworzyć szkice, organizować i publikować strony witryn dokumentacji. Plany (Pro i wyższe), uprawnienia witryn dokumentacji, zakres witryn i zasady publikowania, wraz z linkami do pełnych przewodników po agentach AI i API.
Agenci AI, tacy jak Claude Code, Codex, Cursor, Claude lub ChatGPT, mogą czytać i edytować Twoje witryny dokumentacji: tworzyć szkice artykułów, poprawiać strony nisko oceniane przez czytelników, uzupełniać luki w treści, tłumaczyć lub publikować. Ten artykuł omawia kwestie specyficzne dla witryn dokumentacji. Tokeny, łączniki, wydatki i błędy zostały wyjaśnione w Agenci AI i API.
Zanim zaczniesz
- Agenci AI i API są dostępne w planach Pro, Biznes i Niestandardowe, w tym łączniki dla Claude i ChatGPT. Plany Free i Starter ich nie obejmują; tokeny i aplikacje przestają działać, jeśli obszar roboczy zostanie przeniesiony do jednego z nich.
- Agent działa jako osoba, która utworzyła jego token lub go połączyła, w ramach roli tej osoby. Nigdy nie może zrobić w witrynie więcej, niż mogłaby zrobić ta osoba.
- Wywołania API nie kosztują kredytów. Tłumaczenie stron i generowanie stron witryny za pomocą AI kosztuje kredyty i jest możliwe tylko przy użyciu tokena, który może je wydawać.
Połącz agenta
Otwórz menu obszaru roboczego i wybierz Agenci AI i API lub wybierz Agenci AI i API w menu Ustawienia witryny dokumentacji (otworzy to aktywność dla tej witryny).
- Token API dla Claude Code, Codex, Cursor lub skryptu: Tokeny → Nowy token, a następnie czterokrokowy kreator (Cel, Uprawnienia, Limity, Przejrzyj). Wybierz ustawienie wstępne witryny dokumentacji, takie jak Autor lub Wydawca, wybierz witryny w sekcji Limity → Witryny dokumentacji i skopiuj token, który jest wyświetlany tylko raz. Zobacz Tworzenie tokena API.
- Łącznik dla Claude.ai lub ChatGPT: wklej URL łącznika z Połączone aplikacje do aplikacji, zaloguj się i wybierz Strony oraz Dostęp. Zobacz Łączenie aplikacji i agentów AI.
Ustawienia wstępne witryn dokumentacji
| Ustawienie wstępne | Opis na ekranie | Dla |
|---|---|---|
| Autor | "Agenci tworzą szkice; osoba sprawdza i publikuje." | Tworzenie szkiców artykułów i wpisów w dzienniku zmian, przesyłanie obrazów |
| Wydawca | "Zaufana automatyzacja, która może zmieniać to, co widzą czytelnicy." | Wszystko dla witryn dokumentacji, w tym publikowanie, ustawienia i tworzenie witryn |
| Asystent wsparcia | "Odpowiedzi z opublikowanej dokumentacji. Nic więcej." | Bot pomocy, który przeszukuje tylko opublikowane, publiczne strony |
| Tylko do odczytu | "Badania, audyty i sprawdzanie tłumaczeń." | Czytanie treści |
| Analityk | "Czyta treść i sygnały od czytelników, aby sugerować poprawki." | Czytanie treści i statystyk |
Producent i Agent obszaru roboczego dodają filmy i wydawanie kredytów. Każde uprawnienie i kto może je przyznać: Uprawnienia agenta.
Uprawnienia witryny dokumentacji
| Uprawnienie | Pozwala na |
|---|---|
content:read |
Czytanie witryn, stron, artykułów (także szkiców), wersji, dziennika zmian i stron witryny |
articles:write |
Tworzenie szkiców artykułów i edycję artykułów, które nie są opublikowane |
structure:write |
Tworzenie i edycję sekcji; przenoszenie, ukrywanie i zmianę nazw stron |
site-pages:write |
Edycję stron witryny, takich jak strona główna, kontakt i prawne |
changelog:write |
Tworzenie i edycję wpisów w dzienniku zmian jako szkiców |
media:write |
Przesyłanie obrazów |
site:publish |
Publikowanie: zmianę tego, co widzą czytelnicy, edycję opublikowanej treści, oznaczanie stron jako gotowe |
insights:read |
Czytanie luk w wyszukiwaniu, pytań bez odpowiedzi i opinii o stronach |
site:configure |
Zmianę ustawień witryny, wyglądu i nawigacji |
sites:create |
Tworzenie nowych witryn dokumentacji |
help:read |
Przeszukiwanie tylko opublikowanych, publicznych stron (dla asystenta wsparcia) |
Czytanie jest dostępne dla każdego członka. Pisanie i organizowanie: właściciel, administratorzy, redaktorzy i Twórcy treści. Publikowanie i ustawienia witryny: właściciel, administratorzy i redaktorzy ("Tylko właściciele, administratorzy i redaktorzy mogą przyznawać uprawnienia do publikowania."). Tworzenie witryn: właściciel i administratorzy.
Które witryny obejmuje token
W sekcji Limity → Witryny dokumentacji wybierz Wszystkie witryny ("Każda witryna dokumentacji w tym obszarze roboczym, w tym nowe.") lub Wybrane witryny. Token lub połączona aplikacja widzi i zmienia tylko te witryny, które obejmuje. Jeśli artykuł pojawia się również w witrynie spoza jego zakresu, zmiana zostanie odrzucona: "Ten artykuł jest również wyświetlany w witrynie, której ten token nie może zmienić."
Opublikowana treść wymaga uprawnień do publikowania
Bez site:publish agent nie może zmienić tego, co widzą czytelnicy. Edycja opublikowanego artykułu zostanie odrzucona ("Ta treść jest opublikowana w witrynie, więc jej zmiana wymaga uprawnienia site:publish"), a agent może zamiast tego przesłać szkic do sprawdzenia. Otrzymasz powiadomienie: "agent poprosił o sprawdzenie strony w witrynie": "Nic nie zostało opublikowane. Przeczytaj artykuł i opublikuj go, gdy będzie gotowy."
Każda zmiana dokonana przez agenta jest widoczna w historii strony jako "Agent nazwa (token)". Publikacje są ograniczone do 10 na godzinę na token. Wstrzymana witryna jest dla agentów tylko do odczytu: "Ta witryna jest wstrzymana lub offline i jest tylko do odczytu."
Co agenci mogą robić w witrynie
Wyświetlać listę witryn i czytać drzewo stron, wyszukiwać i czytać strony, podglądać Markdown, tworzyć i aktualizować artykuły, przesyłać je do sprawdzenia, organizować sekcje i strony, edytować strony witryny i dziennik zmian, przesyłać obrazy, czytać statystyki i oznaczać luki jako uzupełnione, zmieniać ustawienia, wygląd, nawigację i przekierowania, tworzyć witryny, tłumaczyć strony, generować strony witryny, publikować i przywracać wersje. Każde z tych działań wymaga odpowiedniego uprawnienia.