ATAKO

コミュニケーション

GmailをAIエージェントに接続する

Gmailには顧客や社内とのやり取りが集まります。Gmailコネクタは近日公開予定です。公開後、Atakoのエージェントは、Googleのパスワードを一切見ることなく、仕分け、下書き作成、受信箱の整理を行えるようになります。

Atakoのエージェントが執筆 · 確認・承認者 Romain Laodicina · Atako CTO

近日公開 — アカウントを作成すると、この連携の準備が整い次第お知らせします。

想定されるワークフロー

共有サポート受信箱の仕分けと返信下書き

support@ の受信箱には1日に数十通のメッセージが届きます。エージェントはlist_messagesで未読メッセージを一覧にし、add_label_to_messageでラベル別(請求、バグ、一般的な質問)に仕分け、明確な依頼ごとにcreate_draftで返信の下書きを作成する予定です。人間が確認し、send_draftで送信します。send_emailは、その権限が明示的に付与された場合にのみ使います。

受信箱の定期的な整理

ニュースレター、自動通知、開封確認。エージェントはsearch_messages(例: from:noreply)でこれらを検索し、list_labelsでラベルを確認し、メインの受信箱にたまる前にtrash_messageでゴミ箱へ移す予定です。毎朝10分の手作業による仕分けなしで、受信箱を読みやすく保てます。

フォローアップが必要な顧客スレッドの追跡

エージェントはsearch_messagesで3日以上返信のないスレッドを探し、get_threadで全文脈を取得し、add_label_to_messageでラベルを付け、create_draftでフォローアップの下書きを用意する予定です。人間の承認なしには何も送信されません。フォローアップを当日中に送れるよう準備を整えます。

コネクタのアクション

  • list_messages

    読み取り。メッセージのIDを一覧表示する。ラベルで絞り込み可能。

  • search_messages

    読み取り。Gmailのクエリでメッセージを検索する。

  • get_message

    読み取り。ヘッダーと本文を含む、メッセージ全体を取得する。

  • get_thread

    読み取り。会話スレッド全体を取得する。

  • list_drafts

    読み取り。既存の下書きを一覧表示する。

  • create_draft

    書き込み。送信せずに返信の下書きを作成する。

  • send_draft

    書き込み。既存の下書きを送信する。

  • send_email

    書き込み。接続済みアカウントから直接メールを送信する。

  • add_label_to_message

    書き込み。メッセージにラベルを追加する。

  • trash_message

    書き込み。メッセージをゴミ箱に移動する。

前提条件

  • インテグレーションを接続するための、Atako企業アカウントの管理者権限。
  • 接続する受信箱を持つGmailまたはGoogle Workspaceアカウント。
  • Google OAuthの同意。スコープはhttps://www.googleapis.com/auth/gmail.modify。
  • エージェントごとの明示的なgrant。特にsend_emailアクションについて。

接続方法

  1. 1

    コンテキスト → 連携を開く

    コネクタの公開後、管理者がコネクタ一覧からGmailを選択します。

  2. 2

    公開されるアクションを確認する

    承認前に、send_emailを含む読み取り・書き込みのすべてのアクションが表示されます。

  3. 3

    Googleの画面で認証する

    Googleの同意画面へリダイレクトされます。Atakoにパスワードは送信されません。

  4. 4

    エージェントにアクセス権を付与する

    エージェントごとに具体的なアクションを選びます。慎重に進めるならcreate_draftのみなど。

自律型エージェントをGmailに接続する理由

Gmailコネクタはまだ利用できません。このページでは、公開後にできることを説明します。

Gmailには顧客、取引先、チームとのやり取りが集まります。Gmailに接続した自律型エージェントは、単発の指示に応えるだけではありません。常時稼働し、受け取った指示に応じて、メッセージの検索、分類、返信の準備をツール呼び出しによって自ら判断します。イベントごとに一度動いて止まるトリガー型の自動化ツールとは異なり、受信箱全体を自力で処理していきます。

接続にはOAuth 2.0とスコープ https://www.googleapis.com/auth/gmail.modify を使う予定です(GoogleのGmailスコープ)。このスコープでは読み取り、作成、送信ができますが、メッセージを即時に完全削除することはできません。

これにより、サポート受信箱の仕分けのようなフローが役立ちます。サポートのトリアージやサポート自動化のエージェントに近い働きで、新着メッセージを受け取るたびに、人間が会話を開くのを待たずに返信を準備します。GmailはStandardプランに含まれる連携のひとつになり、コネクタごとの別請求はありません。

制限とベストプラクティス

このコネクタで最も機微なアクションはsend_emailになります。書き込みスコープで付与すると、エージェントはあなたを介さず送信します。最も安全なのはcreate_draftのみを付与する運用です。エージェントが準備し、人間が確認してsend_draftで送信します。下書きを承認する前に宛先、件名、添付を確認してください。send_draftを実行するとメールはすぐに送信され、取り消せません。

gmail.modifyスコープは特定のラベルではなく、接続した受信箱全体に及びます。実際の制限は権限で決まるため、接続時にすべてをまとめて付与せず、エージェントに必要なアクションだけを指定してください。

実行・拒否を問わず、すべての呼び出しはエージェントページの監査ログで確認できるようになります。ほかのOAuthアカウントと同様、Google側でトークンが期限切れまたは取り消しになると、再接続するまで接続はエラー状態になります。接続したアカウントには、コネクタとは別にGoogleが定めるGmailの送信上限もかかります。自動送信は短時間に集中させず、1日の中で分散させてください。

Atakoのほかの連携と同じく、接続しただけではアクセスは付与されません。管理者が具体的なアクションとスコープを選ぶまで、エージェントは何も使えません。この既定拒否の方針により、あるエージェントにはcreate_draftのみ、より限定的な役割の別のエージェントにはsend_emailも付与する、といった使い分けが可能になります。

関連するユースケース

関連する連携機能

Atakoのエージェントが執筆 · 確認・承認者 Romain Laodicina · Atako CTO

よくある質問

エージェントは承認なしで私の代わりにメールを送信できるようになりますか?

権限に書き込みスコープのsend_emailが含まれる場合のみです。その場合、エージェントは直接送信します。create_draftのみを付与すれば人間が確認に入ります。エージェントが返信を用意し、人間が確認してsend_draftで送信します。

GmailはStandardプランに含まれますか?

はい。ほかのすべての連携と同様に、GmailはStandardプランに含まれ、コネクタごとの追加料金はありません。

AtakoによるGmail受信箱へのアクセスはどう取り消しますか?

コンテキスト → 連携から、Gmail接続のRevokeで取り消します。暗号化されたトークンは即座に削除され、それを使っていたすべてのエージェントがただちにアクセスを失います。

gmail.modifyスコープでメールを完全に削除できるようになりますか?

いいえ。このGoogleのスコープで可能なのは読み取り、作成、送信、ゴミ箱への移動までで、メッセージを即時に完全削除することはできません。それにはコネクタが使う予定のスコープより広いスコープが必要です。

次に読む

出典

Romain Laodicina

Atako CTO

このコンテンツはAtakoのAIエージェントが執筆し、その後Atako CTOのRomain Laodicinaが確認・修正・承認しました。

最初のAIエージェントを導入

無料でアカウントを作成し、コード不要で数分でエージェントを起動できます。

ニュースレター

AIの最前線を 常にキャッチアップ。

新機能、新しいエージェント、当社のAI分析を直接受信箱にお届けします。スパムなし、いつでも配信停止できます。