AI Engine Centrum pomocy

Ustawienia Org Profile

Opis zakładki Org Profile — dostawca, modele, Named Credential, tokeny odpowiedzi, temperatura, PII, playbook, branding i Meeting Prep.

Org Profile przechowuje ustawienia AI, które dotyczą każdego użytkownika w orgu: którego dostawcę i model wywołuje AI Engine, jak długie mogą być odpowiedzi, czy dane osobowe (PII) są maskowane oraz playbook firmy, który kształtuje większość odpowiedzi. Ten artykuł opisuje każde z ustawień.

Zanim zaczniesz#

  • Najpierw utwórz External Credential i Named Credential dla dostawcy AI w Salesforce Setup. Zobacz Połącz dostawcę AI.
  • Potrzebujesz permission setu AI_Engine_Admin.

Otwieranie lub tworzenie profilu#

  1. Otwórz zakładkę Ai Agent Admin Setup i wybierz Org Profile.
  2. Jeśli na liście jest karta profilu, kliknij ją, aby go edytować. Jeśli zakładka pokazuje No profile yet, kliknij + New Profile.
  3. Zmień ustawienia, a następnie kliknij ✓ Save na górze formularza. Cancel zamyka formularz bez zapisywania.

AI Engine działa z jednym Org Profile. Karta profilu pokazuje model główny i plakietkę ACTIVE.

Zawsze edytuj istniejący profil, klikając jego kartę. Jeśli profil już istnieje, zapis z + New Profile nie dodaje drugiego profilu. Nadpisuje istniejący wartościami z nowego, w większości pustego formularza, łącznie z playbookiem, brandingiem, niestandardowymi polami PII i obiektami Meeting Prep.

Ustawienia AI#

Ustawienie Działanie Wartość domyślna dla nowego profilu
AI Provider OpenAI (Responses API), Azure OpenAI lub Anthropic Claude. Zmiana dostawcy resetuje AI Model i Named Credential do wartości domyślnych tego dostawcy, więc potem sprawdź oba. OpenAI (Responses API)
AI Model Model główny, używany do odpowiedzi w czacie i stojących za nimi zapytań, akcji na rekordach, Meet Prep, tekstu PDF i scoringu. Dla OpenAI i Anthropic wybierz z listy. Dla Azure OpenAI wpisz swoją nazwę wdrożenia (deployment name). Model rekomendowany przez dostawcę. Dla Azure OpenAI pole jest wstępnie wypełnione wartością gpt-4o; zastąp ją nazwą swojego wdrożenia.
Fast model (internal steps) Opcjonalny tańszy model tego samego dostawcy, używany do wyszukiwań w internecie i wbudowanego asystenta pomocy. Model innego dostawcy nie zostanie zapisany. Dla Azure OpenAI jest to opcjonalna nazwa drugiego wdrożenia. Zobacz Wybierz model główny i szybki. Provider default (dla Azure OpenAI: puste, co oznacza główne wdrożenie)
Named Credential Nazwa Named Credential utworzonego w Setup, zapisana dokładnie tak jak w Setup. OpenAI, Anthropic lub AzureOpenAI, zależnie od dostawcy
Max Output Tokens Podnosi limit odpowiedzi akcji na rekordach, Meet Prep, szablonów PDF i Analyze Email powyżej ich wbudowanych minimów. Zobacz niżej. 1000
Temperature Jak zróżnicowane jest sformułowanie odpowiedzi. Niższe wartości dają bardziej spójne odpowiedzi. 0.5
Allow PII Wyłączone: AI Engine maskuje dane osobowe przed wysłaniem ich do dostawcy AI. Obejmuje to pola e-mail, telefonu i adresu, pola oznaczone jako PII w Agent Objects, niestandardowe pola PII opisane niżej oraz niektóre rozpoznawalne wzorce w tekście swobodnym. Włączone: wartości są wysyłane bez zmian. Zobacz Maskowanie PII. Wyłączone
Show SOQL in Chat Pokazuje zapytanie stojące za każdą odpowiedzią w czacie. Przydatne podczas testowania agenta. Wyłączone
Modern Interface Przełącza czat na nowoczesny motyw. Zobacz Branding. Wyłączone
Meet Prep: include web search Dodaje do każdego briefu Meet Prep wyszukiwanie w internecie najnowszych wiadomości o firmie. Wyłączone

