> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vecbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 飞书 (Feishu)

> 将 Agent 接入飞书，作为企业自建应用

# 飞书接入指南

将 Vecbase Agent 接入飞书，团队成员可以在群聊和私聊中与 Agent 互动。

<Warning>
  目前仅支持**飞书**（feishu.cn），暂不支持国际版 Lark（larksuite.com）。
</Warning>

## 前置条件

* 飞书管理员账号（或有权创建应用的账号）
* 已创建 Vecbase Agent

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

<Steps>
  <Step title="进入开放平台">
    打开 [飞书开放平台](https://open.feishu.cn/)，使用飞书账号登录。
  </Step>

  <Step title="创建应用">
    点击 **创建企业自建应用**。填写应用名称和描述。
  </Step>

  <Step title="获取凭证">
    在 **凭证与基础信息** 页面，找到：

    * **App ID**: `cli_xxxxxxxxx`
    * **App Secret**: `xxxxxxxxxxxxxxxx`
  </Step>
</Steps>

## 第二步：启用机器人能力

<Steps>
  <Step title="添加应用能力">
    在左侧导航找到 **应用能力** → **机器人**，点击 **启用**。
  </Step>

  <Step title="配置权限">
    在 **权限管理** 中，添加以下权限：

    | 权限                           | 说明                  |
    | ---------------------------- | ------------------- |
    | `im:message`                 | 发送和接收消息             |
    | `im:message.group_at_msg`    | 接收群聊 @消息            |
    | `im:resource`                | 收发文件和图片             |
    | `contact:user.base:readonly` | 读取用户基本信息（用于显示发送者名字） |
  </Step>

  <Step title="发布应用">
    进入 **版本管理与发布**，创建一个版本并提交审核。

    <Info>
      企业内部应用通常会自动通过审核。如果是 ISV 应用，需要等待管理员审批。
    </Info>
  </Step>
</Steps>

## 第三步：在 Vecbase 中连接

<Steps>
  <Step title="打开 Agent 设置">
    打开你的 Agent，点击右上角的 **设置**，然后选择 **通道**。
  </Step>

  <Step title="添加飞书通道">
    点击 **飞书** 旁边的 **添加通道**。
  </Step>

  <Step title="填写凭证">
    * **显示名称**: 给通道取个名字（如 "办公助手"）
    * **App ID**: 从开放平台复制
    * **App Secret**: 从开放平台复制
  </Step>

  <Step title="创建">
    点击 **创建**。状态变为 **Connected** 即连接成功。
  </Step>
</Steps>

## 第四步：测试

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

### 私聊

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

### 群聊

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

## 飞书特色功能

连接飞书后，你的 Agent 还能自动操作飞书办公套件：

| 功能   | 说明               |
| ---- | ---------------- |
| 飞书文档 | 创建、读取、编辑飞书文档     |
| 多维表格 | 查询和写入 Bitable 数据 |
| 知识库  | 浏览和管理 Wiki 页面    |
| 云文档  | 管理飞书云盘文件         |
| 权限管理 | 设置文档共享权限         |

只需在对话中告诉 Agent 你想做什么，例如"帮我创建一个会议纪要文档"，Agent 会自动完成。

<Tip>
  这些功能需要在飞书开放平台为应用添加对应的 API 权限。
</Tip>