Przewodnik właściciela

W konfiguracji edytujesz trzy pola z pełną treścią plików YAML. Nie trzeba korzystać z terminala ani przesyłać plików. Zacznij od zmiany istniejących tekstów; zachowuj nazwy pól i wcięcia.

Jak zapisać zmiany

Zmień treść wybranego pola; pozostałe pozostaw bez zmian.
Kliknij Zapisz konfigurację. Aplikacja sprawdzi wszystkie trzy pliki razem.
Poczekaj na zielony komunikat potwierdzający zapis. Następne uruchomienie aplikacji użyje nowej konfiguracji; już istniejące szkice nie zmienią się.

Przy błędzie tekst pozostanie w formularzu. Popraw wskazany plik i pole, a następnie zapisz ponownie. Jeśli ktoś zapisał nowszą wersję, najpierw skopiuj swoje zmiany, wczytaj aktualną konfigurację i nanieś je ponownie. Nie odświeżaj strony przed skopiowaniem niezapisanych zmian.

Po zapisie możesz wybrać Przywróć poprzednią wersję. Osobny ekran poprosi o potwierdzenie. Przywracane są wszystkie trzy pliki; bieżąca wersja też zostaje zachowana.

Podstawy YAML

Wcięcia twórz spacjami, nie tabulatorem. W przykładach używamy dwóch spacji na poziom.
Po nazwie pola umieść dwukropek i spację. Nie powtarzaj tej samej nazwy w jednej sekcji.
Długi tekst zaczynaj od |-, a każdy kolejny wiersz wcinaj o dwie spacje więcej niż nazwę pola.
Daty i kwoty zapisuj w cudzysłowie. Nie zmieniaj nazw spraw, gdy poprawiasz tylko treść.
Komentarz zaczyna się od #. Jest wskazówką dla osoby edytującej; nie trafia do klienta.
Pusta kolekcja to {}. Całkowicie pusty plik nie jest poprawną konfiguracją.
Nie wklejaj haseł, kluczy API ani danych konkretnych klientów.

Kancelaria

Poniżej fikcyjny przykład do zastąpienia własnymi danymi:

nazwa: 'Kancelaria Przykładowa — dane fikcyjne'
email: kancelaria@example.invalid
podpis: |-
  Kancelaria Przykładowa — dane fikcyjne
  ul. Wymyślona 10, Miasto Przykładowe
styl: 'Odpowiadaj uprzejmie, krótko i wyłącznie na zadane pytania.'
powitanie: 'Dzień dobry,'
zakonczenie: 'Z poważaniem,'
kontakt:
  adres: 'ul. Wymyślona 10, Miasto Przykładowe — dane fikcyjne'
  www: 'https://example.invalid/'
godziny_pracy: 'PRZYKŁAD FIKCYJNY: Pracujemy od poniedziałku do piątku, 9:00–17:00.'
wykluczenia: [reklamacja, skarga]
obsluga_reczna: [spór, przymus]

Opcjonalne redakcja i brzmienie w kancelaria.yaml ustawiają sposób redagowania odpowiedzi. Szczegóły i wartości: redakcja mieszana. Bez tych ustawień działa dotychczasowy tryb dosłowny.

Opcjonalne dopasowanie: ai włącza semantyczny wybór spraw z obsługą niepewności; domyślne slowa zachowuje dopasowanie słowne. Zobacz dopasowanie AI.

Wymagane są nazwa, email, podpis, styl, powitanie, zakonczenie. Pozostałe pola są opcjonalne:

jezyk: domyślnie pl. Aplikacja nie tłumaczy gotowych tekstów.
strefa_czasowa: domyślnie Europe/Warsaw; określa dzień ważności treści i cen.
kontakt: opcjonalne telefon, adres, www. Dane kontaktowe nie są automatycznie przepisywane do podpisu lub spraw.
godziny_pracy: gotowy tekst odpowiedzi na pytania o godziny. Aplikacja tworzy dla niego sprawę godziny i typowe słowa rozpoznawania. Jeżeli potrzebujesz własnych słów lub dat ważności, pomiń to pole i utwórz sprawę godziny w kolejnym pliku. Nie definiuj obu naraz.
wykluczenia i obsluga_reczna: listy słów kierujących wiadomość do pracownika bez szkicu, z różnymi powodami wewnętrznymi. Domyślnie są puste. Sprawdzane są przed wyborem spraw.

email oznacza nadawcę szkicu, a nie login/hasło IMAP. Ustawienie skrzynki pozostaje zadaniem administratora.

Sprawy

Każda sekcja zaczyna się od krótkiej nazwy sprawy. Przykład redakcyjny do zatwierdzenia:

