通過扣子平臺將數據寫入飛書多維表格

1.1?創建飛書開放平臺應用

1.2 創建飛書多維表格

1.3 創建扣子平臺插件

1.1?創建飛書開放平臺應用?

? ?1.1.1 打開地址：飛書開放平臺，點擊創建應用

注：商店應用需要申請ISV資質，填寫企業主體信息，個人的話，選擇【創建企業自建應用】

商店應用：

企業自建應用?

點擊【創建】按鈕創建成功后如下：

?配置應用操作多維表格的權限

?配置完成后需要發布應用才會生效，進入【版本管理與發布 _ 創建版本】

?發布完成后，添加多維表格，并且添加應用權限

1.2?創建飛書多維表格

登錄飛書 _> 新建多維表格：https://fcnm73x3rsfr.feishu.cn/drive/home

將應用添加為多維表格協作者

通過應用API向多維表格插入一條記錄，進入飛書開放平臺-> 權限管理 -> 進入API調試臺。

點擊擊【相關API事件 _ API新增多條記錄】跳轉到API開發文檔，可以打開【API調試臺】進行接口調試

獲取app_token(即base_id)?和 table_id?

?調用成功

?通過飛書開放平臺應用將數據寫入多維表格成功

企業自建應用開發流程文檔：

https://open.feishu.cn/document/home/introduction-to-custom-app-development/self-built-application-development-process

1.3?創建扣子平臺插件

1.3.1 登錄扣子平臺：扣子

創建插件

?創建工具（插件包含一個或多個工具）

?添加輸入參數

?輸入參數添加成功后，此處可以通過輸入參數首字母，就是自動彈出輸入參數的提示下拉框供選擇

?代碼寫完后，點此處運行

?此處需要替換為自己的飛書應用id，才能獲取到正確的token

?飛書開放平臺的app_id 和 app_secret在這里獲取

?返回400或403報錯參考飛書開放平臺API：新增多條記錄 - 服務端 API - 飛書開放平臺

?上面標紅框的部分需要替換為自己飛書多維表格的base_id和table_id，前面創建飛書多維表格流程中有標識base_id（即app_token）和table_id 的地方

以上報錯403是飛書開放平臺的應用沒有飛書多維表格的權限，同時檢查app_id和app_secret，如果這兩個值不正確，也會報403

1.?需要在多維表格中將飛書應用添加為協作者

?2.?需要開啟飛書多維表格高級權限

?前面添加的飛書應用協作者會在這里顯示

?再次點擊運行按鈕，顯示成功，同時飛書多維表格會新增相應數據

?扣子平臺插件工具輸入參數如下：

{"c_index":1,

"c_data" : "\n{\n \"人物列表\": [\n {\n \"姓名\": \"陳德修\",\n \"年齡\": \"50歲左右\",\n \"性別\": \"男\",\n \"身高\": \"\",\n \"體重\": \"\",\n \"五官特征\": \"戴著厚厚的金絲眼鏡\",\n \"身形描述\": \"地中海發型\",\n \"性格標簽\": \"德高望重；醫者仁心\",\n \"穿著打扮\": \"醫生職業裝\",\n \"神態動作\": \"無奈地嘆息；遞診斷書—動作沉穩\"\n },\n {\n \"姓名\": \"莊子昂\",\n \"年齡\": \"18歲\",\n \"性別\": \"男\",\n \"身高\": \"\",\n \"體重\": \"\",\n \"五官特征\": \"斯文氣質；眼角有淚痕—動態\",\n \"身形描述\": \"青蔥少年\",\n \"性格標簽\": \"循規蹈矩；情緒壓抑；故作輕松\",\n \"穿著打扮\": \"艷俗花襯衫—五彩斑斕；沾消毒水味的衣服\",\n \"神態動作\": \"渾渾噩噩走路—撞倒共享單車；手顫抖握診斷書；擠苦澀笑容\"\n },\n {\n \"姓名\": \"林慕詩\",\n \"年齡\": \"約18歲\",\n \"性別\": \"女\",\n \"身高\": \"\",\n \"體重\": \"\",\n \"五官特征\": \"丹鳳眼；牛奶般白皙肌膚\",\n \"身形描述\": \"頗具規模的胸脯—動態起伏\",\n \"性格標簽\": \"傲嬌；外冷內熱\",\n \"穿著打扮\": \"\",\n \"神態動作\": \"輕抿奶茶—動作優雅；瞪丹鳳眼質問\"\n },\n {\n \"姓名\": \"李黃軒\",\n \"年齡\": \"約18歲\",\n \"性別\": \"男\",\n \"身高\": \"\",\n \"體重\": \"\",\n \"五官特征\": \"\",\n \"身形描述\": \"瘦高個\",\n \"性格標簽\": \"活潑；愛調侃\",\n \"穿著打扮\": \"\",\n \"神態動作\": \"大笑著調侃；攬肩膀—動作親昵\"\n }\n ]\n}\n"

}

?扣子平臺插件工具代碼如下：

