连接并管理集成
集成可将 Atoms 连接到您已在使用的工具和服务。根据连接器的不同,Atoms 可以在帮助您构建、为您已发布的应用添加能力,或同时支持这两种工作流时使用外部信息。
集成可将 Atoms 连接到您已在使用的工具和服务。根据连接器的不同,Atoms 可以在帮助您构建、为您已发布的应用添加能力,或同时支持这两种工作流时使用外部信息。
每个连接器都支持其各自的操作和权限。请查看已连接连接器显示的能力和权限范围;未连接的详情面板可能只显示其说明和连接控件。
请使用能够完成任务的最小权限账户和权限范围。不要将密码、访问令牌、私钥或无关的敏感数据粘贴到提示词中。当某项服务包含生产数据或客户数据时,请先使用非敏感样本进行测试,并在允许写入前核实准确的目标。
您看到的连接器和操作可能会因账户和发布版本而异。在 Atoms 中打开连接器目录,以查看当前可供您使用的内容。
确定连接应执行的操作
在连接某项服务之前,请先确定您需要将其用于何处。
目标 | 示例 |
|---|---|
在您构建时为智能体提供上下文 | 查找文件、汇总任务、审查问题,或在提示词中使用项目数据 |
让智能体在另一项服务中执行操作 | 创建任务、更新记录、添加电子表格数据,或创建日历事件 |
为已发布的应用添加服务 | 存储应用数据、处理身份验证、处理支付,或运行应用工作流 |
某些连接器支持多个目标。在连接之前,请查看连接器说明和所请求的权限。
连接集成
打开 设置 → 连接器 以使用主要入口。您也可以从仪表板中选择 将您的工具连接到 Atoms。
连接或断开集成可能需要工作区所有者或已授权管理员访问权限。如果您不是所有者或管理员,且某个控件不可用,请联系工作区所有者或已授权管理员。
从仪表板
- 打开 Atoms 仪表板。
- 选择 将您的工具连接到 Atoms。
- 选择您想使用的连接器。按照该连接器卡片上显示的连接控件进行操作。
- 使用该连接器显示的控件。如果它打开的是通用详情面板,请选择 Connect;特定提供商的集成可能会打开其自己的设置或授权流程。
- 如果出现提示,请登录外部服务。
- 查看账户和权限,然后批准连接。
- 返回 Atoms 并确认连接器显示为已连接。在您想使用它的 Chat 中,打开连接器选择器并为该 Chat 启用该连接器。
使用已连接的集成
告诉智能体要使用哪项服务,并提供足够的细节以识别正确的项目。有用的细节包括:
- 项目、工作区、仓库、文件夹、日历或电子表格名称
- 任务名称、问题 ID、文件名或记录标识符
- 日期范围、截止日期、负责人、状态或优先级
- 您希望 Atoms 读取、汇总、创建或更新的内容
例如:
- “汇总分配给我的高优先级 Linear 问题。”
- “在 Drive 中找到发布简报并列出尚未决定的事项。”
- “将这些已批准的潜在客户添加到营销活动电子表格中。”
- “为下周二下午 3 点的设计评审创建一个日历事件。”
Atoms 只能使用连接器支持的操作以及已连接账户可访问的数据。如果该连接器未显示您需要的能力或操作,请停止操作,不要假设其受支持。
在执行前审查外部更改
当某个连接器和操作支持创建或更新外部数据时,Atoms 可能会在执行前显示确认信息。
请检查:
- 服务和已连接账户
- 目标文件、电子表格、日历、项目或记录
- 将要创建或更改的信息
- 任何日期、时间、收件人或其他重要值
如果 Atoms 显示确认信息,请检查后选择 Confirm 继续,或选择取消以保持外部服务不变。写入可用性取决于连接器和操作;只读连接器不提供写入操作。
写入后,请先在外部服务中验证结果,再尝试重试。如果目标或数值有误,请停止工作流,并在可用时使用提供商自己的历史记录、撤销或恢复工具。断开连接器会停止未来的使用;它不会撤销已做出的更改。
管理连接
打开连接器目录并选择一个已连接的服务,以查看其当前状态。
在连接器详情面板中,您可能可以:
- 检查已连接的是哪个账户
- 查看连接器支持的操作和权限范围
- 在授权过期时重新连接
- 在服务支持时刷新或更改访问权限
- 将账户与 Atoms 断开连接
在 Atoms 中断开连接会停止未来使用该连接。某些服务还可能要求您在该服务自己的账户或安全设置中撤销 Atoms 的访问权限。
按使用场景划分的示例
下表是按使用场景进行的编辑分组,并非目录分类集合。请使用可搜索的目录查看当前可用连接器列表。
类别 | 常见用途 | 示例 |
|---|---|---|
开发 | 源代码控制、仓库、问题和交付工作流 | GitHub, Linear |
后端和数据 | 数据库、身份验证、存储和结构化数据 | Supabase |
支付 | 结账、账单和支付工作流 | Stripe |
工作管理 | 任务、项目、负责人和截止日期 | Asana, Todoist |
文件和内容 | 搜索、读取和整理外部文件 | Box, Dropbox |
分析和营销 | 流量、搜索表现、营销活动和报告 | Google Analytics 4, Google Search Console, Google Ads |
连接器可用性会随时间变化。请使用 Atoms 中的目录查看当前列表,并打开连接器以查看其确切能力。
设置指南
请选择适用于您服务的指南:
如遇连接问题,请参阅 集成故障排查。