bitable-data
Feishu Bitable management: table CRUD, record query and write, field viewing.
Invocation
Invoke via the channel tool's action parameter:
| Action |
Description |
list_bitable_tables |
List all data tables under the app |
list_bitable_records |
Query records in a table |
create_bitable_record |
Create a new record |
update_bitable_record |
Update an existing record |
delete_bitable_record |
Delete a record |
list_bitable_fields |
List field definitions of a table |
Parameters
list_bitable_tables
| Parameter |
Type |
Required |
Description |
| app_token |
string |
Yes |
Bitable app token |
| page_size |
integer |
No |
Number per page |
| page_token |
string |
No |
Pagination token |
list_bitable_records
| Parameter |
Type |
Required |
Description |
| app_token |
string |
Yes |
App token |
| table_id |
string |
Yes |
Table ID |
| page_size |
integer |
No |
Number per page |
| page_token |
string |
No |
Pagination token |
create_bitable_record
| Parameter |
Type |
Required |
Description |
| app_token |
string |
Yes |
App token |
| table_id |
string |
Yes |
Table ID |
| fields |
object |
Yes |
Field key-value mapping |
update_bitable_record
| Parameter |
Type |
Required |
Description |
| app_token |
string |
Yes |
App token |
| table_id |
string |
Yes |
Table ID |
| record_id |
string |
Yes |
Record ID |
| fields |
object |
Yes |
Fields to update |
delete_bitable_record
| Parameter |
Type |
Required |
Description |
| app_token |
string |
Yes |
App token |
| table_id |
string |
Yes |
Table ID |
| record_id |
string |
Yes |
Record ID |
list_bitable_fields
| Parameter |
Type |
Required |
Description |
| app_token |
string |
Yes |
App token |
| table_id |
string |
Yes |
Table ID |
Examples
查看表的字段定义
→ 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"})
Automatic execution principles
- Chained automatic discovery: After the user provides app_token, automatically invoke
list_bitable_tables to get all tables, then automatically list_bitable_fields to get field definitions, without asking the user in between.
- No interactive menus: Do not present a table_id list for the user to choose from; if there is only one table, use it directly, and if there are multiple tables, match the user's intent by name.
- Intelligent field mapping: When writing records, automatically convert types according to field definitions, without asking the user how to write field names.
- Automatic pagination handling: When the data volume is large, automatically page through to retrieve all data, without asking the user "Do you want to continue getting the next page?".
Security levels
list_bitable_tables / list_bitable_records / list_bitable_fields: L1 Read-onlycreate_bitable_record / update_bitable_record: L3 High impactdelete_bitable_record: L4 Irreversible
Chained combinations
- With
deep-research skill combination: write research data into a multidimensional table for visualization
- and
okr-management skill combination: sync OKR progress data to a multidimensional table dashboard
