【免費(fèi)下載鏈接】ade-pythonPython library for Agentic Document Extraction (ADE).項(xiàng)目地址https://gitcode.com/gh_mirrors/ade/ade-python點(diǎn)擊查看免費(fèi)下載ade-python是 LandingAI Agentic Document ExtractionADE的官方 Python 庫(kù)負(fù)責(zé)把 PDF、圖片解析成結(jié)構(gòu)化 Markdown再按 JSON Schema 或 Pydantic 模型抽取字段。對(duì)新手來說請(qǐng)求發(fā)出去之后怎么接住返回值常常是卡點(diǎn)結(jié)果想存盤、想拿 HTTP 頭、想把模型轉(zhuǎn)成字典或 JSON、想知道字段到底是null還是沒返回。下面 5 個(gè)技巧都是倉(cāng)庫(kù)里現(xiàn)成的能力學(xué)完就能直接上手。技巧一用 save_to 參數(shù)一行代碼把結(jié)果落盤 client.v2.parse和client.v2.extract都支持save_to參數(shù)見 README.md 與 src/landingai_ade/resources/v2/parse.py它遵循兩條規(guī)則傳入值行為以.json結(jié)尾的路徑直接寫入該文件目錄路徑自動(dòng)生成文件名{輸入文件名}_{parse/extract}_output.json推不出輸入文件名時(shí)退化為{方法名}_output.json父目錄會(huì)自動(dòng)創(chuàng)建寫出的內(nèi)容就是result.to_json()的縮進(jìn) JSON。批量跑幾十份發(fā)票時(shí)每一份結(jié)果都會(huì)以源文件名為前綴整齊歸檔調(diào)試時(shí)不用再去翻控制臺(tái)輸出。落盤邏輯位于 _client.py測(cè)試用例可參考 tests/test_save_to.py。parsed client.v2.parse( documentPath(invoice.pdf), save_to./output, # 生成 ./output/invoice_parse_output.json )技巧二用 with_raw_response 拿原始 HTTP 響應(yīng) 有些場(chǎng)景要看響應(yīng)頭比如網(wǎng)關(guān)的 request-id或檢查狀態(tài)碼此時(shí)把 v1 方法前加上.with_raw_response.前綴即可response client.with_raw_response.parse(documentPath(file.pdf)) print(response.status_code) print(response.headers.get(X-Request-Id)) parsed response.parse() # 拿到本應(yīng)直接返回的對(duì)象APIResponse同時(shí)暴露read()、text()、json()、iter_lines()等底層方法源碼在 src/landingai_ade/_response.py。注意兩點(diǎn)這類包裝器目前只覆蓋 v1 方法不含client.v2如果只想流式讀取大響應(yīng)體改用.with_streaming_response需要with上下文。技巧三模型轉(zhuǎn)換——to_dict / to_json 的隱藏開關(guān) 所有響應(yīng)對(duì)象都是 Pydantic 模型自帶to_dict()和to_json()定義于 src/landingai_ade/_models.py參數(shù)比想象的靈活use_api_namesTrue默認(rèn)鍵名保持 API 原始拼寫如pageCount轉(zhuǎn)出去就是接口視角的數(shù)據(jù)設(shè)為False則用 Python 屬性名page_count適合存數(shù)據(jù)庫(kù)。modejsondatetime等對(duì)象統(tǒng)一轉(zhuǎn)成 JSON 可序列化字符串默認(rèn)的python模式則保留 Python 對(duì)象。exclude_unsetTrue默認(rèn)API 沒返回的字段不會(huì)出現(xiàn)在輸出里文件更干凈。data parsed.metadata.to_dict(modejson, exclude_noneTrue) json_str parsed.to_json(indent2)save_to落盤用的正是to_json()所以技巧一和三天然配合。技巧四分清 None 是 null 還是字段缺失 模型里看到metadata.duration_ms is None時(shí)無法直接判斷是接口回了null還是這個(gè) key 根本沒返回。ade-python 給出的官方判法是檢查model_fields_setif parsed.metadata.duration_ms is None: if duration_ms not in parsed.metadata.model_fields_set: print(接口沒有返回該字段) else: print(接口明確返回了 null)這個(gè)細(xì)節(jié)在做數(shù)據(jù)校驗(yàn)、核對(duì)計(jì)費(fèi)billing.total_credits時(shí)特別有用能避免把沒返回誤當(dāng)成值為 0。技巧五類型模型沒覆蓋的字段走 raw 與 extra 兜底 異步 Job 的raw字段parse_jobs/extract_jobs的create、get、wait返回標(biāo)準(zhǔn)化Jobjob_id、status、progress、result……同時(shí)附帶raw——未改寫的原始 API 信封。類型模型沒暴露的新字段從job.raw里取即可參考 examples/v2_parse.py。extraallow保留未知鍵所有響應(yīng)模型如 V2ParseResponse配置了extraallow服務(wù)端新增的字段不會(huì)在反序列化時(shí)丟失可通過model_extra訪問。配合這兩招即使上游接口加字段、文檔還沒跟上代碼也能優(yōu)雅降級(jí)而不是拋異常。小結(jié) 需求用什么結(jié)果直接存盤save_to參數(shù)看響應(yīng)頭/狀態(tài)碼.with_raw_response.前綴轉(zhuǎn)字典/JSONto_dict()/to_json() 參數(shù)開關(guān)區(qū)分 null 與缺失model_fields_set兜底未知字段Job.raw、model_extra掌握這 5 個(gè)技巧ade-python 返回值的各種后處理需求基本都有現(xiàn)成答案少寫一半膠水代碼。贊分享【免費(fèi)下載鏈接】ade-pythonPython library for Agentic Document Extraction (ADE).項(xiàng)目地址https://gitcode.com/gh_mirrors/ade/ade-python點(diǎn)擊查看免費(fèi)下載相關(guān)推薦ReactiveCocoa DelegateProxy模式優(yōu)雅處理代理方法的響應(yīng)式轉(zhuǎn)換ReactiveCocoa DelegateProxy模式優(yōu)雅處理代理方法的響應(yīng)式轉(zhuǎn)換 ReactiveCocoa的DelegateProxy模式是iOS和mUI組件UI Recorder移動(dòng)端測(cè)試完全教程Android和iOS自動(dòng)化錄制實(shí)戰(zhàn)UI Recorder移動(dòng)端測(cè)試完全教程Android和iOS自動(dòng)化錄制實(shí)戰(zhàn) UI Recorder是一款功能強(qiáng)大的多平臺(tái)UI測(cè)試錄制工具特別支持AndroMockoon訪問者模式5個(gè)API響應(yīng)處理擴(kuò)展技巧Mockoon訪問者模式5個(gè)API響應(yīng)處理擴(kuò)展技巧 Mockoon是最簡(jiǎn)單快速的本地API模擬工具無需遠(yuǎn)程部署和賬戶開源免費(fèi)。訪問者模式作為Mockoon開發(fā)工具測(cè)試后端創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考