AI Engine Centrum pomocy

Szybki start

Pełna sekwencja konfiguracji AI Engine po instalacji, od permission setów do pierwszego testu, z linkami do szczegółowych kroków.

To najkrótsza droga od świeżej instalacji do działającego AI Engine. Jest przeznaczona dla administratora Salesforce, który przeprowadza konfigurację. Każdy krok prowadzi do szczegółowego artykułu.

Zanim zaczniesz#

  • AI Engine jest zainstalowany. Zobacz Zainstaluj pakiet.
  • Masz klucz API od OpenAI, Anthropic lub Azure OpenAI.

Krok 1: Przypisz permission sety#

W Setup → Permission Sets przypisz sobie AI Engine Admin i AI Engine User, a osobom, które będą korzystać z AI Engine – AI Engine User. Administratorzy potrzebują obu. Zobacz Przypisz permission sety.

Krok 2: Połącz dostawcę AI#

Utwórz External Credential przechowujący Twój klucz API oraz Named Credential wskazujący na URL dostawcy. Dodaj CloudConnected w Allowed Namespaces for Callouts na Named Credential i nadaj dostęp do principala poświadczenia przez własny permission set, przypisany wszystkim, którzy korzystają z AI Engine. Zobacz Połącz dostawcę AI.

Krok 3: Otwórz zakładkę administracyjną#

Otwórz zakładkę Ai Agent Admin Setup (znajdziesz ją w App Launcherze; przypnij ją do nawigacji swojej aplikacji). Zakładka License w jej wnętrzu pokazuje status okresu próbnego. 5-dniowy bezpłatny okres próbny zaczyna się, gdy ktoś po raz pierwszy użyje funkcji AI, na przykład zada pytanie w czacie, a nie w momencie otwarcia tej zakładki.

Krok 4: Skonfiguruj Org Profile#

W Ai Agent Admin Setup → Org Profile kliknij + New Profile i ustaw:

  • AI Provider: OpenAI (Responses API), Azure OpenAI lub Anthropic Claude.
  • AI Model: główny model. W przypadku Azure OpenAI wpisz nazwę swojego wdrożenia (deployment).
  • Named Credential: Name (nazwa API) Named Credential z kroku 2, a nie jego etykieta. Musi się zgadzać dokładnie, łącznie z wielkością liter.
  • Max Output Tokens: nowe profile zaczynają od 1000, co na początek wystarczy. Większość akcji na rekordach używa co najmniej 3 500 tokenów wyjściowych niezależnie od tego, co tu wpiszesz, więc zwiększ tę wartość tylko wtedy, gdy długie odpowiedzi z akcji na rekordach są ucinane.
  • Sekcje playbooka (Company Description, Lead Process, Email Guidelines, Qualification Questions, Compliance Guardrails): po kilka zdań o Twojej firmie, produktach, procesie sprzedaży i tonie komunikacji. AI Engine dodaje ten tekst do żądań czatu i do wbudowanych akcji na rekordach.

Pozostaw Allow PII wyłączone, chyba że zdecydowano inaczej. Zobacz Org Profile oraz Maskowanie danych osobowych (PII).

Kliknij Save.

Krok 5: Wybierz, co agent może widzieć#

W Agent Objects zaznacz obiekty, z którymi pracuje Twój zespół, na przykład Account, Contact, Lead i Opportunity, plus dwa lub trzy najważniejsze obiekty niestandardowe. Dla każdego z nich zaznacz pola, które agent może odczytywać, kliknij Mask as PII przy każdym zaznaczonym polu zawierającym dane osobowe, włącz Active for Agent i kliknij Save. Czat może odpytywać tylko obiekty, które tu włączysz (plus zadania, wydarzenia i użytkowników), i pracuje na zaznaczonych polach. Zacznij od zawężonej listy; możesz ją później rozszerzyć. Zobacz Agent Objects.

Krok 6: Dodaj komponenty do stron#

W Lightning App Builder dodaj salesagent do stron rekordów, z których korzysta Twój zespół (oraz do utility bar, jeśli czat ma być dostępny wszędzie), a aiScoreCard do stron rekordów Lead i Opportunity. Zapisz i aktywuj każdą stronę. Zobacz Dodaj komponenty do stron.

Krok 7: Przetestuj jako prawdziwy użytkownik#

Zaloguj się jako użytkownik (lub użyj Login As dla użytkownika), który ma tylko AI Engine User oraz dostęp do principala poświadczenia, i wykonaj kilka pytań i akcji. Zobacz Przeprowadź pierwszy test.

Opcjonalne kolejne kroki#

Nadal masz problem? Zapytaj AI albo napisz na contact@cloudconnected.pl – podaj dokładny komunikat błędu, stronę lub akcję, której użyto, i mniej więcej kiedy to się stało.