【GAS、GPT-4】OpenAI APIでGmailに届くエラーメールをスプレッドシートに記録する

はじまり#

リサちゃん

あ～～、これ自動で書いてくんねえかな・・・

135ml

Gmailのやつか

リサちゃん

届けてくれるのはありがたいんだけど、もう一つ欲しいよね

135ml

じゃあ、作るか

今回やりたいこと#

Google Apps Scirpt を使っていると、 Gmail にエラーメッセージやその周辺の情報が送られてくることがあります。しかし、メールとして断片的になっているデータって、扱いづらいですよねえ・・・

そこで本記事では、 Gmail に届くメッセージから必要な情報を抽出し、管理を効率化する方法について紹介します。

今回、こんな風に送られてくるエラー情報を・・・

スプレッドシートに書き込んでいく機能を実装していきます。

手順#

それでは、実装の手順です。

1．Gmailのメッセージの取得#

まずは、 Gmail にあるメッセージを取得しましょう。

最初にメールのリストを取得します。ここでは、エラーメールの件名と未読かどうかでフィルタリングしています。

1
/**
2
 * @description Write error log from Gamil into the sheet with GPT.
3
 * @return {boolean}
4
*/
5
function writeErrorLogFromGmailWithGpt(){
6
  const sheetName = SHEET_NAME_1ST;
7
  const colOfNumber = 1;
8
  const targetSubject = `Summary of failures for Google Apps Script: `;
9
  let query = `label:inbox is:unread subject:"${targetSubject}"`; // 検索条件を設定
10
  let threads = GmailApp.search(query); // Gmailのスレッドを検索
11

12
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
13
  let startRow = 2;
14
  let numbers = sheet.getRange(startRow, colOfNumber, 1, sheet.getLastRow()).getValues().map(record => {
15
    return record;
16
  });
17
  let maxNumber = Math.max(numbers);
18
  let i = 0;
19
  let valuesToWrite = [];
20
  console.log(`writeErrorLog: 222222222222222222222222222222222222222222222222222222222222222222`);
21
  threads.forEach(function(thread) {
22
    console.log(thread.getMessageCount()); // スレッド内のメッセージの個数
23
    let messages = thread.getMessages(); // スレッド内のメッセージを取得
24
    messages.forEach(function(message) {
25
      console.log(message.getSubject()); // 使う
26
      console.log(`writeErrorLog: 333333333333333333333333333333333333333333333333333333333333333`);
27
      console.log(message.getDate()); // 使う
28
      console.log(message.getPlainBody());
29

30

31

32

33
    });
34
  });
35

36
  return true;
37
}

2．OpenAIのChat Completions APIを使う#

次に、取得したメッセージを GPT-4 に与えましょう。

まだ使ったことがなければ、以下の OpenAI の Developer Platform で、 API キーを作りましょう。

platform.openai.com

API キーを作ったら、 GAS を書いていきます。

追加した処理の中で、 GPT-4 にプロンプトを与えていきます。（generatedMsgは後で使います。）

1
/**
2
 * @description Write error log from Gamil into the sheet with GPT.
3
 * @return {boolean}
4
*/
5
function writeErrorLogFromGmailWithGpt(){
6
  const sheetName = SHEET_NAME_1ST;
7
  const colOfNumber = 1;
8
  const targetSubject = `Summary of failures for Google Apps Script: `;
9
  let query = `label:inbox is:unread subject:"${targetSubject}"`; // 検索条件を設定
10
  let threads = GmailApp.search(query); // Gmailのスレッドを検索
11

12
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
13
  let startRow = 2;
14
  let numbers = sheet.getRange(startRow, colOfNumber, 1, sheet.getLastRow()).getValues().map(record => {
15
    return record;
16
  });
17
  let maxNumber = Math.max(numbers);
18
  let i = 0;
19
  let valuesToWrite = [];
20
  console.log(`writeErrorLog: 222222222222222222222222222222222222222222222222222222222222222222`);
21
  threads.forEach(function(thread) {
22
    console.log(thread.getMessageCount()); // スレッド内のメッセージの個数
23
    let messages = thread.getMessages(); // スレッド内のメッセージを取得
24
    messages.forEach(function(message) {
25
      console.log(message.getSubject()); // 使う
26
      console.log(`writeErrorLog: 333333333333333333333333333333333333333333333333333333333333333`);
27
      console.log(message.getDate()); // 使う
28
      console.log(message.getPlainBody());
29

30
      // 追加: START ---------------------------------------------------------------------
31
      let plainText = message.getPlainBody();
32
      const keywords = ["function", "error_message", "trigger"];
33
      let extractedInfo = extractErrorInfoInPlainText(plainText, keywords)
34
      console.log(typeof extractedInfo);
35
      console.log(extractedInfo);
36
      console.log(extractedInfo["choices"]);
37
      console.log(extractedInfo["choices"][0]["message"]);
38
      let generatedMsg = extractedInfo["choices"][0]["message"]["content"];
39
      // 追加: END ---------------------------------------------------------------------
40

41
    });
42
  });
43

44
  return true;
45
}

