Znajdź prawidłowe e-maile w folderze spamu w Gmailu za pomocą sztucznej inteligencji i skryptu Google

Fałszywe alarmy w Gmailu są rzadkie, ale mogą się zdarzyć, co oznacza, że ​​ważny e-mail może przez pomyłkę trafić do folderu ze spamem. Kiedy codziennie masz do czynienia z setkami spamu, identyfikacja tych prawdziwych e-maili staje się jeszcze trudniejsza.

W Gmailu możesz utworzyć filtry, dzięki którym e-maile od określonych nadawców lub zawierające określone słowa kluczowe nigdy nie będą oznaczane jako spam. Ale te filtry oczywiście nie będą działać w przypadku e-maili od nowych lub nieznanych nadawców.

Znajdź błędnie sklasyfikowane wiadomości w spamie Gmaila

Co by było, gdybyśmy wykorzystali sztuczną inteligencję do analizy spamu w Gmailu i przewidzenia, które z nich mogą być fałszywie pozytywne? Dzięki tej liście błędnie sklasyfikowanych e-maili możemy automatycznie przenieść je do skrzynki odbiorczej lub wygenerować raport do ręcznego sprawdzenia.

Oto przykładowy raport wygenerowany z Gmaila. Zawiera listę e-maili o niskim wskaźniku spamu, które prawdopodobnie są uzasadnione i powinny zostać przeniesione do skrzynki odbiorczej. Raport zawiera także podsumowanie treści wiadomości e-mail w preferowanym przez Ciebie języku.

Aby rozpocząć, otwórz ten skrypt Google i utwórz jego kopię na swoim Dysku Google. Przejdź do edytora Apps Script i podaj swój adres e-mail, klucz OpenAI API oraz preferowany język, w którym chcesz otrzymać e-mail z podsumowaniem.

Wybierz funkcję reportFalsePositives z listy rozwijanej i kliknij przycisk odtwarzania, aby uruchomić skrypt. Wyszuka nieprzeczytane wiadomości spamowe na Twoim koncie Gmail, przeanalizuje je za pomocą interfejsu API OpenAI i wyśle ​​Ci raport o wiadomościach e-mail z niskim wynikiem spamu.

Jeśli chcesz uruchamiać ten skrypt automatycznie w regularnych odstępach czasu, przejdź do menu „Wyzwalacze” w edytorze skryptów Google Apps i skonfiguruj wyzwalacz zależny od czasu, aby uruchamiał ten skrypt raz dziennie, jak pokazano poniżej. Możesz także wybrać porę dnia, o której chcesz otrzymać raport.

Jak działa klasyfikacja spamu AI – część techniczna

Jeśli ciekawi Cię, jak działa skrypt, oto krótki przegląd:

Skrypt Gmaila wykorzystuje interfejs API Gmaila do wyszukiwania nieprzeczytanych wiadomości spamowych na Twoim koncie Gmail. Następnie wysyła treść wiadomości e-mail do interfejsu API OpenAI w celu sklasyfikowania wyniku spamu i wygenerowania podsumowania w preferowanym języku. E-maile z niskim wynikiem spamu są prawdopodobnie fałszywymi alarmami i mogą zostać przeniesione do skrzynki odbiorczej.

1. Konfiguracja użytkownika

Możesz podać swój adres e-mail, na który powinien zostać wysłany raport, klucz OpenAI API, preferowany model LLM i język podsumowania e-maila.

 // Basic configuration const USER_EMAIL = '[email protected]' ; // Email address to send the report to const OPENAI_API_KEY = 'sk-proj-123' ; // API key for OpenAI const OPENAI_MODEL = 'gpt-4o' ; // Model name to use with OpenAI const USER_LANGUAGE = 'English' ; // Language for the email summary

2. Znajdź nieprzeczytane e-maile w folderze spamu Gmaila

Czasu epoki używamy do wyszukiwania wiadomości spamowych, które dotarły w ciągu ostatnich 24 godzin i nadal są nieprzeczytane.

 const HOURS_AGO = 24 ; // Time frame to search for emails (in hours) const MAX_THREADS = 25 ; // Maximum number of email threads to process const getSpamThreads_ = ( ) => { const epoch = ( date ) => Math . floor ( date . getTime ( ) / 1000 ) ; const beforeDate = new Date ( ) ; const afterDate = new Date ( ) ; afterDate . setHours ( afterDate . getHours ( ) - HOURS_AGO ) ; const searchQuery = ` is:unread in:spam after: ${ epoch ( afterDate ) } before: ${ epoch ( beforeDate ) } ` ; return GmailApp . search ( searchQuery , 0 , MAX_THREADS ) ; } ;

