AI Engine zapisuje każdą akcję AI w obiekcie AI Activity Log. Dziennik daje administratorom i audytorom ślad tego, kto użył której funkcji, na którym rekordzie, z jakim modelem i czy akcja się powiodła. Zawiera metadane użycia oraz krótki komunikat o błędzie, gdy wywołanie się nie powiedzie. Nie zawiera pełnej treści promptu ani odpowiedzi.
Co zawiera każdy rekord dziennika#
Na każdą akcję AI zapisywany jest jeden rekord. Akcja, która wykonuje kilka wywołań do dostawcy (na przykład pytanie w czacie: jedno wywołanie, aby napisać zapytanie, i jedno, aby napisać odpowiedź), to jeden rekord, a liczba wywołań trafia do pola Callouts.
| Pole | Zawartość |
|---|---|
| User | Użytkownik, który uruchomił akcję. |
| Action Type | Funkcja: Chat, Summary, Next Steps, Email Draft, Web Check, Company News, Email Analysis, Meeting Prep, PDF, Custom Prompt, Custom Prompt (Global), Scoring, Magic Snap, User Help lub Admin Help. |
| Object Type i Record Id | Obiekt i rekord, na którym uruchomiono akcję, jeśli taki istnieje. |
| Model i Models Used | Użyty model oraz rozbicie tokenów na poszczególne modele, gdy jedna akcja użyła więcej niż jednego modelu. |
| Callouts | Liczba żądań wysłanych do dostawcy w ramach tej akcji. |
| Tokens Input, Tokens Output, Tokens Total | Liczba tokenów zgłoszona przez dostawcę. |
| Tokens Cache Read, Tokens Cache Write | Tokeny wejściowe pobrane z pamięci podręcznej promptów (prompt cache) dostawcy lub w niej zapisane. |
| Web Searches | Liczba wyszukiwań w internecie wykonanych przez dostawcę. |
| Duration ms | Czas trwania akcji. |
| Estimated Cost USD | Wartość szacunkowa; zobacz Zużycie tokenów i koszty. |
| Success | Czy akcja została ukończona. |
| Error Message | Gdy wywołanie się nie powiedzie – komunikat o błędzie przycięty do 500 znaków. Komunikat o błędzie dostawcy może cytować fragment żądania. Pole może też zawierać krótkie notatki o stanie, na przykład o tym, ile wierszy ze źródeł danych wykorzystał prompt. |
Czego dziennik nie zawiera#
AI Engine nie przechowuje kopii pełnego żądania wysłanego do dostawcy ani pełnej odpowiedzi – ani w dzienniku, ani nigdzie indziej. Dziennik pokazuje, że akcja się odbyła i ile kosztowała, a nie samą rozmowę. Tekst wygenerowany przez AI jest zapisywany w Salesforce w dwóch przypadkach: gdy użytkownik zdecyduje się go zapisać, na przykład tworząc zadanie, wysyłając e-mail, zapisując PDF w Files lub zapisując rekord Magic Snap, oraz gdy AI Scoring zapisuje ocenę, etykietę i pisemne uzasadnienie w polach oceny na leadzie lub szansie sprzedaży (Opportunity). Zobacz Jak AI Engine obsługuje Twoje dane.
Kto widzi dziennik#
- Administratorzy z AI Engine Admin widzą i mogą usuwać wszystkie rekordy dziennika oraz korzystać z Activity Monitor.
- Użytkownicy z AI Engine User mają dostęp do odczytu obiektu. Gdy org-wide default jest ustawiony na Private, mogą czytać tylko własne rekordy (a także – dopóki dla obiektu włączone jest Grant Access Using Hierarchies – rekordy użytkowników znajdujących się niżej w hierarchii ról).
- Użytkownicy nie potrzebują uprawnień do tworzenia ani edycji dziennika. AI Engine sam zapisuje rekordy, a właścicielem każdego rekordu jest użytkownik, który uruchomił akcję.
Odznacz Grant Access Using Hierarchies dla obiektu w Sharing Settings, jeśli menedżerowie nie powinni widzieć rekordów dziennika swojego zespołu. Zalecamy utrzymywanie org-wide default dla AI Activity Log na poziomie Private i sprawdzanie go po aktualizacjach; zobacz Zalecane ustawienia bezpieczeństwa.
Przeglądanie aktywności w Activity Monitor#
Zakładka Activity Monitor w panelu administratora (dostępna także jako komponent aiActivityMonitor) podsumowuje dziennik: wywołania, tokeny i szacowany koszt, użycie według funkcji i użytkownika oraz 200 najnowszych rekordów dziennika z ich statusem. Tylko użytkownicy z AI Engine Admin mogą wczytać jego dane. Zobacz Activity Monitor.
Wykorzystanie dziennika w audytach#
- Błędy: szukaj wierszy oznaczonych ✗ Error w Recent Logs albo sprawdź pole Success w wyeksportowanych rekordach, aby znaleźć problemy z konfiguracją lub z dostawcą.
- Wzorce dostępu: sprawdź, którzy użytkownicy korzystają z których funkcji i na których obiektach. Skok użycia u jednego użytkownika lub w jednej funkcji łatwo zauważyć w widokach miesięcznych.
- Pytania dotyczące konkretnych rekordów: pole Record Id w każdym rekordzie dziennika pokazuje, na których rekordach użytkownik uruchamiał akcje AI. Recent Logs go nie pokazuje, więc użyj raportu lub eksportu.
Obiekt AI Activity Log nie ma własnej zakładki, a pakiet nie włącza dla niego raportów. Aby raportować na jego podstawie, zaznacz Allow Reports na obiekcie i jednorazowo utwórz niestandardowy typ raportu (custom report type), jak opisano w artykule Activity Monitor. Aby pracować z rekordami poza Salesforce, wyeksportuj je, na przykład za pomocą Data Loader.
Okres przechowywania#
AI Engine nie usuwa rekordów dziennika automatycznie; pozostają, dopóki ktoś ich nie usunie. Jeśli Twoja polityka wymaga określonego okresu przechowywania, usuwaj starsze rekordy według harmonogramu za pomocą swoich zwykłych narzędzi Salesforce. Aby prowadzić długoterminowe archiwum, najpierw wyeksportuj rekordy, na przykład za pomocą Data Loader lub eksportu danych Salesforce.