Boss-AGI

主题

Skill 清单 ​

飞书多维表格场景的全部能力定义。 场景概览见 多维表格，角色场景见 角色场景。

架构总览 ​

Skill / Tool 汇总 ​

层级名称描述底层飞书 API权限 Scope状态
Afeishu_bitable Skill飞书多维表格 AI 对话技能——🔲 待开发
Bquery_bitable按条件查询多维表格记录POST /bitable/v1/apps/:app_token/tables/:table_id/records/searchbase:record:retrieve / bitable:app:readonly🔲 待开发
Bcreate_bitable_record新建一条记录POST /bitable/v1/apps/:app_token/tables/:table_id/recordsbase:record:create / bitable:app🔲 待开发
Bupdate_bitable_record更新指定记录的字段值PUT /bitable/v1/apps/:app_token/tables/:table_id/records/:record_idbase:record:update / bitable:app🔲 待开发
Bdelete_bitable_record删除指定记录DELETE /bitable/v1/apps/:app_token/tables/:table_id/records/:record_idbase:record:delete / bitable:app🔲 待开发
Bget_bitable_meta获取多维表格元信息GET .../apps/:app_token + GET .../tables + GET .../fieldsbase:app:read / base:table:read / base:field:read / bitable:app:readonly🔲 待开发

A 层 — Skill 定义 ​

feishu_bitable ​

SKILL.md 场景化组织，作为 AI 对话入口统一调度下层 Tool。负责：

  • 根据用户意图选择合适的 Tool 组合
  • 自动推断 app_token、table_id（从上下文或用户提供的链接）
  • 人员字段的自然语言→结构化转换
  • 写入操作的确认流程编排

B 层 — Python Tool 清单 ​

公共行为 ​

所有 Tool 共享以下行为：

  • 鉴权：飞书 tenant_access_token / user_access_token 自动获取与刷新
  • 权限过滤：返回前过滤无权访问的内容
  • app_token 解析：支持直接传 token 或完整飞书链接（自动提取）
  • 人员字段映射：输入中文姓名 → 通过 PersonIndex 解析为 open_id
  • 错误处理：返回可读错误说明，不抛异常

1. query_bitable — 查询记录 ​

项目内容
底层 APIPOST /open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/search
权限 Scopebase:record:retrieve / bitable:app:readonly
限流20 次/秒

参数：

参数必填说明
app_token是多维表格 token 或完整链接
table_id否数据表 ID，不填则使用第一个数据表
filter否筛选条件（见下方 filter 语法详解）
sort否排序字段和方向
field_names否指定返回字段（最多 200 个）
max_records否（默认 50）最大返回记录数（API 单页上限 500）

返回内容： 记录列表（字段名 → 字段值映射）+ 总记录数

filter 语法详解 ​

filter 是 JSON 对象，结构如下：

json
{
  "conjunction": "and",
  "conditions": [
    {
      "field_name": "状态",
      "operator": "is",
      "value": ["进行中"]
    },
    {
      "field_name": "优先级",
      "operator": "is",
      "value": ["P1"]
    }
  ]
}

conjunction — 条件间逻辑关系：

值说明
and所有条件同时满足
or任一条件满足

operator — 支持的运算符：

运算符说明适用字段类型
is等于文本、数字、单选、多选、复选框
isNot不等于文本、数字、单选、多选、复选框
contains包含文本、多选
doesNotContain不包含文本、多选
isEmpty为空所有类型
isNotEmpty不为空所有类型
isGreater大于数字、日期
isGreaterEqual大于等于数字、日期
isLess小于数字、日期
isLessEqual小于等于数字、日期

filter 限制：

限制项数值
filter JSON 字符串最大长度2000 字符
conditions 最大数量50 条
sort 最大条数100 条
value 格式始终为数组

2. create_bitable_record — 新建记录 ​

项目内容
底层 APIPOST /open-apis/bitable/v1/apps/:app_token/tables/:table_id/records
权限 Scopebase:record:create / bitable:app
限流50 次/秒
批量 APIPOST .../records/batch_create（单次最多 1000 条）

参数：

参数必填说明
app_token是多维表格 token
table_id否数据表 ID
fields是字段值映射（如 {"标题": "XX", "优先级": "P1"}）
client_token否UUIDv4 幂等 token，防止重复创建

写入前确认： Tool 返回预览（将创建的记录内容），AI 必须展示给用户确认后执行。

3. update_bitable_record — 更新记录 ​

项目内容
底层 APIPUT /open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/:record_id
权限 Scopebase:record:update / bitable:app
限流50 次/秒
批量 APIPOST .../records/batch_update（单次最多 1000 条）

参数：

参数必填说明
app_token是多维表格 token
table_id否数据表 ID
record_id是记录 ID
fields是要更新的字段值映射

写入前确认： Tool 返回变更对比（旧值 → 新值），AI 必须展示给用户确认后执行。

4. delete_bitable_record — 删除记录 ​

项目内容
底层 APIDELETE /open-apis/bitable/v1/apps/:app_token/tables/:table_id/records/:record_id
权限 Scopebase:record:delete / bitable:app
限流50 次/秒
批量 APIPOST .../records/batch_delete（单次最多 1000 条）

