连接应用

Google 应用

连接你的 Google Drive、Gmail、Google 日历、Google 文档和 Google 表格,让 AI 可以使用它们;以及在自己运行的服务器上,管理员需要先设置什么。

Google Drive、Gmail、Google 日历、Google 文档和 Google 表格是 Trina AX 内置的。每个人连接自己的 Google 账号,每个应用连接一次。 AI 只会在这个人自己的对话中使用它,权限也和这个人在 Google 中的权限一样。

不需要复制或粘贴任何内容:你是在 Google 上登录的。

#连接 Google 应用(所有人)

提示

你需要准备的

  • 你的 Google 账号(公司的 Google Workspace 账号或个人 Gmail 账号),并已在浏览器中登录。
  1. 在连接器中打开应用

    点左侧栏底部你的头像,再点设置 › 连接器,然后在发现下选择应用(例如 Gmail)。它的页面会说明 AI 能做什么,并列出所有工具。

  2. 选择“连接”

    Google 自己的登录页面会打开(在桌面应用中,会在你的浏览器中打开)。选择你的账号。

  3. 保持所有选项都勾选

    Google 会列出 Trina AX 可以做的事,例如“阅读、撰写和发送电子邮件”。请保持所有选项都勾选,然后选择继续(Continue)。 如果有选项没有勾选,登录会被拒绝:“部分权限未勾选。请重新连接,并保持所有选项都勾选。”

  4. 确认账号

    回到 Trina AX,检查显示的账号(“连接此账号?”),然后选择确认此账号。页面会显示已连接为你的地址。

读取不需要确认。AI 在发送邮件、添加日程或编辑文档之前,会显示一张卡片,列出它要做的所有事,并等你同意。在卡片上,或者在应用的 设置(它的 ⋯ 菜单)中,你可以选择始终允许,而不是先问我。Google Drive 只读取:它从不更改、移动或发送任何内容。

#如果你看到“请管理员添加”

这个应用在你的团队中还没有设置好。选择请管理员添加:所有者和管理员会收到通知,你可以连接时会收到回复。

请管理员添加

#团队共享的 Google 账号(管理员)

共享的邮箱或日历,例如 sales@acme.com,可以为需要它的人连接一次。在管理 › 已连接的应用中打开这个 Google 应用,在 团队设置 › 共享的 Google 账号下选择为团队连接。用共享账号登录,然后选择谁使用它。Google Drive 在同一位置有 与团队共享。

#设置 Google 应用(自己运行服务器的管理员)

在由 Trina 托管的团队中,Google 登录已经准备好了:不需要设置。在公司自己运行的服务器上,需要管理员在 Google Cloud 中创建一次 Google 登录应用,再在管理 › 已连接的应用中添加它。

提示

你需要准备的

  • 团队服务器的公网 https 地址(大家从 Google 登录后会回到这个地址)。在设置好之前,Google 应用会显示“需要先设置这台服务器的公网地址。” 由运行服务器的人设置:见配置(英文)。
  • 一个 Google Cloud 项目、每个应用需要启用的 API,以及一个类型为 Web 应用(Web application)的登录客户端。
  • 从 Google Cloud 获取:客户端的 JSON 文件(或它的客户端 ID 和客户端密钥)。
  • 填到 Google Cloud 中:Trina AX 显示的返回地址,一个给 Google Drive,一个给另外四个应用。
Gmail,尚未设置
  1. 在 Google Cloud 中创建应用

    按照公司应用页面上的在 Google Cloud 中操作:一个项目、几个 API、应用的名称和受众群体 (使用 Google Workspace 的公司选内部(Internal);否则选外部(External)并添加测试用户)、权限,以及一个 Web 应用(Web application)客户端。

  2. 添加返回地址

    在客户端的已获授权的重定向 URI(Authorized redirect URIs)下,添加每个应用的设置对话框中显示的地址,用它的复制按钮复制:

    https://<your team address>/api/integrations/google-drive/callback
    https://<your team address>/api/integrations/google-apps/callback
    
  3. 在 Trina AX 中上传文件

    在管理 › 已连接的应用中打开 Google Drive,选择设置。上传你下载的 JSON 文件,或粘贴客户端 ID 和客户端密钥, 然后保存。接着逐个打开 Gmail、Google 日历、文档和表格,选择设置并打开使用与 Google Drive 相同的 Google 应用:不需要再上传别的。

每个应用的页面会在 Google API 下列出需要为它启用的 API:

应用需要启用的 Google API
Google DriveGoogle Drive API
GmailGmail API
Google 日历Google Calendar API
Google 文档Google Docs API、Google Drive API
Google 表格Google Sheets API、Google Drive API

Gmail、日历、文档和表格应用运行在 Linux 服务器上。在 Mac 应用中,它们的页面会显示“团队服务器暂不支持”。

#在 Google 的页面上显示公司名称

使用 Google Workspace 的公司可以让所有 Google 应用都通过公司自己的 Google 应用登录,这样大家在 Google 的页面上会看到公司名称, 不会出现警告:使用公司自己的 Google 应用。

#常见问题

你看到的该怎么做
部分权限未勾选。请重新连接,并保持所有选项都勾选。重新连接,并让 Google 页面上的所有选项都保持勾选。
Google 要求你重新登录。在应用的页面上选择重新连接。这通常发生在修改密码之后,或者公司管理员取消了访问权限。
Google 页面上出现 redirect_uri_mismatch(自己运行的服务器)Google Cloud 中的某个返回地址和 Trina AX 显示的不一样。请从设置对话框中重新复制。
“This app is blocked” 或 admin_policy_enforced公司的 Google 管理员限制了哪些应用可以使用 Google 账号。请他们信任这个应用:见在管理控制台信任应用。
Google hasn't verified this app这是处于测试(Testing)状态的外部(External)应用。只有当应用是你的管理员创建的时,才选择 Advanced › Go to …;或者请他们改用公司自己的应用。

面向开发者和运维人员的完整说明:Google 应用(英文)和 Google Drive(英文)。

Trina AX 是采用 AGPL-3.0-only 许可的自由软件。图标:Lucide(ISC)。 编辑此页