Skip to content

渠道接入

Investment Agent 支持通过即时通讯渠道接入,让你在微信、飞书上直接与投资助手对话。

微信渠道

通过腾讯 iLink Bot API 接入个人微信账号,使用长轮询模式,无需绑定 Webhook 地址。

飞书渠道

通过飞书开放平台官方 SDK 建立 WebSocket 长连接,以企业自建应用/机器人与你对话。

Web 界面

基于聊天的 AI 交互界面,可从任何浏览器访问。

所有渠道共用同一套 Agent 引擎与业务工具,接入后即可在对应平台使用投资分析、资产查询、笔记搜索等能力。会话上下文按渠道隔离,各渠道之间互不干扰。

微信渠道通过腾讯 iLink 接口接入个人微信账号,服务启动后自动建立长轮询连接并持续接收消息。

在应用左侧导航栏进入 设置 → 渠道 → 微信个人号:

  1. 点击 扫码登录(推荐),使用微信扫描二维码完成授权,系统会自动读取并保存凭证;
  2. 或在 手动填写凭证(备用) 区域直接填入下方配置项;
  3. 点击 保存配置。

保存后服务将自动连接。当凭证缺失或无效时,渠道会安全跳过,不会影响应用其它功能。

配置项环境变量说明
Bot TokenWEIXIN_TOKENiLink 接口的访问令牌
Account IDWEIXIN_ACCOUNT_IDiLink Bot Account ID
API Base URLWEIXIN_BASE_URLiLink 服务端点,默认 https://ilinkai.weixin.qq.com
白名单用户 IDWEIXIN_ALLOWED_USERS逗号分隔的用户 ID 列表,留空对所有好友开放

在微信对话中输入以下命令管理会话:

命令说明
/clear清空当前会话上下文,重新开始对话

飞书通过官方 WebSocket 长连接接入飞书开放平台,机器人消息实时送达,无需配置公网 Webhook 地址。

在设置左侧导航 设置 → 渠道 → 飞书机器人,可通过两种方式接入,推荐使用扫码创建:

  1. 点击 扫码创建飞书机器人 下的 开始授权;

  2. 使用飞书 App 扫描二维码(或点击 在浏览器中打开)完成授权;

  3. 授权完成后自动保存凭据,并允许当前飞书用户私聊机器人。

保存后渠道服务会自动重连生效。

配置项环境变量说明
启用飞书渠道FEISHU_ENABLEDtrue 时启用 WebSocket 长连接
App IDFEISHU_APP_ID飞书开放平台应用的 App ID(cli_…)
App SecretFEISHU_APP_SECRET仅在本地持久化,不对外返回
平台FEISHU_DOMAINfeishu 或 lark,对应不同的开放平台域名;默认 feishu,非 UI 输入框,通过环境变量设置
私聊开放 IDFEISHU_ALLOWED_USERS允许私聊的 open_id,逗号分隔
群聊 chat_idFEISHU_ALLOWED_CHATS允许群聊的 chat_id,逗号分隔

支持与微信渠道相同的命令:

命令说明
/clear清空当前会话上下文

两个渠道都在 src/instrumentation.ts(register())中通过非阻塞后台启动方式拉起,服务进程启动时自动连接。

  • 微信:startWeixinChannel()
  • 飞书:startFeishuChannel()
维度微信(iLink)飞书(WebSocket)
传输模式HTTP 长轮询(Poll)官方 WebSocket 长连接
Webhook不需要不需要
消息格式iLink 协议文本飞书交互消息(interactive 卡片)
心跳 / 重连由 iLink 轮询会话维护SDK 自动心跳、自动重连

渠道配置与状态通过以下 HTTP 接口管理:

  • GET /api/channel/feishu:读取飞书配置与连接状态
  • PUT /api/channel/feishu:保存飞书配置并触发重启
  • POST /api/channel/feishu:手动 start / stop / restart 渠道
  • POST /api/channel/feishu/register:扫码创建飞书机器人(start / poll / cancel)
  • GET /api/channel/weixin/qr:微信扫码登录