Zaprojektuj szablony PDF | Centrum pomocy AI Engine

Buduj wielokrotnego użytku układy PDF, które użytkownicy generują z rekordu przyciskiem PDF — typy sekcji, układ, podgląd i aktywacja.

Szablon PDF to wielokrotnego użytku układ dokumentu, np. jednostronicowe podsumowanie konta albo brief szansy sprzedaży (Opportunity). Użytkownicy generują go z rekordu przyciskiem 📄 PDF w Sales Agent, a szablon jest uruchamiany dla tego rekordu. Ten artykuł jest przeznaczony dla administratorów i opisuje budowanie szablonów w zakładce PDF Templates. Jak użytkownicy generują i udostępniają pliki PDF, opisuje Dokumenty PDF.

Zanim zaczniesz#

Potrzebujesz permission setu AI_Engine_Admin. Użytkownicy, którzy generują pliki PDF, potrzebują AI_Engine_User.
Wygląd plików PDF z szablonów (kolory, logo, czcionka, stopka) pochodzi z ustawień PDF, a nie z szablonu.

Tworzenie szablonu#

Otwórz zakładkę Ai Agent Admin Setup z App Launchera i kliknij 📋 PDF Templates.
Kliknij + New (lub ✨ Create New Template, gdy żaden szablon nie jest otwarty). Nowy szablon startuje jako „New Template” dla Account.
Wpisz Template name.
Wpisz nazwę API obiektu docelowego, np. Account, Lead, Opportunity albo obiekt niestandardowy, taki jak Project__c. Zrób to przed dodaniem sekcji: czat i panel 🔍 Fields działają na podstawie tego obiektu.
Dodaj sekcje, jak opisano w następnej części.
Ułóż układ (kolejność, dwie kolumny, tytuły).
Kliknij 👁 Preview, aby przetestować szablon na prawdziwym rekordzie.
Sprawdź, czy Active jest włączone (w nowym szablonie jest włączone), i kliknij ✓ Save.

Nic nie jest zapisywane, dopóki nie klikniesz ✓ Save. Zamknięcie szablonu przyciskiem ✕ odrzuca niezapisane zmiany.

Projektant ma trzy kolumny: listę Twoich szablonów, czat do budowania szablonu oraz podgląd strony z panelem 🔍 Fields.

Dodawanie sekcji#

Sekcje można dodać na trzy sposoby:

Opisz ją w czacie. Na przykład: „dodaj sekcję kluczowych pól z branżą, właścicielem i rocznym przychodem” albo „dodaj tabelę otwartych szans sprzedaży”. Projektant buduje lub zmienia sekcje na podstawie Twojego opisu. Aby skierować prośbę do jednej sekcji, najpierw ją kliknij. Czat i tak zwraca cały szablon, więc sprawdź potem pozostałe sekcje.
Przeciągnij pola. Otwórz 🔍 Fields i przeciągnij pole na obszar Drop field here to add new section na dole strony. Pole obiektu docelowego tworzy sekcję kluczowych pól z tym polem. Pole obiektu powiązanego tworzy tabelę rekordów powiązanych.
Dodaj ręcznie. Kliknij + Add Section manually i wybierz typ. Ręcznie dodane sekcje Data Table i Key Fields startują bez zapytania i nic nie drukują, dopóki nie opiszesz ich w czacie.

Panel 🔍 Fields ładuje pola obiektu docelowego przy pierwszym otwarciu. Jeśli zmienisz obiekt albo chcesz pracować nad szablonem dla innego obiektu, zapisz, zamknij szablon przyciskiem ✕ i otwórz go ponownie, aby panel się przeładował.

Typy sekcji#

Typ	Pokazuje	Uwagi
Key Fields	Nazwy i wartości pól rekordu	Buduj i zmieniaj ją w czacie. W PDF każda wartość jest opisana nazwą API pola (bez `__c`, podkreślenia wyświetlane jako spacje), a nie etykietą pola. Puste wartości i pola Id są pomijane
Data Table	Listę rekordów powiązanych	Tabele utworzone przez przeciągnięcie pola powiązanego pokazują do 10 rekordów. W PDF tabela pokazuje najwyżej trzy kolumny, z typowymi polami, takimi jak Name, Stage, Amount czy Close Date, na początku
AI Generated Text	Akapit, który AI pisze na podstawie promptu sekcji	Zobacz niżej
Static Text	Stały tekst, np. wstęp lub zastrzeżenie	Wpisz tekst bezpośrednio na stronie. Pole tekstowe jest widoczne w sekcjach o pełnej szerokości

