Dodaj własne tematy do pomocy w aplikacji

Rozszerz wbudowanego asystenta pomocy AI Engine o tematy specyficzne dla Twojego orga, takie jak pola niestandardowe i procesy wewnętrzne, za pomocą static resource w formacie JSON.

AI Engine ma wbudowanego asystenta pomocy: użytkownicy docierają do niego przez Help mode (?) w czacie Sales Agent, a administratorzy przez Ask AI Assistant w zakładce ? Help & Setup. Odpowiada na podstawie własnych treści pomocy AI Engine. Za pomocą rozszerzenia pomocy dodajesz tematy specyficzne dla Twojego orga, np. co oznaczają Twoje pola niestandardowe albo jak Twój zespół kwalifikuje leada, a asystent wykorzystuje je w odpowiedziach.

Zanim zaczniesz#

Potrzebujesz uprawnień do tworzenia Static Resources w Setup (zwykle ma je System Administrator).
Zdecyduj, o jakie tematy pytają użytkownicy, których standardowa pomoc nie może znać.

Tworzenie rozszerzenia#

Utwórz plik tekstowy, np. help-extension.json, o takiej strukturze:

{
  "version": 1,
  "publisher": "Your company",
  "entries": [
    {
      "topic": "Delivery risk field",
      "description": "The Delivery Risk field on Opportunity is set by the logistics team and shows whether the promised date is at risk.",
      "steps": [
        "Open the Opportunity.",
        "Check Delivery Risk in the Logistics section.",
        "If it is High, ask the chat for the open cases on the account before calling the customer."
      ]
    }
  ]
}

Sprawdź plik w walidatorze JSON. Plik, który nie jest poprawnym JSON-em, jest ignorowany bez komunikatu o błędzie.
W Salesforce przejdź do Setup, wpisz Static Resources w polu Quick Find, wybierz Static Resources i kliknij New.
Wpisz Name AIEngineHelpExtension dokładnie tak, jak podano.
W polu File wybierz swój plik JSON. Prześlij sam plik, a nie archiwum ZIP.
Ustaw Cache Control na Private i kliknij Save.
Przetestuj: otwórz Sales Agent, włącz Help mode przyciskiem ? i zapytaj o jeden ze swoich tematów.

Asystent wczytuje rozszerzenie przy następnym pytaniu o pomoc. Nic więcej nie trzeba konfigurować.

Format#

Klucz	Wymagany	Znaczenie
`version`	Opcjonalny	Użyj `1`
`publisher`	Opcjonalny	Nazwa Twojej firmy lub zespołu. Asystent przedstawia wpisy jako funkcje niestandardowe od tego wydawcy; bez tego klucza – jako funkcje tego orga
`entries`	Wymagany	Lista tematów
`entries[].topic`	Wymagany	Nazwa tematu. Wpisy bez tematu są pomijane
`entries[].description`	Opcjonalny	Jedno lub dwa zdania wyjaśniające temat
`entries[].steps`	Opcjonalny	Lista kroków, przekazywana asystentowi jako lista numerowana

Warto wiedzieć#

Korzystają z niego oba asystenty. Rozszerzenie jest dodawane do wiedzy Help mode dla użytkowników i asystenta administratora, więc pisz wpisy, które mają sens dla obu grup odbiorców.
Jest wysyłane do Twojego dostawcy AI. Tekst rozszerzenia trafia do skonfigurowanego dostawcy AI z każdym pytaniem o pomoc, tak jak reszta treści pomocy. Nie umieszczaj w nim haseł, danych osobowych ani niczego poufnego.
Pisz zwięźle. Każdy wpis jest dołączany do każdego pytania o pomoc, co dodaje tokeny do każdego wywołania. Pytania o pomoc są rejestrowane w Activity Monitor jako User Help i Admin Help.
Niepoprawny JSON jest ignorowany. Jeśli pliku nie da się odczytać jako JSON albo nie ma on listy entries, asystent odpowiada wyłącznie na podstawie standardowej pomocy i nie pokazuje błędu.
Aby je zaktualizować, otwórz Static Resource, kliknij Edit, wybierz nowy plik i zapisz. Aby usunąć rozszerzenie, usuń Static Resource.