Szablon promptu to zapisany prompt, który pojawia się jako pozycja w menu ◈ Actions w Sales Agent. Użytkownicy klikają go, zamiast codziennie wpisywać tę samą prośbę. Szablony obejmują rutynowe zadania Twojego zespołu: przegląd konta w Waszym formacie, cotygodniowy brief pipeline’u, e-mail follow-up w Waszym stylu.
Zanim zaczniesz#
- Potrzebujesz permission setu
AI_Engine_Admin. - Obiekty, z którymi pracuje szablon, powinny być włączone w Agent Objects. Szablon Record pojawia się tylko na rekordach włączonych obiektów: bez kontekstu rekordu menu Actions nie jest wyświetlane na rekordzie.
Tworzenie szablonu#
Otwórz Ai Agent Admin Setup → Prompt Templates i kliknij + New. Otworzy się nowy szablon o nazwie „New Prompt”, z włączonym Active i zakresem Record.
Wypełnij pola:
Pole Co wpisać Name (Label) Etykieta, którą użytkownicy widzą w menu Actions, np. „Przegląd konta”. Description Notatka dla administratorów o tym, co robi szablon. Użytkownicy jej nie widzą. Action Key Unikalny identyfikator, np. account_review. Zawsze go wypełniaj. Małe litery i podkreślenia sprawiają, że klucze łatwo czytać i porównywać.Scope Record lub Global. Zobacz niżej. Available on objects Tylko zakres Record. Obiekty, na których stronach rekordów pojawia się szablon. Prompt Template Sam prompt, z placeholderami. Pozostaw włączone Active, aby użytkownicy widzieli szablon.
Opcjonalnie: dodaj źródła danych pod promptem. Zobacz Dodaj źródła danych do szablonu promptu.
Kliknij ✓ Save. Szablon i jego źródła danych są zapisywane razem.
Użytkownicy zobaczą nowy lub zmieniony szablon po przeładowaniu strony lub otwarciu innego rekordu.
Zakres: Record czy Global#
| Record | Global | |
|---|---|---|
| Gdzie się pojawia | W menu Actions na stronach rekordów | W menu Actions, gdy Sales Agent jest otwarty bez rekordu: utility bar, strona aplikacji lub zakładka |
| Dane rekordu | Otrzymuje bieżący rekord przez {context} |
Brak danych rekordu. Tylko playbook i źródła danych |
| Wybór obiektów | Available on objects. Pozostaw puste, aby pokazywać szablon na każdym włączonym obiekcie | Nie dotyczy |
| Typowe zastosowanie | Przegląd konta, ocena ryzyka transakcji, e-mail follow-up | Codzienny brief, przegląd pipeline’u, „moje zaległe zadania” |
Prosty test: jeśli szablon odpowiada na pytanie „co z tym rekordem?”, użyj Record. Jeśli odpowiada na pytanie „co u mnie lub w moim zespole?”, użyj Global.
Bez rekordu menu Actions jest wyświetlane tylko wtedy, gdy istnieje co najmniej jeden aktywny szablon Global.
Lista Available on objects pokazuje obiekty włączone w Agent Objects. Zaznacz Show all queryable objects, aby wybrać obiekt, który nie jest jeszcze włączony. Szablon pojawi się na rekordach tego obiektu, gdy obiekt zostanie włączony w Agent Objects.
Placeholdery#
Wpisuj te placeholdery w treści promptu. AI Engine zastępuje je przed wysłaniem promptu.
| Placeholder | Zastępowany przez |
|---|---|
{playbook} |
Playbook z Org Profile. Zobacz Napisz playbook. |
{context} |
Dane bieżącego rekordu: pola zaznaczone w Agent Objects oraz rekordy powiązane z Child Objects. Tylko zakres Record. |
{description} |
Te same dane rekordu co {context}. Tylko zakres Record. |
{data:name} |
Wynik źródła danych o nazwie name. |
Używaj tylko placeholderów z tej tabeli. W szablonach Global placeholdery rekordu są zastępowane niczym. Playbook jest dodawany tylko tam, gdzie wpiszesz {playbook}. Jeśli go pominiesz, szablon działa bez kontekstu Twojej firmy.
Selektor języka na pasku Actions nadal obowiązuje. Gdy wybrano język inny niż angielski, AI Engine dodaje instrukcję, aby odpowiadać w tym języku.
Klucze akcji wbudowanych#
Akcje wbudowane używają kluczy summarize, nextSteps, draftEmail, companyNews i webCheck. Szablon zapisany z jednym z tych kluczy zastępuje wbudowany prompt tej akcji. Web Check i Company News wykonują wyszukiwanie w internecie tylko z wbudowanym promptem, więc ich zamiennik odpowiada wyłącznie na podstawie modelu. Jeśli nie zamierzasz zastąpić akcji wbudowanej, wybierz inny klucz.
Każdy klucz akcji identyfikuje jeden szablon. Zapisanie nowego szablonu z kluczem, który już istnieje, nadpisuje istniejący szablon.
Zmiana lub wycofanie szablonu#
Kliknij szablon na liście, edytuj go i kliknij ✓ Save. Aby wycofać szablon z użycia, wyłącz Active i zapisz. Panel administratora nie ma przycisku usuwania, więc nieaktywny szablon pozostaje na liście i można go później ponownie włączyć. Znacznik włącz/wyłącz przy każdym szablonie na liście również zaczyna działać dopiero po otwarciu szablonu i kliknięciu ✓ Save.
Lista pokazuje zakres każdego szablonu (np. RECORD: all objects lub GLOBAL) oraz liczbę jego źródeł danych.
Rozwiązywanie problemów#
- Menu Actions wyświetla „No prompts configured for this object”. Żaden aktywny szablon Record nie pasuje do tego obiektu: sprawdź Active, zakres i Available on objects.
- Brak menu Actions, gdy Sales Agent jest otwarty bez rekordu. Nie ma aktywnego szablonu Global.
- Brak menu Actions na stronie rekordu. Obiekt nie jest włączony w Agent Objects, więc rekord nie ma kontekstu rekordu.
- Szablonu brakuje na jednym obiekcie. Obiektu nie ma na jego liście Available on objects.
- Szablon Global daje mgliste odpowiedzi. Nie ma danych rekordu. Dodaj źródła danych, aby miał prawdziwe liczby do pracy.
- Odpowiedź pomija część rekordu. Potrzebne pola nie są zaznaczone w Agent Objects. Szablon widzi tylko to, co zawiera
{context}.
Porady dotyczące pisania samego promptu znajdziesz w artykule Pisz skuteczne prompty.