Użyj 👁 Preview, aby sprawdzić, co dokładnie drukuje sekcja Key Fields lub Data Table.

Tekst generowany przez AI#

Sekcja tekstu AI jest pisana na podstawie swojego promptu i nazwy rekordu. Nie odczytuje innych pól rekordu. Ręcznie dodana sekcja tekstu AI startuje z promptem „Write a concise summary of this record.” Aby zmienić prompt, kliknij sekcję i opisz nowy prompt w czacie.

Pisz prompt tak, aby był samodzielny, a fakty o rekordzie, których potrzebuje czytelnik, umieść obok w sekcji Key Fields lub Data Table. Każda sekcja tekstu AI to jedno żądanie AI przy każdym generowaniu pliku PDF.

Układ#

Zakończ zmiany w czacie, zanim zajmiesz się układem, i sprawdź układ ponownie po każdej późniejszej prośbie w czacie, ponieważ czat zwraca cały szablon.

Kolejność: przeciągnij sekcję za uchwyt ⠿ albo użyj ↑ i ↓.
Dwie kolumny: kliknij ⬛ na sekcji, aby połączyć ją w parę z następną sekcją (lub z poprzednią, jeśli to ostatnia sekcja). Dwie sekcje o połowie szerokości są umieszczane obok siebie. Kliknij ⬜ na dowolnej z nich, aby obie znów miały pełną szerokość.
Tytuł: edytuj tytuł w polu pod sekcją o pełnej szerokości. Aby zmienić nazwę sekcji o połowie szerokości, przywróć jej pełną szerokość, zmień nazwę, a następnie połącz ją ponownie w parę.
Usuwanie: kliknij ✕ na sekcji.

Podgląd#

Kliknij 👁 Preview. Szablon musi mieć co najmniej jedną sekcję.
Wpisz co najmniej dwa znaki nazwy rekordu i wybierz rekord.
Kliknij Open PDF in new tab, aby zobaczyć wynik.

Podgląd generuje prawdziwy PDF z danymi tego rekordu, łącznie z tekstem AI, z użyciem Twoich ustawień PDF. Podgląd można uruchomić przed zapisaniem. Ponieważ podgląd uruchamia sekcje AI, zużywa tokeny.

Jak użytkownicy uruchamiają szablony#

Na rekordzie obiektu docelowego przycisk 📄 PDF w Sales Agent wyświetla aktywne szablony dla tego obiektu. Przycisk pojawia się tylko wtedy, gdy pasuje co najmniej jeden aktywny szablon. Użytkownik wybiera szablon, zaznacza sekcje do dołączenia i klika ⚡ Generate PDF. PDF jest generowany z uprawnieniami tego użytkownika: rekordy i pola, których użytkownik nie widzi, są pomijane.

Szablon zapisany bez obiektu docelowego jest oferowany na rekordach każdego obiektu.

Warto wiedzieć#

Aby przestać oferować szablon, wyłącz Active i kliknij ✓ Save. Aby usunąć szablon, otwórz go i kliknij 🗑. Jest usuwany natychmiast, bez kroku potwierdzenia.
Duże tabele generują się dłużej. Ograniczaj tabele do rekordów, których czytelnik naprawdę potrzebuje.
Wiele znaków diakrytycznych jest drukowanych w plikach PDF bez nich. Zobacz Ustawienia PDF.

Rozwiązywanie problemów#

Szablonu brakuje w menu PDF. Jest nieaktywny, nie został zapisany albo nazwa API jego obiektu docelowego nie odpowiada obiektowi rekordu.
Sekcja drukuje „No data available.” Nie ma pasujących rekordów, użytkownik ich nie widzi, sekcja nie ma jeszcze zapytania albo zapytania nie dało się uruchomić dla tego użytkownika, np. dlatego, że używa pola, do którego użytkownik nie ma dostępu.
Tekst AI jest ogólnikowy. Doprecyzuj jego prompt i pokaż fakty w sekcji Key Fields, zamiast oczekiwać, że AI je zna.