Max Output Tokens#

Akcje na rekordach, takie jak Next Steps, Draft Email i Twoje własne szablony promptów, briefy Meet Prep oraz tekst AI w szablonach PDF zawsze dopuszczają co najmniej 3 500 tokenów odpowiedzi, a Analyze Email co najmniej 2 000. Max Output Tokens działa tylko wtedy, gdy ustawisz wartość wyższą niż te wartości; wtedy podnosi limit dla tych funkcji. Odpowiedzi czatu są ograniczone do 1 000 tokenów, a AI scoring, Magic Snap i asystent pomocy mają własne stałe limity. To ustawienie ich nie zmienia.

Jeśli długie briefy lub wyniki tych funkcji urywają się w połowie zdania albo ustrukturyzowane wyniki, takie jak karty, wracają puste, ustaw wartość powyżej 3 500. Odpowiedzi w językach takich jak polski, niderlandzki czy francuski zużywają więcej tokenów niż ta sama odpowiedź po angielsku.

Temperature#

Utrzymuj ją w zakresie od 0 do 1. Do pracy sprzedażowej dobrym zakresem jest 0,3–0,7. Niektóre nowsze modele nie akceptują ustawienia temperatury. Dla tych modeli AI Engine pomija je w żądaniu.

Show SOQL in Chat#

Ten przełącznik jest zapisywany w przeglądarce administratora, który go zmienia, a nie w orgu. Pokazuje zapytania tylko temu administratorowi, w tej przeglądarce. Używaj go do testów. Nie włącza wyświetlania zapytań Twoim użytkownikom.

Wyszukiwanie w internecie dodaje do każdego briefu około 30 000 tokenów wejściowych. Dlatego jest domyślnie wyłączone. Włącz je tylko wtedy, gdy handlowcy chcą mieć najnowsze wiadomości w każdym briefie.

Niestandardowe pola PII#

Custom PII fields (masked when Allow PII is off) przyjmuje rozdzieloną przecinkami listę nazw API pól, np. Tax_ID__c, National_ID__c. Te pola są maskowane dodatkowo oprócz pól oznaczonych w Agent Objects. Jak działa maskowanie, opisuje Maskowanie PII.

Sekcje playbooka#

Pięć pól tekstowych Company Description, Lead Process, Email Guidelines, Qualification Questions i Compliance Guardrails razem tworzy playbook. Co w nich pisać, opisuje Napisz playbook.

Branding#

App Name i Logo URL w karcie Branding zmieniają nagłówek czatu Sales Agent dla wszystkich użytkowników. Zobacz Branding.

Meeting Prep: obiekty dodatkowe#

Karta 📅 Meeting Prep — Additional Objects na dole profilu określa, które rekordy powiązane odczytuje Meet Prep. Jest zapisywana przyciskiem ✓ Save razem z resztą profilu. Zobacz Obiekty podrzędne i Meeting Prep.

Rozwiązywanie problemów#

  • Każde wywołanie AI kończy się błędem zaraz po konfiguracji. Sprawdź trzy rzeczy w Salesforce Setup:

    1. Wartość Named Credential w Org Profile dokładnie odpowiada nazwie Named Credential w Setup.
    2. CloudConnected jest wymieniony w Allowed Namespaces for Callouts (sekcja Managed Package Callout Allowlist) w Named Credential.
    3. Każdy użytkownik AI Engine, łącznie z administratorami, ma dostęp do principala External Credential przez Twój własny permission set (Setup → Permission Sets → ten permission set → External Credential Principal Access), a także ma AI Engine User.

    Zobacz Klucze API i Named Credentials.

  • Akcje na rekordach, briefy Meet Prep lub tekst PDF urywają się w połowie zdania. Ustaw Max Output Tokens powyżej 3 500.

  • Playbook lub branding nagle jest pusty. Profil został prawdopodobnie zapisany z + New Profile, co nadpisuje istniejący profil. Wprowadź wartości ponownie na karcie istniejącego profilu.

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.