3. Utwórz podpowiedź dla modelu OpenAI

Za pomocą wiadomości e-mail tworzymy zachętę do modelu OpenAI. Monit prosi model AI o przeanalizowanie treści wiadomości e-mail i przypisanie oceny spamu w skali od 0 do 10. Odpowiedź powinna być w formacie JSON.

 const SYSTEM_PROMPT = ` You are an AI email classifier. Given the content of an email, analyze it and assign a spam score on a scale from 0 to 10, where 0 indicates a legitimate email and 10 indicates a definite spam email. Provide a short summary of the email in ${ USER_LANGUAGE } . Your response should be in JSON format. ` ; const MAX_BODY_LENGTH = 200 ; // Maximum length of email body to include in the AI prompt const getMessagePrompt_ = ( message ) => { const body = message . getPlainBody ( ) . replace ( / https?:\/\/[^\s>]+ / g , '' ) . replace ( / [\n\r\t] / g , ' ' ) . replace ( / \s+ / g , ' ' ) . trim ( ) ; // remove all URLs, and whitespace characters return [ ` Subject: ${ message . getSubject ( ) } ` , ` Sender: ${ message . getFrom ( ) } ` , ` Body: ${ body . substring ( 0 , MAX_BODY_LENGTH ) } ` , ] . join ( '\n' ) ; } ;

4. Wywołaj interfejs API OpenAI, aby uzyskać ocenę spamu

Przekazujemy monit o wiadomość do API OpenAI i uzyskujemy ocenę spamu oraz podsumowanie treści wiadomości e-mail. Wynik spamu służy do określenia, czy wiadomość e-mail jest fałszywie pozytywna.

Zmienna tokens śledzi liczbę tokenów używanych w wywołaniach API OpenAI i jest uwzględniana w raporcie e-mailowym. Możesz wykorzystać te informacje do monitorowania wykorzystania interfejsu API.

 let tokens = 0 ; const getMessageScore_ = ( messagePrompt ) => { const apiUrl = ` https://api.openai.com/v1/chat/completions ` ; const headers = { 'Content-Type' : 'application/json' , Authorization : ` Bearer ${ OPENAI_API_KEY } ` , } ; const response = UrlFetchApp . fetch ( apiUrl , { method : 'POST' , headers , payload : JSON . stringify ( { model : OPENAI_MODEL , messages : [ { role : 'system' , content : SYSTEM_PROMPT } , { role : 'user' , content : messagePrompt } , ] , temperature : 0.2 , max_tokens : 124 , response_format : { type : 'json_object' } , } ) , } ) ; const data = JSON . parse ( response . getContentText ( ) ) ; tokens += data . usage . total_tokens ; const content = JSON . parse ( data . choices [ 0 ] . message . content ) ; return content ; } ;

5. Przetwarzaj wiadomości e-mail będące spamem i wysyłaj raport pocztą elektroniczną

Możesz uruchomić ten skrypt Google ręcznie lub skonfigurować wyzwalacz cron, aby uruchamiał go automatycznie w regularnych odstępach czasu. Oznacza e-maile będące spamem jako przeczytane, dzięki czemu nie są one ponownie przetwarzane.

 const SPAM_THRESHOLD = 2 ; // Threshold for spam score to include in the report const reportFalsePositives = ( ) => { const html = [ ] ; const threads = getSpamThreads_ ( ) ; for ( let i = 0 ; i < threads . length ; i += 1 ) { const [ message ] = threads [ i ] . getMessages ( ) ; const messagePrompt = getMessagePrompt_ ( message ) ; // Get the spam score and summary from OpenAI const { spam_score , summary } = getMessageScore_ ( messagePrompt ) ; if ( spam_score <= SPAM_THRESHOLD ) { // Add email message to the report if the spam score is below the threshold html . push ( ` <tr><td> ${ message . getFrom ( ) } </td> <td> ${ summary } </td></tr> ` ) ; } } threads . forEach ( ( thread ) => thread . markRead ( ) ) ; // Mark all processed emails as read if ( html . length > 0 ) { const htmlBody = [ ` <table border="1"> ` , '<tr><th>Email Sender</th><th>Summary</th></tr>' , html . join ( '' ) , '</table>' , ] . join ( '' ) ; const subject = ` Gmail Spam Report - ${ tokens } tokens used ` ; GmailApp . sendEmail ( USER_EMAIL , subject , '' , { htmlBody } ) ; } } ;

Zobacz także: Uwierzytelnij swoje wiadomości w Gmailu