Skip to main content

飞书接入指南

将 Vecbase Agent 接入飞书,团队成员可以在群聊和私聊中与 Agent 互动。
目前仅支持飞书(feishu.cn),暂不支持国际版 Lark(larksuite.com)。

前置条件

  • 飞书管理员账号(或有权创建应用的账号)
  • 已创建 Vecbase Agent

第一步:在飞书开放平台创建应用

1

进入开放平台

打开 飞书开放平台,使用飞书账号登录。
2

创建应用

点击 创建企业自建应用。填写应用名称和描述。
3

获取凭证

凭证与基础信息 页面,找到:
  • App ID: cli_xxxxxxxxx
  • App Secret: xxxxxxxxxxxxxxxx
App ID:     cli_a9005fd237f85cb5
App Secret: ih8jvPIlxeeyUvC5PzOrBcFDwtxQKPFs

第二步:启用机器人能力

1

添加应用能力

在左侧导航找到 应用能力机器人,点击 启用
2

配置权限

权限管理 中,添加以下权限:
权限说明
im:message发送和接收消息
im:message.group_at_msg接收群聊 @消息
im:resource收发文件和图片
contact:user.base:readonly读取用户基本信息(用于显示发送者名字)
3

发布应用

进入 版本管理与发布,创建一个版本并提交审核。
企业内部应用通常会自动通过审核。如果是 ISV 应用,需要等待管理员审批。

第三步:在 Vecbase 中连接

1

打开 Agent 设置

进入 Agent 页面 → 点击 齿轮图标通道 标签页。
2

添加飞书通道

点击 飞书 旁边的 添加通道
3

填写凭证

  • 显示名称: 给通道取个名字(如 “办公助手”)
  • App ID: 从开放平台复制
  • App Secret: 从开放平台复制
4

创建

点击 创建。状态变为 Connected 即连接成功。

第四步:测试

在飞书中找到你的机器人(搜索应用名称),发送一条消息。Agent 会自动回复。

私聊

直接给机器人发消息即可。

群聊

  1. 将机器人添加到群聊
  2. 在群里 @机器人名称 发送消息
  3. Agent 会回复到群聊中

飞书特色功能

连接飞书后,你的 Agent 还能自动操作飞书办公套件:
功能说明
飞书文档创建、读取、编辑飞书文档
多维表格查询和写入 Bitable 数据
知识库浏览和管理 Wiki 页面
云文档管理飞书云盘文件
权限管理设置文档共享权限
只需在对话中告诉 Agent 你想做什么,例如”帮我创建一个会议纪要文档”,Agent 会自动完成。
这些功能需要在飞书开放平台为应用添加对应的 API 权限。