Skip to main content

​
Gmail

ShanoneのGmail連携は、日常的なメッセージングに加えて、他の連携ではあまり扱われないメールボックス設定系のツール(フィルタ、転送、代理人、休暇の自動応答)まで含む52個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにGmail関連の作業を依頼(例: 「先月の請求書のメールを検索して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Googleアカウントを許可する

Shanoneに操作させたいメールボックスについて、GoogleのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、gmail_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはGmail向けに52個のツールを、以下のカテゴリに整理して提供しています。
gmail_send_message, gmail_get_message, gmail_list_messages, gmail_search, gmail_reply_to_message, gmail_trash_message, gmail_untrash_message, gmail_delete_message, gmail_batch_delete_messages, gmail_batch_modify_labels, gmail_modify_message_labels, gmail_import_message, gmail_insert_message, gmail_get_attachment
gmail_get_thread, gmail_list_threads, gmail_trash_thread, gmail_untrash_thread, gmail_delete_thread, gmail_modify_thread_labels
gmail_create_draft, gmail_get_draft, gmail_update_draft, gmail_delete_draft, gmail_list_drafts, gmail_send_draft
gmail_create_label, gmail_get_label, gmail_update_label, gmail_delete_label, gmail_list_labels
gmail_create_filter, gmail_get_filter, gmail_delete_filter, gmail_list_filters
gmail_get_vacation, gmail_update_vacation, gmail_get_auto_forwarding, gmail_list_forwarding_addresses, gmail_get_imap, gmail_get_pop, gmail_get_language, gmail_get_send_as, gmail_list_send_as
gmail_create_delegate, gmail_get_delegate, gmail_delete_delegate, gmail_list_delegates, gmail_get_profile
gmail_list_history, gmail_watch, gmail_stop

​
よくあるユースケース

受信トレイのトリアージ

未読メールを検索・要約し、返信案をレビュー用に作成する

参加者へのフォローアップ

カレンダーイベントやイベントプラットフォームから取得した参加者一人ひとりに、個別のメールを送る

自動転送の監査

転送アドレスやフィルタに不審なものがないか確認する

休暇の自動応答管理

旅行の日程に合わせて不在時応答をオン/オフする

​
トラブルシューティング

gmail_send_messageのshanone_get_tool_schemaで正確なペイロード形式を確認してください——宛先・件名・本文は通常、フラットなフィールドではなくMIME形式のネストされた構造の中に入っています。
gmail_watchには、接続先のGoogle Cloudプロジェクトに設定されたGoogle Cloud Pub/Subトピックが必要です。これはShanoneの範囲外のプロジェクトレベルの設定作業です。トピック設定を修正したらgmail_stopを呼び出し、gmail_watchを再実行してください。
キーワードフィルタリングに対応していないgmail_list_messagesではなく、Gmail独自の検索演算子(from:、after:、has:attachmentなど)を使ったgmail_searchを使用してください。