darowizna:
  rozpoznaj: [darowizna, darowizny, darowiźnie]
  zapytaj: |-
    Prosimy o wskazanie przedmiotu darowizny,
    jeśli nie został jeszcze opisany w wiadomości.

Pole	Zasada
`redakcja`	Opcjonalnie `doslowna` lub `mieszana`; nadpisuje domyślny tryb kancelarii dla odpowiedzi i pytania.
`brzmienie`	Opcjonalne ustawienia tonu, długości i formy; nadpisują wskazane opcje globalne.
`opis`	Opcjonalny opis sprawy dla AI, najwyżej 1000 znaków. W trybie AI wymagany, jeśli brak przykładowych słów.
`rozpoznaj`	W trybie `slowa` obowiązkowa niepusta lista z wariantami odmiany. W trybie `ai` opcjonalne przykłady, jeśli podano opis; model rozpoznaje znaczenie.
`odpowiedz`	Opcjonalny gotowy blok informacji. W trybie dosłownym AI wybiera go bez zmian; w mieszanym może redagować na jego podstawie.
`zapytaj`	Opcjonalny gotowy blok pytania o brakujące informacje.
`od`, `do`	Opcjonalne daty w cudzysłowie `'RRRR-MM-DD'`. Obie granice są wliczane; odnoszą się do odpowiedzi i pytania.
`zastepuje`	Opcjonalna lista innych spraw, które ta szczegółowa sprawa ma wyłączyć po dopasowaniu. Bez cykli i odwołań do siebie.

Możesz mieć odpowiedź, pytanie albo oba bloki. Sprawa z samym rozpoznaj może służyć do wyboru cen. Daty przy sprawie bez tekstów są błędem. Pusty plik spraw zapisuj jako {}.

Jedna sprawa ma najwyżej jedną odpowiedź i jedno pytanie, ale każde może być wielowierszowe. Jeśli treści mają różne warunki rozpoznawania lub okresy ważności, utwórz osobne sprawy. Nie wpisuj kwot i zasad odpłatności do zwykłych odpowiedzi.

zastepuje działa na bezpośrednio wymienione nazwy, nie na cały łańcuch powiązań. Nie wyłączaj ogólnej sprawy koszty, jeśli sprawa szczegółowa nie ma treści odpowiadającej na pytanie o cenę. Używaj tego pola tylko przy rzeczywistym nakładaniu się tematów.

Cennik

Dopóki ceny nie są zatwierdzone, cały plik zawiera:

{}

Aby dodać ceny, zastąp {} sekcją o nazwie istniejącej sprawy. Poniższa kwota, warunki i daty są fikcyjne, nie są propozycją stawki notarialnej:

darowizna:
  przykladowa_usluga:
    kwota: '123.00'
    waluta: PLN
    opis: 'PRZYKŁAD FIKCYJNY: Cena usługi przykładowej: {kwota} {waluta}.'
    warunki: 'PRZYKŁAD FIKCYJNY: Kwota brutto za usługę przykładową, bez opłat zewnętrznych; zakres wymaga potwierdzenia.'
    od: '2026-01-01'
    do: '2026-12-31'

kwota musi być tekstem w cudzysłowie, z kropką i najwyżej dwoma miejscami dziesiętnymi; waluta to trzy wielkie litery.
opis przy kwocie jest opcjonalny; domyślnie: Cena: {kwota} {waluta}.. Własny opis musi zawierać oba znaczniki dokładnie po jednym razie.
warunki, od, do są zawsze obowiązkowe. Wpisz rzeczywisty zakres, warunki i okres obowiązywania, nie datę pobrania informacji ze strony.
Aby przekazać regułę zamiast konkretnej kwoty, wpisz opis, warunki, od, do i pomiń oba pola kwota i waluta.
Każda sprawa może mieć kilka nazwanych pozycji cenowych. Powiązanie wynika z nazwy sekcji; nie podajesz topics.

Warunki będą zawsze dołączone do odpowiedzi. Aplikacja nie oblicza sum ani podatków i nie potwierdza spełnienia warunków przez klienta. Cena jest dostępna tylko wtedy, gdy pasuje sprawa i data. Nieznana nazwa sprawy jest błędem konfiguracji.

Co sprawdzić po zmianie

Sprawdź kolejny szkic w programie pocztowym: czy odpowiedź odpowiada na pytanie, nie zawiera niezatwierdzonych informacji i ma prawidłowy podpis. Każda odpowiedź pozostaje szkicem do sprawdzenia przez pracownika.

Przykłady na tej stronie służą tylko nauce składni. Nie są zatwierdzonymi informacjami o kancelarii ani stawkami. Nie kopiuj ich do produkcji bez sprawdzenia treści.