bitable-data
飞书多维表格管理:表 CRUD、记录查询与写入、字段查看。
调用
通过 channel tool 的 action 参数调用:
| Action |
说明 |
list_bitable_tables |
列出应用下的所有数据表 |
list_bitable_records |
查询表中的记录 |
create_bitable_record |
创建新记录 |
update_bitable_record |
更新已有记录 |
delete_bitable_record |
删除记录 |
list_bitable_fields |
列出表的字段定义 |
参数
list_bitable_tables
| 参数 |
类型 |
必填 |
说明 |
| app_token |
string |
是 |
多维表格应用 token |
| page_size |
integer |
否 |
每页数量 |
| page_token |
string |
否 |
分页 token |
list_bitable_records
| 参数 |
类型 |
必填 |
说明 |
| app_token |
string |
是 |
应用 token |
| table_id |
string |
是 |
表 ID |
| page_size |
integer |
否 |
每页数量 |
| page_token |
string |
否 |
分页 token |
create_bitable_record
| 参数 |
类型 |
必填 |
说明 |
| app_token |
string |
是 |
应用 token |
| table_id |
string |
是 |
表 ID |
| fields |
object |
是 |
字段 key-value 映射 |
update_bitable_record
| 参数 |
类型 |
必填 |
说明 |
| app_token |
string |
是 |
应用 token |
| table_id |
string |
是 |
表 ID |
| record_id |
string |
是 |
记录 ID |
| fields |
object |
是 |
要更新的字段 |
delete_bitable_record
| 参数 |
类型 |
必填 |
说明 |
| app_token |
string |
是 |
应用 token |
| table_id |
string |
是 |
表 ID |
| record_id |
string |
是 |
记录 ID |
list_bitable_fields
| 参数 |
类型 |
必填 |
说明 |
| app_token |
string |
是 |
应用 token |
| table_id |
string |
是 |
表 ID |
示例
查看表的字段定义
→ channel(action="list_bitable_fields", app_token="appXXX", table_id="tblXXX")
查询所有记录
→ channel(action="list_bitable_records", app_token="appXXX", table_id="tblXXX")
创建一条记录
→ channel(action="create_bitable_record", app_token="appXXX", table_id="tblXXX", fields={"Name":"Alice","Score":"95"})
自动执行原则
- 链式自动发现:用户提供 app_token 后,自动调用
list_bitable_tables 获取所有表,再自动 list_bitable_fields 获取字段定义,不要中间问用户。
- 禁止交互式菜单:不要给出 table_id 列表让用户选择,如果只有一个表则直接使用,多个表时按名称匹配用户意图。
- 字段智能映射:写入记录时根据字段定义自动转换类型,不要问用户字段名怎么写。
- 分页自动处理:数据量大时自动翻页获取全部数据,不要问用户"要继续获取下一页吗"。
安全等级
list_bitable_tables / list_bitable_records / list_bitable_fields: L1 只读
create_bitable_record / update_bitable_record: L3 高影响
delete_bitable_record: L4 不可逆
链式组合
- 与
deep-research skill 组合:研究数据写入多维表格进行可视化
- 与
okr-management skill 组合:OKR 进度数据同步到多维表格看板