---
id: "asgard-ext-gmail"
lang: "zh-TW"
name: "Gmail"
vendor: "Google"
product: "Gmail"
category: "communication"
summary: "讓 Agent 使用 Gmail：搜尋與讀信、擬草稿或寄出回覆、加標籤或封存；可以用共用信箱，也能讓每位終端用戶（例如組織成員）用自己的。"
url: "https://www.asgard-ai.com/zh/extensions/asgard-ext-gmail"
docs: "https://developers.google.com/workspace/gmail/api"
source: null
usages: ["build-time","shared-account","personal-account"]
produces: ["OAuthProvider","OAuthCredential","Workflow","Toolset","SkillSet","Agent"]
requires: {"asgard_cli":">=0.2.1","skills":[],"extensions":[],"platform":["connector"]}
command: "asgard-cli extension get asgard-ext-gmail"
handoff: "請用 asgard-cli 取得 asgard-ext-gmail 這個 Extension，帶我判斷要走哪幾條路線，再開始導入。"
updated: "2026-11-05"
---

# Gmail

讓 Asgard 的 Agent 使用 Gmail：搜尋與讀取信件和附件、擬草稿、寄信或回信，以及加標籤、封存、標為已讀。可以用共用帳號（例如組織帳號）處理一個共用信箱（例如客服或業務信箱），也可以讓每位終端用戶（例如組織成員）處理自己的信箱。能做哪些事在設計部署時決定；會寄出信的動作一律先確認。

## 支援的用法

| 用法 | 說明 |
|---|---|
| 設計期 | 設計部署時，FDE Agent 先看信箱：有哪些標籤、信件量多少、從哪裡寄來、附件是什麼類型，不留下信件內容 |
| 共用信箱（登入授權一次） | 上線後，Agent 用共用帳號（例如組織帳號，建議系統專用帳號）處理一個共用信箱。用那個帳號登入授權一次；帳號的鑰匙存在平台，終端用戶和 AI 都拿不到 |
| 共用信箱（管理員委派） | 一樣是處理一個共用信箱，但不用登入授權，改由 Google Workspace 管理員讓一個服務帳號代表那個信箱。沒有人要按「允許」，帳號改密碼也不會斷 |
| 個人信箱 | 每位終端用戶在 Sindri 用自己的 Google 帳號連一次，Agent 只讀、只擬草稿或只寄出他自己信箱的信；鑰匙由 Asgard 替每個人保管 |

## 要準備什麼

- Google Workspace。組織外的信箱（個人的 @gmail.com）這一版還沒有。
- 一個 Google Cloud 專案與 OAuth client；選管理員委派的話是一個服務帳號。沒有的話，FDE Agent 會一步一步帶著建（大約 15 分鐘）；有 Workspace 可以設成「內部」，不用送 Google 審核。
- 共用信箱：那個信箱的帳號，最好是系統專用的。管理員委派：一位 Google Workspace 超級管理員，在管理控制台授權一次。
- 個人信箱：每位終端用戶第一次用的時候自己按一次「允許」。