それでは、extractErrorInfoInPlainText()の中身を見ていきましょう。

この関数で、 OpenAI の Chat Completions API にリクエストする内容を作ります。

1
/**
2
 * @description Extract error info in txt.
3
 * @param {string} plainText
4
 * @param {string[]} keywords
5
 * @return {string{}}
6
*/
7
function extractErrorInfoInPlainText(plainText, keywords){
8
  // 抽出した情報を格納するオブジェクト
9
  const prompt = `この[# プレーンテキスト]から[# 欲しい情報]を[# 形式]の形式で取得してください\n\n[# プレーンテキスト]\n${plainText}\n\n[# 欲しい情報]\n- ${keywords.reduce((prev, curr) => `${prev}\n- ${curr}`)}\n\n[# 形式]\nHTMLのTable形式で、[# 欲しい情報]がヘッダーになる。`
10

11
  const messages = [
12
    {"role": "system", "content": "You are a helpful assistant."}
13
    , {"role": "user", "content": prompt}
14
  ]
15
  const modelName = "gpt-4";
16
  const maxTokens = 2048;
17
  const temperature = 0.2; // 生成する文章のランダム性（0：完全に確定的、2：完全にランダム）
18
  let resObj = generateChatCompletionWithOpenaiApi(messages, modelName, maxTokens, temperature)
19
  console.log(resObj);
20
  console.log(`extractErrorInfoInPlainText: 66666666666666666666666666666666666666666666666666666666666666666666`);
21
  return resObj;
22
}
23

24
/**
25
 * @description Generate chat completions like ChatGPT.
26
 * @param {string[]{}} messages
27
 * @param {string} modelName
28
 * @param {number} maxTokens
29
 * @param {number} temperature
30
 * @return {any{}}
31
*/
32
function generateChatCompletionWithOpenaiApi(messages, modelName="gpt-4", maxTokens=2048, temperature=1){
33
  const endpoint = "https://api.openai.com/v1/chat/completions";
34
  const apiKey = API_KEY_OPENAI;
35
  const payload = {
36
    "messages": messages
37
    , "model": modelName
38
    , "max_tokens": maxTokens
39
    , "temperature": temperature
40
  };
41
  const options = {
42
    "method": "POST"
43
    , "headers": {
44
      "Content-Type": "application/json"
45
      , "Authorization": "Bearer " + apiKey
46
    }
47
    , "payload": JSON.stringify(payload)
48
  };
49
  const res = UrlFetchApp.fetch(endpoint, options);
50
  return JSON.parse(res.getContentText());
51
}

この関数の中の、prompt変数にはプロンプトしたい文章が入っています。 ChatGPT で入力してみるとこんな感じ。

