Skip to content

连接器:让它真的能收发你的邮件 ​

没有连接器,智能体只会聊天。接上连接器,它才有账号可用——能翻你的邮箱、读你的笔记、往飞书里写东西。

什么时候需要它:你希望它做的这件事,必须动一个「外面的系统」才算做完。比如「把今天的邮件过一遍,有账单的挑出来」——它得先能进邮箱。

连接器本身不做这些事,它只干一件:替你保管账号凭证,让智能体在需要时拿到。真正动手的是连接器下面挂的那几个「工具」。

一、先分清两个页面 ​

同样叫「连接器」,进去的地方不同,干的事完全不同。这一节先分清,后面就不会走错。

你在哪这个页面干什么什么时候来
左侧「专家·技能·连接器」→ 左栏「连接器」货架。看有哪些连接器、把某个打开第一次接邮箱、找飞书
左侧「团队·项目·开放·自动化」→ 左栏「连接器」清单。看自己有哪些、改了哪个、删掉哪个排查、修改凭证、看工具

第一个页面长得像商店,第二个页面是一张表。平时用第一个就够了,第二个是管理和排查用的。

连接器广场:顶部三个视图(系统广场 / 团队空间 / 已连接的),下面是分类和卡片。已连接的在右上角显示绿色开关

卡片上四样东西值得看:名称、一个 bg 之类的分类小标签、绿点或灰点(连没连上)、右上角那个开关。

二、把一个邮箱接进来 ​

这里用「邮件收发」举例——它在「系统广场」的分类「办公提效」里。你要接 QQ 邮箱也可以直接点「QQ 邮箱」那张卡,字段更少,因为常见的服务器地址已经替你填好了。

第一步:把鼠标放到卡片上,点「连接」

未连接的卡片平时不显示按钮,鼠标移上去才出现「连接」。

第二步:照着填

连接设置弹窗:上面是连接器名称,中间一排带红星的凭证字段,底部是「加密保存并连接」

一共八项,每项输入框里的灰字就是填写要求,照着来:

填什么一般人怎么填
SMTP 服务器地址QQ 邮箱 smtp.qq.com;163 smtp.163.com;企业邮箱问管理员
SMTP 端口配合下面的加密方式:SSL 填 465,STARTTLS 填 587,明文填 25
加密方式选 ssl;服务器不支持再试 starttls
登录用户名通常就是完整邮箱地址
密码 / 授权码不是邮箱登录密码,见下面的提示
发件人邮箱一般和登录用户名一样
发件人显示名收件人看到的署名,比如「张三」或「财务部」
校验证书填 true;单位内网自签名服务器才填 false

最上面的「连接名称」可以不填,不填就用连接器自己的名字。只有当你要给同一个连接器建第二条连接(公司邮箱 + 个人邮箱这种)时,才需要起个名字区分。

授权码不是登录密码

QQ 邮箱、163 这类服务不接受邮箱密码。要先去网页版邮箱的设置里开启 IMAP/SMTP 服务,生成一串授权码,把那串码填进「密码 / 授权码」。

这一步卡住的人最多。填邮箱密码会一直报连接失败,而且看不出原因。

第三步:点「加密保存并连接」

成功后回到列表,那张卡的开关变成绿色、状态变成「已连接」。

三、接完怎么确认它真能用 ​

接上不等于能用。 这一步别跳,跳了后面就会一直在猜「到底哪坏了」。

回到「团队·项目·开放·自动化 → 连接器」,这里一张表列着你所有的连接器:

连接器清单:一行一个连接器,能看到认证方式、工具数、启用状态、连接状态和更新时间

「工具数」这一列先看一眼——它是 0 的话,接上也什么都干不了。找到刚接的那个,点「查看」:

连接器详情:上面是认证方式和连接状态,下面是这个连接器带的工具列表,每个工具都能单独「调试」

这张图里是 Obsidian 那个连接器,它的「工具数」是 8,展开就是这 8 个动作:检查连接、列出根目录、读取笔记、搜索笔记、写入笔记……智能体能做的事,就是这张表里的这些事,不多不少。

先跑一次「检查连接」。每个连接器的工具列表里基本都有一个只读的检查项(get_status 之类),点它右边的「调试」单独跑一遍。这一步不消耗什么,也不改动数据,能立刻告诉你凭证到底通不通。

get_status 能跑通,说明凭证没问题;跑不通,往下看第四节。

四、让它动手做点小事 ​

确认工具能跑通之后,回到对话里正常说需求就行。它会在需要的时候自己去调。

第一次用它做事,建议挑一件只读、且你能一眼验证对错的小事,比如:

text
先看看我邮箱里今天收到了几封邮件,把发件人和标题列出来。
不用点开,也不用回复任何东西。

让它先做只读的事有两个好处:万一凭证或权限有问题,你能马上发现;而且不会真的发出去一封不该发的邮件。

确认读没问题了,再让它写:

text
给张三发一封邮件,主题「周三的会议改到下午三点」。
正文三行以内,说清改时间和原因就行。
发之前先把这封邮件的内容给我看一眼,我确认了你再发。

最后那句「发之前先给我看一眼」值得每次都加。发邮件这类动作出了问题收不回来。

五、突然连不上了怎么办 ​

最常见的三种情况,按顺序排查:

  1. 先跑一次「检查连接」(第三节那个调试)。不通,就是凭证的问题,跟网络无关。
  2. 授权码被重置了。改过邮箱密码、在邮箱设置里重新生成过授权码,旧的立刻失效。这时重新连一次,把新授权码填进去。
  3. 服务器地址或端口变了。企业邮箱换服务商、换端口的情况不少,问一下管理员。

改完不用删掉重建,点那个连接器旁边的「编辑」改掉对应那一项就行——但密码类字段通常要重新填一遍。

一个账号接多个连接器

同一个邮箱可能既需要「邮件收发」(发信)又需要「QQ 邮箱」(读收件箱),这两个是不同连接器,各接一次即可,凭证各存一份。

六、什么时候需要自己做一个连接器 ​

系统广场里没有你要接的那个系统,才需要自己做。入口在管理列表页右上角的「新增连接器」:

新增连接器:填 SERVICE 标识、显示名称、BASE URL、认证方式、分类和标签,底部是「创建连接器」

要填的东西里,只有两个是真需要想清楚的:

  • BASE URL:你要调的那个服务的地址。
  • 认证方式:免鉴权 / Bearer 之类。选完之后下面的「认证配置」会跟着变,要你填哪些字段也跟着变。

创建出来只是个空壳,还得进「工具列表」点「添加工具」,一个一个把要调用的接口写进去(工具名称、ACTIONKEY、说明、接口类型)。这一步是开发活,不是配置活,接自己的内部系统时才有必要。

如果只是想把这台机器上配好的连接器搬到另一台,用「导出」拿到一个 JSON,过去之后「导入」粘贴进去就行,不用重填。

七、几条容易踩的 ​

  • 凭证是敏感数据。 别把它写进提示词、文档或者代码里,也别截图发出去。填一次就够了,之后智能体自己取。
  • 断开之前先想想谁在用。 正在跑的定时任务如果依赖它,断开后那次会直接失败。
  • 连接器是空间里的东西。 你在个人空间接的,换到团队空间不一定能看到,需要在那边再接一次。
  • 页面上的分类名、字段名以你看到的为准。 这篇截图取自一个真实账号,图标和分类标签会随版本调整。