add-announcement

Skill umożliwia dodawanie kart ogłoszeń do systemu banerów paska bocznego Agenty. Zarządzaj wpisami dziennika zmian, ogłoszeniami o nowych funkcjach, aktualizacjach i promocyjnych banerach bez konieczności ręcznego edytowania kodu. System automatycznie obsługuje kolejkowanie banerów – tylko jeden wyświetla się jednocześnie, a po zamknięciu przez użytkownika pojawia się następny. Każde ogłoszenie można łatwo odwołać, a użytkownicy mogą je trwale ukryć za pomocą localStorage.

1. Otwórz plik web/oss/src/components/SidebarBanners/data/changelog.json w repozytorium Agenty. To główne miejsce, gdzie przechowywane są wszystkie ogłoszenia dla większości przypadków użycia.

2. Dodaj nowy obiekt JSON do tablicy w pliku. Każde ogłoszenie musi zawierać cztery pola: id (unikalny identyfikator), title (tytuł ogłoszenia), description (krótki opis) i link (adres URL do dokumentacji).

3. Wygeneruj unikalny identyfikator, stosując konwencję: changelog- + data w formacie YYYY-MM-DD + nazwa funkcji (slug). Na przykład: changelog-2026-01-09-chat-sessions. Identyfikator musi być unikalny, aby uniknąć konfliktów z istniejącymi ogłoszeniami.

4. Wpisz tytuł ogłoszenia – maksymalnie 40 znaków, jasny i skupiony na korzyści dla użytkownika. Przykłady: "Chat Sessions in Observability" lub "PDF Support in Playground".

5. Napisz opis w jednym zdaniu, poniżej 100 znaków. Opisz, co użytkownik może teraz robić, nie wchodź w szczegóły techniczne. Na przykład: "Track multi-turn conversations with session grouping and cost analytics."

6. Dodaj link do dokumentacji w formacie https://agenta.ai/docs/changelog/[nazwa-funkcji]. System automatycznie wyświetli ogłoszenie w pasku bocznym, zarządzając priorytetami i zapamiętując, które ogłoszenia użytkownik już zamknął.