import json
import requests
from runtime import Args
from typings.write_data_to_feishu_excel.write_data_to_feishu_excel import Input, Output"""
Each file needs to export a function named `handler`. This function is the entrance to the Tool.Parameters:
args: parameters of the entry function.
args.input - input parameters, you can get test input value by args.input.xxx.
args.logger - logger instance used to print logs, injected by runtime.Remember to fill in input/output in Metadata, it helps LLM to recognize and use tool.Return:
The return data of the function, which should match the declared output parameters.
"""class Output:def __init__(self, code: int, message: str, data: str):self.code = codeself.message = messageself.data = data# 此處handler命名不能更改
def handler(args: Args[Input])->Output:args.logger.info(f"輸入參數{args.input}")# 檢查 args.input 是否為 Noneif args.input is None:return Output(code=400, message="args.input 為 None，請檢查傳入的參", data="")# 替換為實際值token = getFeishuToken(args)args.logger.info(f"當前token值：{token}")base_id = "飛書多維表格的base_id"table_id = "飛書多維表格的table_id"characters = args.input.c_dataif not characters:return Output(code=500, message="缺少必要參數: c_data",data="")json_data = getCharactersData(args, characters)args.logger.info(f"寫入數據：{json_data}")# 構造請求體data = {"records": json_data# "records":  [#     {#         "fields": json_obj#     }# ]}# 單行數據寫入API地址#https://open.feishu.cn/open-apis/bitable/v1/apps/飛書多維表格的base_id/tables/飛書多維表格的table_id/records# 多行數據寫入，調用寫入 APIurl = f"https://open.feishu.cn/open-apis/bitable/v1/apps/{base_id}/tables/{table_id}/records/batch_create"args.logger.info(f"飛書多維表格寫入地址{url}")headers = {"Authorization": f"Bearer {token}","Content-Type": "application/json",#'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',}try:response = requests.post(url, json=data , headers=headers)response.raise_for_status()args.logger.info(f"Data written result：{response.json()}")except requests.exceptions.RequestException as e:args.logger.info(f"Request error：{e}")return Output(code=500, message="失敗", data="API請求異常")except ValueError as e:args.logger.info(f"JSON parsing error：{e}")return Output(code=500, message="失敗", data="json數據轉換異常")except Exception as e:args.logger.info(f"An unknown error occurred：{e}")return Output(code=500, message="失敗", data=f"An unknown error occurred：{e}")return Output(code=200, message="成功", data=str(data))# 解析輸入的內容（示例數據是json格式）
def getCharactersData(args, input_data):args.logger.info(f"當前輸入參數：{input_data}")json_data = [] # 如果輸入是字符串則解析，否則直接使用if isinstance(input_data, str):# 清除輸入內容中的json標識json_data = json.loads(input_data.replace("```","").replace("json",""))else:# 假設已經是解析好的對象json_data = input_data# 強制轉換為列表（確保可迭代性）（示例）#if not isinstance(json_data, list):#    json_data = [json_data]# 自動獲取JSON鍵作為列名（示例）#columns = list(flattened_data[0].keys())# 扁平化數據結構flattened_data = []for index, item in enumerate(json_data["人物列表"]):# 3.1 確保item是字典類型#if not isinstance(item, dict):# 非字典類型特殊處理#    item = {"raw_data": item}  # 需確保所有字段存在（防止KeyError），此處json的key名和飛書多維表格列名一致，故使用copy方法flat_item = item.copy()flat_item['章節'] = str(args.input.c_index)# 若json的key名和飛書多維表格列名不一致，此處進行轉換name為飛書多維表格列名，姓名為json數據的key名# flat_item = {#     'name': item.get('姓名', ""),#     'age': item.get('年齡區間', ""),#     'features': item.get('五官特征', ""),#     'body': item.get('身形描述', ""),#     'temperament': item.get('性格標簽', ""),#     'dress': item.get('穿著打扮', ""),#     'look': item.get('神態動作', ""),#     'sex': item.get('性別', ""),#     'height': item.get('身高', ""),#     'weight': item.get('體重', "")# }# 3.3 若輸入的json數據存在嵌套，處理嵌套結構（示例）if 'appearance' in item:appearance = item.get('appearance', {})flat_item.update({'features': str(appearance.get('五官特征', '')),'body': str(appearance.get('身形描述', ''))})# 飛書開放平臺API中行數據是放在fields對象中的，多行就是多個fields對象flattened_data.append({"fields": flat_item})return flattened_data# 獲取訪問令牌token
def getFeishuToken(args):token_url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"token_response = requests.post(token_url, json={"app_id": "飛書開放平臺應用的app_id","app_secret": "飛書開放平臺應用的app_secret"})#注意：令牌有效期為 2 小時，需定期刷新#響應token:{'code': 0, 'expire': 7200, 'msg': 'ok', 'tenant_access_token': 't-g104439u6OYLPGRXP656CNK27CSDYNNNUFTMKRFT'}res = token_response.json()args.logger.info(f"響應token{res}")return token_response.json()["tenant_access_token"]