SuperAPI AI 工具集

feishu-bitasks-manager

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:管理飞书多维表格记录,供 AI 读取与操作。支持获取记录列表、查看记录详情、创建记录、更新记录状态。

主要能力:智能字段映射,自动识别常见中英文字段名,无需手动配置;支持文本、单选、多选、人员、日期等字段类型;输出格式化为易读文本,仅显示有值字段。字段映射优先级例如标题:记录名称>标题>记录>名称>title>name>task>summary;状态:状态>进度>记录状态>status>state>progress。

安装依赖:脚本内含检查,缺失时执行 pip install requests。

配置:需飞书 App ID、App Secret(开放平台创建应用,添加权限 bitable:app:readonly、bitable:app:write),以及 app_token、table_id(从多维表格 URL 获取;wiki 形态需调用知识空间节点信息接口取 obj_token)。敏感信息放 assets/.feishu.json,表格信息放 assets/config.json。

命令行用法示例:python scripts/feishu_bitasks.py list --limit 10;show <record_id>;update <record_id> --status "已完成";create "记录标题" --status "未开始" --priority "高"。

Python API:from feishu_bitasks import FeishuBitasks 后初始化,调用 get_table_records()、format_records_for_ai(records)、update_record_status(record_id, 状态)、create_record(title=..., status=..., assignee=...)。AI 工作流需先获取用户姓名,再按负责人过滤记录并更新状态。

限制:创建记录时字段须存在于表格中,否则报 FieldNameNotFound;权限不足或 app_token/table_id 错误会导致获取不到记录;特殊字段名需修改 FieldMapper.FIELD_PATTERNS;配置文件含敏感信息,需注意安全。收费与价格信息暂未提供。