1
この[# プレーンテキスト]から[# 欲しい情報]を[# 形式]の形式で取得してください
2

3
[# プレーンテキスト]
4

5
スクリプト TestFunctionSheet を正常に完了できませんでした。失敗のまとめを下記
6
に示します。このスクリプトのトリガーを設定したり、今後の失敗の通知の受信設定
7
を変更したりするには、ここをクリックしてください。
8

9

10
起動 関数 エラー メッセージ トリガー End
11

12
2024/02/18 5時00分55秒 日本標準時 testfunction TypeError:
13
statement.replace is not a function time-based 2024/02/18 5時01分15秒 日本標
14
準時
15

16

17
よろしくお願いいたします。
18
Google Apps Script
19

20
サポートが必要な場合は、Google Apps Script のドキュメントをご覧ください。本
21
メールは配信専用です。ご返信なさらぬようご注意ください。(c) 2024 Google
22

23

24
[# 欲しい情報]
25
- function
26
- error_message
27
- trigger
28

29
[# 形式]
30
HTMLのTable形式で、[# 欲しい情報]がヘッダーになる。

GAS を実行してみて、こんなエラーメッセージが表示されたら、おそらくクレジットが0になっている可能性があるので、さっきの Developer Platform でクレジットカードを登録しましょう。。。（5 ドルくらい払えばとりあえず問題ないと思います。）

1
"error": {
2
    "message": "The model `gpt-4` does not exist or you do not have access to it. Learn more: https://help.openai.com/en/artic... (use muteHttpExceptions option to examine full response)

3．Parserで欲しい情報を抽出する#

次に、 GPT-4 に生成してもらった内容を切り抜いていきましょう。

今回は、GAS のParserライブラリを使っていきます。スクリプトのライブラリに入れていきましょう。（ID は、1Mc8BthYthXx6CoIz90-JiSzSafVnT6U3t0z_W3hLTAX5ek4w0G_EIrNw）

そして、情報を抽出していきます。このために、 GPT-4 には HTML 形式で情報を出してもらったのでした。

1
/**
2
 * @description Write error log from Gamil into the sheet with GPT.
3
 * @return {boolean}
4
*/
5
function writeErrorLogFromGmailWithGpt(){
6
  const sheetName = SHEET_NAME_1ST;
7
  const colOfNumber = 1;
8
  const targetSubject = `Summary of failures for Google Apps Script: `;
9
  let query = `label:inbox is:unread subject:"${targetSubject}"`; // 検索条件を設定
10
  let threads = GmailApp.search(query); // Gmailのスレッドを検索
11

12
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
13
  let startRow = 2;
14
  let numbers = sheet.getRange(startRow, colOfNumber, 1, sheet.getLastRow()).getValues().map(record => {
15
    return record;
16
  });
17
  let maxNumber = Math.max(numbers);
18
  let i = 0;
19
  let valuesToWrite = [];
20
  console.log(`writeErrorLog: 222222222222222222222222222222222222222222222222222222222222222222`);
21
  threads.forEach(function(thread) {
22
    console.log(thread.getMessageCount()); // スレッド内のメッセージの個数
23
    let messages = thread.getMessages(); // スレッド内のメッセージを取得
24
    messages.forEach(function(message) {
25
      console.log(message.getSubject()); // 使う
26
      console.log(`writeErrorLog: 333333333333333333333333333333333333333333333333333333333333333`);
27
      console.log(message.getDate()); // 使う
28
      console.log(message.getPlainBody());
29

30

31
      let plainText = message.getPlainBody();
32
      const keywords = ["function", "error_message", "trigger"];
33
      let extractedInfo = extractErrorInfoInPlainText(plainText, keywords)
34
      console.log(typeof extractedInfo);
35
      console.log(extractedInfo);
36
      console.log(extractedInfo["choices"]);
37
      console.log(extractedInfo["choices"][0]["message"]);
38
      let generatedMsg = extractedInfo["choices"][0]["message"]["content"];
39

40
      // 追加: START ---------------------------------------------------------------------
41
      let extractedErrorInfo = extractErrorInfoFromChatGptMsg(generatedMsg);
42
      // 追加: END ---------------------------------------------------------------------
43

44
    });
45
  });
46

47
  return true;
48
}

それでは、extractErrorInfoFromChatGptMsg()の中身を見ていきましょう。

1
/**
2
 * @description Extract Error info from messages ChatGPT-4 generated.
3
 * @param {string} message
4
 * @return {string[]}
5
*/
6
function extractErrorInfoFromChatGptMsg(message){
7
  const markToParse1 = "th";
8
  const markToParse2 = "td";
9

10
  let texts1 = Parser.data(message).from(`<${markToParse1}>`).to(`</${markToParse1}>`).iterate();
11
  let texts2 = Parser.data(message).from(`<${markToParse2}>`).to(`</${markToParse2}>`).iterate();
12
  console.log(texts1);
13
  console.log(texts2);
14
  console.log(`extractErrorInfoFromChatGptMsg: 11111111111111111111111111111111111111111111111111111111111111`);
15

16
  let returnObj = {};
17
  returnObj["is_table_deformed"] = false;
18
  if(texts1.length !== texts2.length || texts2.length !== 3){
19
    console.log(`extractErrorInfoFromChatGptMsg: 22222222222222222222222222222222222222222222222222222222222222222`);
20
    returnObj["is_table_deformed"] = true;
21
  }
22

23
  let returns = [];
24
  for(let i = 0; i < texts2.length; i++){
25
    returns.push(texts2[i].replaceAll(" ","_"));
26
  }
27
  returnObj["info_list"] = returns;
28
  console.log(`extractErrorInfoFromChatGptMsg: 99999999999999999999999999999999999999999999999999999999999999`);
29

30
  return returnObj;
31
}

すると、returnObj["info_list"]の中に、必要な情報が入った配列が入ります。

1
[ 'testfunction', 'TypeError: statement.replace is not a function', 'time-based' ]

4．スプレッドシートに記録する#

書き込みたい情報は取れたので、シートに書きます。

1
/**
2
 * @description Write error log from Gamil into the sheet with GPT.
3
 * @return {boolean}
4
*/
5
function writeErrorLogFromGmailWithGpt(){
6
  const sheetName = SHEET_NAME_1ST;
7
  const colOfNumber = 1;
8
  const targetSubject = `Summary of failures for Google Apps Script: `;
9
  let query = `label:inbox is:unread subject:"${targetSubject}"`; // 検索条件を設定
10
  let threads = GmailApp.search(query); // Gmailのスレッドを検索
11

12
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
13
  let startRow = 2;
14
  let numbers = sheet.getRange(startRow, colOfNumber, 1, sheet.getLastRow()).getValues().map(record => {
15
    return record;
16
  });
17
  let maxNumber = Math.max(numbers);
18
  let i = 0;
19
  let valuesToWrite = [];
20
  console.log(`writeErrorLog: 222222222222222222222222222222222222222222222222222222222222222222`);
21
  threads.forEach(function(thread) {
22
    console.log(thread.getMessageCount()); // スレッド内のメッセージの個数
23
    let messages = thread.getMessages(); // スレッド内のメッセージを取得
24
    messages.forEach(function(message) {
25
      console.log(message.getSubject()); // 使う
26
      console.log(`writeErrorLog: 333333333333333333333333333333333333333333333333333333333333333`);
27
      console.log(message.getDate()); // 使う
28
      console.log(message.getPlainBody());
29

30

31
      let plainText = message.getPlainBody();
32
      const keywords = ["function", "error_message", "trigger"];
33
      let extractedInfo = extractErrorInfoInPlainText(plainText, keywords)
34
      console.log(typeof extractedInfo);
35
      console.log(extractedInfo);
36
      console.log(extractedInfo["choices"]);
37
      console.log(extractedInfo["choices"][0]["message"]);
38
      let generatedMsg = extractedInfo["choices"][0]["message"]["content"];
39

40
      let extractedErrorInfo = extractErrorInfoFromChatGptMsg(generatedMsg);
41

42
      // 追加: START ---------------------------------------------------------------------
43
      valuesToWrite.push([
44
        maxNumber + i
45
        , generateFormulaForConId(colOfNumber, maxNumber + i + 1)
46
        , message.getDate()
47
        , message.getDate()
48
        , message.getSubject().replace(targetSubject, "")
49
        , extractedErrorInfo["info_list"][0]
50
        , extractedErrorInfo["info_list"][1]
51
        , extractedErrorInfo["info_list"][2]
52
      ]);
53
      message.markRead();
54
      console.log(message.isUnread());
55
      console.log(`writeErrorLog: 6666666666666666666666666666666666666666666666666666666666666666666`);
56
      // 追加: END ---------------------------------------------------------------------
57

58
    });
59
  });
60
  // 追加: START ---------------------------------------------------------------------
61
  console.log(valuesToWrite);
62
  console.log(`writeErrorLog: 777777777777777777777777777777777777777777777777777777777777777777`);
63
  sheet.getRange(maxNumber + 2, colOfNumber, valuesToWrite.length, valuesToWrite[0].length).setValues(valuesToWrite);
64
  // 追加: END ---------------------------------------------------------------------
65

66
  return true;
67
}

そしたら、こんな風にシートに書き込まれます。

5．運用コストがさぁ・・・#

これでツールは完成！

・・・ですが、実装する過程で 7 回くらい Chat Completions API にリクエストしたわけですが、

その直後に Developer Platform で消費したクレジットの額面を見てみると・・・

たったの7リクエストで 18 円も掛かっている・・・

例えば、 1 日に 3 通のエラーメッセージをシートに記録するとなると、 3 × 365 × 18 ÷ 7 ≒ 2815 円も年額として掛かりますよ！？うっ、うひゃあ・・・。

これは実際に運用するかどうかというのは、別問題になってくるぞ・・・

まとめ#

今回は、以下の流れでGmailの内容をGPT-4で抽出する処理を実装しました。

Gmail のメッセージを取得する
OpenAI の Chat Completions API を使う
Parserで欲しい情報を抽出する
スプレッドシートに記録する

Gmail に届くメッセージから必要な情報を効率的に抽出することは、日々の業務効率化に大きく寄与します。 Gmail API と OpenAI API を組み合わせることで、メール管理の自動化が可能となり、重要な情報を見逃すリスクを減らすことができるでしょう。

しかし、お財布と相談するのを忘れずに。

おしまい#

リサちゃん

記録できたぞ

135ml

財布的に、年がら年中は使えんかもなあ・・・

以上になります！

音楽

音楽

はじまり#

今回やりたいこと#

手順#

1．Gmailのメッセージの取得#

2．OpenAIのChat Completions APIを使う#

3．Parserで欲しい情報を抽出する#

4．スプレッドシートに記録する#

5．運用コストがさぁ・・・#

まとめ#

おしまい#

記事を共有

音楽

目次