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

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

Gmailには、顧客、サプライヤー、社内チームとのやり取りが集まります。ここに接続された自律型エージェントは、単発の指示に応じるだけではありません。継続的に稼働し、受け取った指示に応じて、ツールコーリングを通じてメッセージを検索するか、分類するか、返信を準備するかを自ら判断します。

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

これにより、サポート仕分けやサポート自動化のエージェントが行う処理に近い、サポート受信箱の仕分けのような業務が実現します。新着メッセージを受け取るたびに、人間がチャットの会話を開くのを待つことなく返信を準備します。GmailはAtakoのスタンダードプランに含まれるインテグレーションの一つで、コネクタごとの個別の課金項目はありません。

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

このコネクタで最も機微なアクションはsend_emailです。書き込みスコープで一度付与されると、エージェントはあなたを介さず直接送信します。最も安全な運用は、create_draftのみを付与することです。エージェントが準備し、人間が確認したうえでsend_draftで送信を実行します。

gmail.modifyスコープは、接続された受信箱全体をカバーし、特定のラベルや領域に限定されません。したがって実際の制限はgrant側で設けることになります。接続時にすべてを一度に付与するのではなく、エージェントに必要な正確なアクションだけをリストしてください。

ドキュメントには、Gmailコネクタ固有のレート制限に関する記載はありません。送信・拒否を問わず、各呼び出しはエージェントページの監査ログで確認できます。また、OAuthアカウント一般と同様に、Google側でトークンが失効または取り消された場合、接続は再接続するまでエラー状態になります。