[Intum Pomoc](https://intum.pl/pomoc.md) / [AI w bazie wiedzy](https://intum.pl/pomoc/baza-wiedzy/ai-w-bazie-wiedzy.md)

# [Pisanie wpisów z AI](https://intum.pl/pomoc/baza-wiedzy/pisanie-wpisow-z-ai.md)

Najtrudniejszy w bazie wiedzy jest pierwszy szkic. Zespół wie, jak coś działa, ale nikt nie ma
czasu tego opisać. AI zamienia notatki, listę kroków albo wklejoną odpowiedź z maila
w uporządkowany artykuł z nagłówkami. Ty sprawdzasz treść i poprawiasz szczegóły.

> [!PATH]
> [Baza wiedzy → Wpisy](app:/kb/entries)

## Szkic wpisu z notatek

Na formatce wpisu, przy edytorze **Zawartość**, jest przycisk AI. Opisz temat albo wklej luźne
notatki, a AI wstawi do edytora gotową treść: krótki wstęp, sekcje z nagłówkami, listy i kroki.
Przy okazji poprawi literówki w tym, co wkleisz.

Traktuj wynik jak szkic napisany przez nowego kolegę. Struktura zwykle jest dobra, ale nazwy
przycisków, ścieżki w menu i liczby sprawdź na żywym ekranie, bo AI zna tylko to, co mu podasz.

## Poprawki i nowe wpisy jednym zdaniem

Przycisk **Edycja z AI** jest na karcie wpisu i na liście wpisów. Otwiera okno, w którym piszesz
polecenie zwykłym zdaniem. AI wie, w jakim wpisie, bazie i kategorii jesteś, więc nie musisz
tego podawać. Przykłady:

- „Popraw treść wpisu i dodaj sekcję o zmianie hasła",
- „Przetłumacz wpis na angielski i dodaj jako nowy",
- „Dodaj helplink do tego wpisu",
- „Dodaj 3 nowe wpisy w tej samej kategorii o eksporcie danych".

Na liście wpisów polecenie dotyczy całej bazy, więc to wygodne miejsce na kilka artykułów naraz,
np. szkielet nowej kategorii.

## Wpis w rozmowie z Claude albo ChatGPT

Na karcie wpisu są przyciski **Kopiuj stronę**, **Otwórz w Claude** i **Otwórz w ChatGPT**.
Treść wpisu trafia wtedy do rozmowy z asystentem. Przydaje się, gdy chcesz ją przerobić na
maila, post albo skrót dla klienta.

Część szablonów strony publicznej ma takie samo menu **AI** przy każdym wpisie, więc również
czytelnicy mogą wziąć artykuł do swojego asystenta. Osoby z dostępem do modułu Baza wiedzy widzą w tym
menu dodatkowo **Edytuj**.

## Dokumentacja API obok treści

Pole **Dokumentacja API** we wpisie jest miejscem na opis techniczny: metodę, parametry
i odpowiedź. Główna treść zostaje wtedy tekstem dla ludzi, a programista albo agent AI dostaje
w menu wpisu na stronie publicznej osobny widok **API**. Pole wypełniasz tylko przy wpisach,
które opisują integrację. Gdy treść wpisu jest już opisem technicznym, wpisz w polu samo `true` -
widok API pokaże zwykłą treść.

Widok **API** całej bazy pokazuje w menu i na listach tylko kategorie, w których są wpisy
z dokumentacją API - reszta bazy w nim znika.

## Czego pilnować

- **Fakty sprawdza człowiek.** AI dobrze układa treść, ale nie widzi Twojego systemu. Wpis
  z błędną nazwą przycisku jest gorszy niż brak wpisu,
- **Jeden styl w całej bazie.** Gdy wpisy powstają z AI, łatwo o mieszankę „kliknij" i „należy
  kliknąć". Zasady pisania zebrane w [Jak pisać wpisy](baza-wiedzy/jak-pisac-wpisy-bazy-wiedzy)
  możesz wkleić do polecenia,
- **Szkic zamiast publikacji.** Wpisy tworzone hurtem zapisuj jako prywatne i publikuj dopiero
  po przeczytaniu.