参数：

参数必填说明
app_token是多维表格 token
table_id否数据表 ID
record_id是记录 ID

写入前确认： 删除操作不可撤销，AI 必须展示待删除记录摘要，用户确认后执行。

5. get_bitable_meta — 获取元信息 ​

项目内容
底层 API（App 元数据）GET /open-apis/bitable/v1/apps/:app_token
底层 API（数据表列表）GET /open-apis/bitable/v1/apps/:app_token/tables
底层 API（字段列表）GET /open-apis/bitable/v1/apps/:app_token/tables/:table_id/fields
权限 Scopebase:app:read / base:table:read / base:field:read / bitable:app:readonly
限流20 次/秒

参数：

参数必填说明
app_token是多维表格 token

返回内容： 表格名称 + 数据表列表（名称 + ID + 字段定义）

C 层 — 系统能力 ​

能力说明涉及 Tool状态
权限过滤角色 × 表格可见范围，返回前过滤无权内容全部 Tool🔲 待开发
写入确认新建/更新/删除操作二次确认，展示预览后用户确认执行create / update / delete🔲 待开发
人员字段映射中文姓名 ↔ open_id 自动转换（复用 PersonIndex）create / update✅ 复用现有
Token 自动刷新tenant_access_token 过期自动刷新，复用飞书 HTTP 客户端全部 Tool✅ 复用现有

字段类型完整列表 ​

type 值类型名称写入格式可写备注
1文本"字符串" 或 [{type:"text", text:"内容"}]是纯文本或富文本片段
2数字123 / 3.14是数值类型
3单选"选项名"是选项不存在时自动创建
4多选["选项A", "选项B"]是选项不存在时自动创建
5日期1679900000000是毫秒时间戳
7复选框true / false是布尔值
11人员[{"id": "ou_xxx"}]是open_id 数组（Tool 层自动从姓名映射）
13电话"13800138000"是字符串
15超链接{"text": "显示文本", "link": "https://..."}是—
17附件[{"file_token": "xxx"}]是需先上传获取 token
18单向关联["recXXX"]是关联记录 ID 数组
19查找引用—否只读，由关联字段自动填充
20公式—否只读
21双向关联["recXXX"]是关联记录 ID 数组
22地理位置"经度,纬度"是逗号分隔字符串
23群组[{"id": "oc_xxx"}]是群 open_id
1001创建时间—否只读，系统自动填充
1002最后更新时间—否只读，系统自动填充
1003创建人—否只读，系统自动填充
1004修改人—否只读，系统自动填充
1005自动编号—否只读，系统自动填充

飞书 API 权限速查 ​

Scope说明涉及操作
bitable:app多维表格全量读写修改 App 元数据、新增数据表、新建/更新/删除记录、新增字段
bitable:app:readonly多维表格只读获取 App 元数据、列出数据表、搜索记录、列出字段
base:app:create创建多维表格创建新的多维表格 App
base:app:read读取 App 元数据获取多维表格元数据
base:table:read读取数据表信息列出数据表（page_size 最大 100）
base:table:create创建数据表新增数据表（table.name 1-100 字符）
base:record:retrieve搜索记录搜索/查询记录
base:record:create新增记录新建单条/批量记录
base:record:update更新记录更新单条/批量记录
base:record:delete删除记录删除单条/批量记录
base:field:read读取字段信息列出数据表字段
base:field:create创建字段新增数据表字段

权限说明： 同一操作通常有两个可选 scope（如 base:record:retrieve 或 bitable:app:readonly），应用只需满足其一即可。推荐使用最小权限原则，按需申请细粒度 scope。

飞书 API 限流速查 ​

API方法 + 路径限流
创建 AppPOST /bitable/v1/apps20 次/分钟
获取 App 元数据GET /bitable/v1/apps/:app_token20 次/秒
修改 App 元数据PUT /bitable/v1/apps/:app_token—
列出数据表GET .../tables20 次/秒
新增数据表POST .../tables10 次/秒
搜索记录POST .../records/search20 次/秒
新增记录POST .../records50 次/秒
批量新增记录POST .../records/batch_create50 次/秒
更新记录PUT .../records/:record_id50 次/秒
删除记录DELETE .../records/:record_id50 次/秒
批量删除记录POST .../records/batch_delete—
列出字段GET .../fields20 次/秒
新增字段POST .../fields10 次/秒

关键限制 ​

限制项数值
批量操作（batch_create / batch_update / batch_delete）单次上限1000 条
单表最大字段数300 个（其中公式字段最多 100 个）
单表最大视图数200 个
单 App 最大数据表 + 仪表盘数100 个
单表最大记录数20000 条
search 单页最大返回500 条（page_size）
search field_names 最大数量200 个
filter JSON 最大长度2000 字符
filter conditions 最大数量50 条
sort 最大条数100 条
数据表 name 长度1-100 字符
列出数据表 page_size 上限100
写操作并发建议单一多维表格同时只发一次写请求

Boss-AGI · 超级 AI 企业助理

© 2026 Enginer Team