欧美成人午夜精品久久久,国产?V天堂一区二区三区,欧美精品va在线观看,亚洲一区二区三区免费在线观看,av无码精品一区二区久久,欧美性爱视频不卡一区三区,欧美乱人伦视频在线观看,国产一级牲交高潮

ARTICLE DETAIL

資訊詳情

深耕商務(wù)建站與企業(yè)官網(wǎng)運(yùn)營(yíng)的一線實(shí)戰(zhàn)洞察。

構(gòu)建Agent-Ready OpenAPI文檔:多智能體LLM檢測(cè)系統(tǒng)實(shí)戰(zhàn)

構(gòu)建Agent-Ready OpenAPI文檔:多智能體LLM檢測(cè)系統(tǒng)實(shí)戰(zhàn) 1. 從“能用”到“好用”為什么你的OpenAPI文檔需要“體檢”最近在幫幾個(gè)團(tuán)隊(duì)做API治理和自動(dòng)化測(cè)試的咨詢一個(gè)反復(fù)出現(xiàn)的問(wèn)題讓我感觸很深很多團(tuán)隊(duì)花大力氣用OpenAPI規(guī)范寫好了接口文檔也接入了Swagger UI看起來(lái)一切就緒。但當(dāng)他們?cè)噲D將這些文檔喂給大語(yǔ)言模型LLM驅(qū)動(dòng)的智能體Agent比如讓Agent自動(dòng)生成測(cè)試用例、進(jìn)行合規(guī)性檢查甚至直接調(diào)用API時(shí)效果卻總是不盡如人意。要么是Agent無(wú)法理解文檔中的模糊描述要么是生成的代碼調(diào)用失敗或者Agent在復(fù)雜的API路徑和參數(shù)組合中“迷路”。這背后暴露出的是傳統(tǒng)“人類可讀”的API文檔與新興“機(jī)器可理解”的Agent需求之間的巨大鴻溝。一份對(duì)人類開(kāi)發(fā)者來(lái)說(shuō)“足夠清晰”的文檔對(duì)Agent而言可能充滿了歧義、冗余和結(jié)構(gòu)上的“壞味道”Smells。這就好比一份手寫的、帶有個(gè)人縮寫和涂改的菜譜廚師人類或許能看懂但要讓一個(gè)完全自動(dòng)化的炒菜機(jī)器人Agent來(lái)執(zhí)行它很可能因?yàn)椤斑m量”、“少許”、“炒至斷生”這樣的描述而宕機(jī)?!癕aking OpenAPI Documentation Agent-Ready”這個(gè)標(biāo)題精準(zhǔn)地戳中了當(dāng)前API開(kāi)發(fā)與AI應(yīng)用融合的痛點(diǎn)。它不再是簡(jiǎn)單地要求文檔符合OpenAPI 3.0規(guī)范而是提出了一個(gè)更高的標(biāo)準(zhǔn)文檔需要為AI智能體的理解和操作而優(yōu)化。這里的“Agent-Ready”意味著文檔必須具備高度的機(jī)器可解析性、邏輯一致性和語(yǔ)義明確性。而“Detecting Documentation and REST Smells”則是實(shí)現(xiàn)這一目標(biāo)的關(guān)鍵手段——通過(guò)系統(tǒng)化的“體檢”找出那些阻礙Agent高效工作的“壞味道”。這些“壞味道”可能包括含糊不清的操作摘要summary、缺失或模板化的參數(shù)描述description、違反RESTful設(shè)計(jì)原則的端點(diǎn)命名、過(guò)度復(fù)雜的嵌套響應(yīng)模型、不一致的錯(cuò)誤碼定義等等。對(duì)于人類我們或許能靠經(jīng)驗(yàn)和上下文腦補(bǔ)但對(duì)于依賴文檔字面信息的LLM Agent每一個(gè)模糊點(diǎn)都是一個(gè)潛在的失敗點(diǎn)。因此構(gòu)建一個(gè)“Multi-Agent LLM System”來(lái)檢測(cè)這些味道不是一個(gè)炫技的學(xué)術(shù)項(xiàng)目而是一個(gè)極具工程實(shí)踐價(jià)值的解決方案。它利用LLM在理解自然語(yǔ)言和代碼結(jié)構(gòu)方面的雙重能力模擬多個(gè)具有不同專長(zhǎng)如文檔審查、架構(gòu)評(píng)審、安全掃描的“虛擬專家”對(duì)API文檔進(jìn)行多角度、深層次的剖析。這比編寫一堆靜態(tài)規(guī)則Linter要靈活和智能得多能夠發(fā)現(xiàn)那些隱藏在上下文和語(yǔ)義中的深層問(wèn)題。2. 拆解“壞味道”Documentation Smells與REST Smells的典型癥狀要讓文檔對(duì)Agent友好首先得知道Agent“討厭”什么。我們可以將阻礙Agent的“壞味道”大致分為兩類文檔層面Documentation Smells和架構(gòu)/設(shè)計(jì)層面REST Smells。下面我結(jié)合具體例子拆解這些味道的典型癥狀和它們對(duì)Agent造成的具體困擾。2.1 Documentation Smells當(dāng)文檔本身成為“噪音”這類問(wèn)題源于文檔內(nèi)容的質(zhì)量低下或不規(guī)范直接影響了LLM對(duì)接口意圖和用法的提取。癥狀1模糊或缺失的描述Vague/Missing Descriptions這是最常見(jiàn)也最致命的問(wèn)題。OpenAPI規(guī)范中的summary、description、parameters.description、responses.description等字段如果填寫得像“接口說(shuō)明”或“返回?cái)?shù)據(jù)”對(duì)Agent來(lái)說(shuō)就是無(wú)效信息。壞味道示例paths: /users: get: summary: 獲取用戶列表 description: 獲取用戶列表接口。 responses: 200: description: 成功 content: application/json: schema: type: array items: $ref: #/components/schemas/User對(duì)Agent的影響Agent無(wú)法知道這個(gè)“獲取”是否支持分頁(yè)、過(guò)濾、排序成功的響應(yīng)里到底包含哪些用戶字段Userschema的定義是否完整這會(huì)導(dǎo)致Agent生成的代碼可能缺少必要的查詢參數(shù)或者無(wú)法正確處理響應(yīng)數(shù)據(jù)。Agent-Ready的修復(fù)paths: /users: get: summary: 分頁(yè)查詢用戶列表支持按姓名過(guò)濾和創(chuàng)建時(shí)間排序。 description: 查詢系統(tǒng)用戶列表。默認(rèn)返回第一頁(yè)每頁(yè)20條記錄。 可通過(guò) name 參數(shù)進(jìn)行模糊過(guò)濾通過(guò) sortBy 和 order 參數(shù)指定排序規(guī)則。 需要 READ_USER 權(quán)限。 parameters: - in: query name: page schema: {type: integer, minimum: 1, default: 1} description: 頁(yè)碼從1開(kāi)始。 - in: query name: name schema: {type: string} description: 用戶姓名模糊匹配關(guān)鍵字可選。 responses: 200: description: 查詢成功返回用戶列表及分頁(yè)元數(shù)據(jù)。 content: application/json: schema: $ref: #/components/schemas/PaginatedResponse癥狀2不一致的命名與格式Inconsistent Naming FormattingAgent會(huì)嘗試從命名中學(xué)習(xí)模式。如果同一個(gè)概念在路徑、參數(shù)、Schema中用了不同的名字如userId、user_id、id或者日期格式一時(shí)用YYYY-MM-DD一時(shí)用時(shí)間戳?xí)孉gent的上下文理解變得混亂。壞味道示例在同一個(gè)文檔中有的接口用camelCase命名請(qǐng)求體字段有的用snake_case錯(cuò)誤響應(yīng)的結(jié)構(gòu)體一會(huì)兒叫ErrorResponse一會(huì)兒叫ApiError。對(duì)Agent的影響降低Agent生成代碼的準(zhǔn)確性和一致性可能需要在提示詞Prompt中額外加入大量解釋增加調(diào)用成本。Agent-Ready的修復(fù)在全局的components中統(tǒng)一定義通用模型如StandardError、PaginatedMeta并在整個(gè)文檔中強(qiáng)制引用。使用工具如spectral制定并校驗(yàn)命名風(fēng)格規(guī)則。癥狀3過(guò)時(shí)或錯(cuò)誤的示例Outdated/Incorrect Examplesexample或examples字段是Agent學(xué)習(xí)如何構(gòu)造請(qǐng)求和理解響應(yīng)的絕佳材料。但如果示例是過(guò)時(shí)的或者根本就是錯(cuò)的比如必填字段沒(méi)填那就是在“教壞”Agent。壞味道示例接口實(shí)際需要認(rèn)證頭Authorization: Bearer token但示例中完全沒(méi)有體現(xiàn)響應(yīng)示例中的字段類型與schema定義不匹配。對(duì)Agent的影響Agent基于錯(cuò)誤示例生成的代碼會(huì)在運(yùn)行時(shí)失敗嚴(yán)重?fù)p害開(kāi)發(fā)者對(duì)Agent能力的信任。Agent-Ready的修復(fù)將示例的生成和維護(hù)納入CI/CD流程??梢允褂没谡鎸?shí)流量或測(cè)試用例生成的“真實(shí)示例”并確保每次接口變更后示例都得到同步更新。2.2 REST Smells當(dāng)API設(shè)計(jì)違背“契約精神”這類問(wèn)題關(guān)乎API本身的設(shè)計(jì)是否符合RESTful最佳實(shí)踐和資源建模原則。設(shè)計(jì)糟糕的API即使文檔再清晰也會(huì)讓Agent和人類開(kāi)發(fā)者難以使用。癥狀1誤導(dǎo)性的HTTP動(dòng)詞使用Misleading HTTP Verbs這是REST設(shè)計(jì)的核心。用GET請(qǐng)求來(lái)執(zhí)行刪除操作或者用POST請(qǐng)求來(lái)查詢數(shù)據(jù)是對(duì)HTTP語(yǔ)義的嚴(yán)重破壞。壞味道示例paths: /user/{id}/delete: get: summary: 刪除用戶對(duì)Agent的影響LLM通常具備良好的HTTP協(xié)議知識(shí)。一個(gè)設(shè)計(jì)反模式的API會(huì)與LLM的內(nèi)置知識(shí)沖突導(dǎo)致其困惑可能生成不符合預(yù)期的代碼比如試圖緩存一個(gè)GET刪除請(qǐng)求。同時(shí)這也阻礙了Agent進(jìn)行更高級(jí)的推理比如利用GET的冪等性進(jìn)行安全重試。Agent-Ready的修復(fù)嚴(yán)格遵守HTTP動(dòng)詞語(yǔ)義。刪除操作必須使用DELETE /users/{id}。癥狀2糟糕的資源嵌套與端點(diǎn)設(shè)計(jì)Poor Resource Nesting過(guò)深或不合理的嵌套如GET /companies/123/departments/456/employees/789/projects/999/tasks會(huì)讓端點(diǎn)路徑變得極其冗長(zhǎng)和脆弱。而像/getAllUsers、/createOrder這樣的RPC風(fēng)格端點(diǎn)則完全丟失了資源的層次感。對(duì)Agent的影響Agent難以推斷資源之間的關(guān)系和狀態(tài)轉(zhuǎn)換邏輯。對(duì)于深度嵌套的端點(diǎn)Agent在構(gòu)造URL和傳遞參數(shù)時(shí)更容易出錯(cuò)。RPC風(fēng)格的端點(diǎn)則迫使Agent去記憶一個(gè)個(gè)獨(dú)立的“命令”而不是理解一個(gè)統(tǒng)一的資源模型極大地降低了可發(fā)現(xiàn)性和可組合性。Agent-Ready的修復(fù)遵循“不超過(guò)兩級(jí)嵌套”的經(jīng)驗(yàn)法則。如果關(guān)系復(fù)雜考慮在父資源響應(yīng)中嵌入子資源的標(biāo)識(shí)符或鏈接HATEOAS讓客戶端通過(guò)鏈接訪問(wèn)。例如GET /projects/999的響應(yīng)中可以包含tasks: /projects/999/tasks的鏈接。癥狀3非標(biāo)準(zhǔn)或混亂的錯(cuò)誤處理Non-Standard Error Handling有的API所有錯(cuò)誤都返回200在響應(yīng)體里用code和msg區(qū)分有的則混用HTTP狀態(tài)碼和自定義業(yè)務(wù)碼邏輯不一。壞味道示例登錄失敗返回200 OK且{“code”: 1001, “msg”: “密碼錯(cuò)誤”}資源不存在有時(shí)返回404有時(shí)返回200加特定錯(cuò)誤碼。對(duì)Agent的影響Agent無(wú)法利用HTTP狀態(tài)碼這一最直接、最通用的錯(cuò)誤判斷機(jī)制。它必須為每個(gè)API單獨(dú)學(xué)習(xí)一套復(fù)雜的錯(cuò)誤碼映射規(guī)則極大地增加了Agent邏輯的復(fù)雜度和出錯(cuò)率。Agent-Ready的修復(fù)嚴(yán)格使用標(biāo)準(zhǔn)的HTTP狀態(tài)碼家族4xx客戶端錯(cuò)誤5xx服務(wù)端錯(cuò)誤。額外的、細(xì)粒度的業(yè)務(wù)錯(cuò)誤信息可以放在響應(yīng)體Body的一個(gè)標(biāo)準(zhǔn)化的錯(cuò)誤對(duì)象中。例如422 Unprocessable Entity表示請(qǐng)求格式正確但語(yǔ)義錯(cuò)誤如驗(yàn)證失敗并在Body中詳細(xì)說(shuō)明哪個(gè)字段有問(wèn)題。3. 構(gòu)建多智能體LLM檢測(cè)系統(tǒng)從理念到架構(gòu)知道了有哪些“壞味道”下一步就是如何系統(tǒng)化地檢測(cè)它們。傳統(tǒng)的基于規(guī)則Rule-based的Linter如Spectral能力有限無(wú)法理解語(yǔ)義層面的模糊和矛盾。而單一功能的LLM調(diào)用又容易顧此失彼。因此一個(gè)多智能體Multi-AgentLLM系統(tǒng)成為了更優(yōu)解。它的核心思想是“分而治之協(xié)同作業(yè)”模擬一個(gè)專業(yè)的API評(píng)審團(tuán)隊(duì)。3.1 系統(tǒng)設(shè)計(jì)理念角色扮演與專業(yè)化分工這個(gè)系統(tǒng)的設(shè)計(jì)借鑒了軟件工程中的“單一職責(zé)原則”和“關(guān)注點(diǎn)分離”。我們?yōu)椴煌N類的“壞味道”設(shè)計(jì)專門的“智能體角色”每個(gè)角色擁有特定的系統(tǒng)指令System Prompt和專業(yè)知識(shí)。文檔語(yǔ)法與結(jié)構(gòu)檢查員Syntax Structure Inspector職責(zé)首先確保OpenAPI文檔本身是語(yǔ)法正確、符合基本規(guī)范的。這可以先用快速、低成本的傳統(tǒng)校驗(yàn)器如swagger-parser完成作為前置過(guò)濾。LLM增強(qiáng)點(diǎn)檢查那些語(yǔ)法正確但邏輯奇怪的地方比如一個(gè)POST操作的requestBody的schema里定義了100個(gè)字段卻沒(méi)有description這雖然合法但值得警告。文檔內(nèi)容質(zhì)量分析師Content Quality Analyst職責(zé)專門針對(duì)Documentation Smells。它的系統(tǒng)指令會(huì)強(qiáng)調(diào)檢查描述的清晰度、完整性、一致性以及示例的準(zhǔn)確性。Prompt設(shè)計(jì)示例“你是一個(gè)資深的API文檔工程師。請(qǐng)仔細(xì)分析提供的OpenAPI操作片段。請(qǐng)逐一檢查其summary、description、參數(shù)描述、響應(yīng)描述。判斷它們是否清晰、無(wú)歧義、完整地說(shuō)明了接口的用途、用法、前提條件和后置條件。請(qǐng)?zhí)貏e關(guān)注是否存在模糊詞匯如‘處理’、‘相關(guān)’、信息缺失如未說(shuō)明權(quán)限、分頁(yè)或與schema明顯矛盾的示例。以列表形式輸出發(fā)現(xiàn)的問(wèn)題并為每個(gè)問(wèn)題提供具體的修改建議。”RESTful架構(gòu)評(píng)審員RESTful Architect Reviewer職責(zé)專門針對(duì)REST Smells。它的系統(tǒng)指令會(huì)灌輸RESTful設(shè)計(jì)原則、HTTP語(yǔ)義、資源建模最佳實(shí)踐。Prompt設(shè)計(jì)示例“你是一個(gè)嚴(yán)格的RESTful API架構(gòu)師。請(qǐng)?jiān)u審以下API路徑和操作定義。請(qǐng)判斷1) HTTP動(dòng)詞的使用是否符合其語(yǔ)義GET安全冪等POST創(chuàng)建PUT全量更新等2) 資源命名和嵌套是否合理是否使用名詞復(fù)數(shù)、嵌套深度是否過(guò)深3) 狀態(tài)碼的使用是否恰當(dāng)2xx成功4xx客戶端錯(cuò)誤等4) 是否誤用查詢參數(shù)Query和路徑參數(shù)Path請(qǐng)指出所有違反RESTful設(shè)計(jì)原則的問(wèn)題并解釋原因給出重構(gòu)方案。”安全與合規(guī)掃描員Security Compliance Scanner職責(zé)檢查是否存在安全漏洞或合規(guī)風(fēng)險(xiǎn)例如是否缺少認(rèn)證標(biāo)記security、是否在響應(yīng)中暴露了敏感字段如密碼哈希、是否使用了不安全的傳輸協(xié)議http等。這個(gè)角色可以結(jié)合OWASP API安全Top 10等清單。協(xié)調(diào)與報(bào)告生成器Orchestrator Reporter職責(zé)這是系統(tǒng)的“大腦”。它負(fù)責(zé)將完整的OpenAPI文檔拆解成適合各個(gè)智能體分析的片段如按path拆分調(diào)度并管理各個(gè)智能體的調(diào)用收集它們的分析結(jié)果最后進(jìn)行匯總、去重、優(yōu)先級(jí)排序如將“錯(cuò)誤使用HTTP動(dòng)詞”定為高危將“描述不夠生動(dòng)”定為低危并生成一份人類和機(jī)器都可讀的詳細(xì)報(bào)告如Markdown、JSON。3.2 技術(shù)架構(gòu)與工作流一個(gè)可行的技術(shù)實(shí)現(xiàn)架構(gòu)如下輸入與解析層接收OpenAPI規(guī)范文件YAML/JSON。使用swagger-parser或openapi3-ts進(jìn)行初步解析和語(yǔ)法驗(yàn)證并將文檔轉(zhuǎn)換為結(jié)構(gòu)化的對(duì)象。任務(wù)分解與調(diào)度層根據(jù)文檔結(jié)構(gòu)創(chuàng)建分析任務(wù)隊(duì)列。例如為每個(gè)path及其下的每個(gè)operation創(chuàng)建一個(gè)“分析單元”。調(diào)度器將這些單元分發(fā)給不同的智能體分析流水線。多智能體執(zhí)行層每個(gè)智能體角色是一個(gè)獨(dú)立的LLM調(diào)用模塊。為了提高效率和降低成本可以根據(jù)問(wèn)題復(fù)雜度為不同角色分配不同規(guī)模的模型例如內(nèi)容分析用GPT-4或Claude-3語(yǔ)法檢查用GPT-3.5-Turbo。調(diào)用時(shí)將“系統(tǒng)指令”、“分析單元內(nèi)容”以及可能的一些“上下文”如全局的components定義組合成最終的提示詞Prompt。需要精心設(shè)計(jì)輸出格式要求LLM以結(jié)構(gòu)化方式如JSON返回問(wèn)題列表包含問(wèn)題類型、位置path、method、描述、嚴(yán)重程度和建議修復(fù)。結(jié)果聚合與報(bào)告層收集所有智能體的輸出進(jìn)行聚合。利用LLM或規(guī)則引擎對(duì)相似問(wèn)題進(jìn)行聚類和去重。根據(jù)預(yù)設(shè)規(guī)則如嚴(yán)重程度、影響范圍對(duì)問(wèn)題進(jìn)行排序。最終生成報(bào)告。反饋與學(xué)習(xí)層進(jìn)階系統(tǒng)可以記錄每次檢測(cè)的結(jié)果和人工修復(fù)的確認(rèn)形成一個(gè)“好壞樣本”數(shù)據(jù)集。這個(gè)數(shù)據(jù)集可以用來(lái)微調(diào)一個(gè)小型的、專門用于檢測(cè)API味道的分類模型或者用于優(yōu)化各個(gè)智能體的Prompt形成閉環(huán)讓系統(tǒng)越用越聰明。3.3 關(guān)鍵實(shí)現(xiàn)細(xì)節(jié)與避坑指南成本與延遲控制分析一個(gè)大型OpenAPI文檔可能會(huì)產(chǎn)生數(shù)十上百個(gè)LLM調(diào)用。需要策略性地進(jìn)行“剪枝”對(duì)于非常標(biāo)準(zhǔn)、簡(jiǎn)單的操作如一個(gè)標(biāo)準(zhǔn)的GET /health可以跳過(guò)深度分析或者先使用快速、廉價(jià)的模型進(jìn)行初篩只對(duì)可疑部分啟用更強(qiáng)大的模型。提示詞工程Prompt Engineering這是系統(tǒng)成敗的關(guān)鍵。指令必須清晰、具體、無(wú)歧義并包含“少說(shuō)廢話”的約束如“僅輸出JSON格式的問(wèn)題列表不要額外解釋”。需要為每個(gè)角色精心設(shè)計(jì)并不斷迭代Prompt??梢允褂谩吧贅颖緦W(xué)習(xí)Few-shot Learning”在Prompt中提供幾個(gè)正例和反例引導(dǎo)LLM更好地理解任務(wù)。處理LLM的“幻覺(jué)”與不一致LLM可能會(huì)對(duì)同一問(wèn)題給出略有不同的描述或者偶爾“發(fā)明”一個(gè)不存在的問(wèn)題。因此聚合層需要有一定的模糊匹配和去重能力。對(duì)于高嚴(yán)重級(jí)別的問(wèn)題可以考慮設(shè)置“投票機(jī)制”即讓兩個(gè)同角色的智能體獨(dú)立分析結(jié)果一致才采納。與現(xiàn)有工具鏈集成這個(gè)系統(tǒng)不應(yīng)該是一個(gè)孤立的玩具。最好的方式是將其封裝成一個(gè)命令行工具或GitHub Action可以集成到CI/CD流水線中。在開(kāi)發(fā)人員提交代碼或創(chuàng)建Pull Request時(shí)自動(dòng)運(yùn)行將報(bào)告以評(píng)論形式貼到PR中實(shí)現(xiàn)“左移”的質(zhì)量保障。4. 實(shí)戰(zhàn)將檢測(cè)系統(tǒng)集成到開(kāi)發(fā)流水線設(shè)計(jì)出一個(gè)系統(tǒng)只是第一步讓它真正在團(tuán)隊(duì)中創(chuàng)造價(jià)值必須無(wú)縫嵌入開(kāi)發(fā)工作流。這里我分享一個(gè)基于GitHub Actions的自動(dòng)化集成方案這也是目前最輕量、最流行的方式之一。4.1 創(chuàng)建可執(zhí)行的檢測(cè)工具首先你需要將上述多智能體系統(tǒng)封裝成一個(gè)命令行工具。假設(shè)我們使用Python實(shí)現(xiàn)主文件可以是api_smell_detector.py。# api_smell_detector.py 示例骨架 import yaml import json import asyncio from typing import Dict, List from openapi_core import OpenAPI # 假設(shè)我們有自己的智能體模塊 from agents import DocumentationAnalyst, RESTArchitect, SecurityAuditor, Orchestrator class APISmellDetector: def __init__(self, openapi_path: str, llm_config: Dict): self.openapi_path openapi_path self.llm_config llm_config self.spec self._load_spec() self.orchestrator Orchestrator(llm_config) def _load_spec(self): with open(self.openapi_path, r) as f: spec_dict yaml.safe_load(f) if openapi_path.endswith(.yaml) else json.load(f) # 使用openapi_core進(jìn)行基礎(chǔ)驗(yàn)證 spec OpenAPI.from_dict(spec_dict) return spec async def analyze(self) - Dict: 主分析流程 # 1. 任務(wù)分解將spec按路徑/操作分解為多個(gè)分析單元 analysis_units self._decompose_spec(self.spec) # 2. 調(diào)度多智能體并行分析 tasks [] for unit in analysis_units: task self.orchestrator.dispatch_analysis(unit) tasks.append(task) # 3. 等待所有分析完成 all_results await asyncio.gather(*tasks) # 4. 聚合、去重、生成報(bào)告 final_report self.orchestrator.generate_report(all_results) return final_report def _decompose_spec(self, spec): # 實(shí)現(xiàn)將OpenAPI對(duì)象拆分成更小單元的邏輯 units [] for path, path_item in spec[paths].items(): for method, operation in path_item.items(): unit { path: path, method: method.upper(), operation: operation, global_components: spec.get(components, {}) } units.append(unit) return units if __name__ __main__: import sys detector APISmellDetector(sys.argv[1], llm_config{api_key: ...}) report asyncio.run(detector.analyze()) print(json.dumps(report, indent2, ensure_asciiFalse))然后在setup.py或pyproject.toml中定義好依賴將其打包成可通過(guò)pip install安裝的包或者直接提供可執(zhí)行的腳本。4.2 構(gòu)建GitHub Actions工作流接下來(lái)在項(xiàng)目的.github/workflows目錄下創(chuàng)建一個(gè)工作流文件例如api-doc-review.yml。name: API Documentation Review on: pull_request: paths: - **openapi.yaml # 當(dāng)OpenAPI規(guī)范文件發(fā)生變更時(shí)觸發(fā) - **openapi.yml - **openapi.json jobs: analyze-api-doc: runs-on: ubuntu-latest permissions: contents: read pull-requests: write # 需要寫權(quán)限以評(píng)論P(yáng)R steps: - name: Checkout code uses: actions/checkoutv4 - name: Set up Python uses: actions/setup-pythonv5 with: python-version: 3.11 - name: Install API Smell Detector run: | pip install api-smell-detector # 假設(shè)你的工具已發(fā)布到PyPI # 或者從本地安裝 # pip install -e . - name: Run Analysis id: analysis env: OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }} # 將LLM API密鑰存儲(chǔ)在GitHub Secrets中 run: | # 找到變更的OpenAPI文件簡(jiǎn)化處理這里分析指定文件 SPEC_FILE./api/openapi.yaml if [ -f $SPEC_FILE ]; then echo Analyzing $SPEC_FILE python -m api_smell_detector $SPEC_FILE report.json echo report$(cat report.json | jq -r tostring) $GITHUB_OUTPUT else echo No OpenAPI spec file found at $SPEC_FILE echo report{\issues\: []} $GITHUB_OUTPUT fi - name: Post Review Comment to PR if: always() github.event_name pull_request uses: actions/github-scriptv7 with: script: | const report JSON.parse(${{ steps.analysis.outputs.report }}); const { issues } report; if (issues issues.length 0) { let commentBody ## API文檔智能審查報(bào)告\n\n; commentBody 本次分析在您的OpenAPI文檔中發(fā)現(xiàn)了 **${issues.length}** 個(gè)潛在問(wèn)題。\n\n; // 按嚴(yán)重程度分組 const bySeverity issues.reduce((acc, issue) { const sev issue.severity || info; if (!acc[sev]) acc[sev] []; acc[sev].push(issue); return acc; }, {}); const severityOrder [critical, high, medium, low, info]; severityOrder.forEach(sev { if (bySeverity[sev]) { commentBody ### ${sev.toUpperCase()} (${bySeverity[sev].length})\n; bySeverity[sev].forEach(issue { commentBody - **${issue.type}** \${issue.method} ${issue.path}\\n; commentBody ${issue.description}\n; if (issue.suggestion) { commentBody 建議${issue.suggestion}\n; } }); commentBody \n; } }); commentBody ---\n*本報(bào)告由多智能體LLM系統(tǒng)生成旨在提升API文檔對(duì)自動(dòng)化Agent的友好度。請(qǐng)逐一審視上述問(wèn)題。*; // 創(chuàng)建或更新PR評(píng)論 const { data: comments } await github.rest.issues.listComments({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, }); const botComment comments.find(c c.user.type Bot c.body.includes(API文檔智能審查報(bào)告)); if (botComment) { // 更新已有評(píng)論 await github.rest.issues.updateComment({ owner: context.repo.owner, repo: context.repo.repo, comment_id: botComment.id, body: commentBody }); } else { // 創(chuàng)建新評(píng)論 await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, body: commentBody }); } } else { console.log(No issues found, skipping comment.); }4.3 關(guān)鍵配置與避坑經(jīng)驗(yàn)LLM API密鑰管理絕對(duì)不要將API密鑰硬編碼在代碼或工作流文件中。務(wù)必使用GitHub倉(cāng)庫(kù)的Settings Secrets and variables Actions來(lái)添加密鑰如OPENAI_API_KEY然后在工作流中通過(guò)${{ secrets.OPENAI_API_KEY }}引用。成本控制策略在Actions中每次PR觸發(fā)都會(huì)產(chǎn)生LLM調(diào)用費(fèi)用。為了避免“文檔每改一個(gè)字母就全量分析一次”的浪費(fèi)可以緩存分析結(jié)果如果OpenAPI文件內(nèi)容哈希值未變則跳過(guò)分析。增量分析更精細(xì)地使用git diff找出本次PR中實(shí)際修改的路徑paths和組件components只分析受影響的部分。這需要更復(fù)雜的工具邏輯。設(shè)置頻率限制可以在工作流中加一個(gè)條件例如if: github.event.pull_request.draft false僅在PR標(biāo)記為“準(zhǔn)備就緒”時(shí)運(yùn)行避免每次草稿提交都觸發(fā)。報(bào)告呈現(xiàn)優(yōu)化直接輸出一大段JSON到PR評(píng)論體驗(yàn)很差。上面的示例使用了Markdown格式并按嚴(yán)重程度分組可讀性更好。更進(jìn)一步可以生成一個(gè)可視化的HTML報(bào)告上傳到GitHub Actions的Artifacts并在評(píng)論中提供鏈接。處理誤報(bào)與學(xué)習(xí)初期系統(tǒng)肯定會(huì)有誤報(bào)??梢栽赑R評(píng)論的每個(gè)問(wèn)題旁添加“誤報(bào)”或“已修復(fù)”的反饋按鈕這需要更復(fù)雜的GitHub App集成。收集這些反饋用于持續(xù)優(yōu)化智能體的Prompt和判斷邏輯。與現(xiàn)有流程結(jié)合這個(gè)檢查可以作為代碼評(píng)審Code Review的強(qiáng)力補(bǔ)充但不是替代。建議將其設(shè)置為“非阻塞”檢查不強(qiáng)制要求通過(guò)初期以“提示”和“教育”為主待團(tuán)隊(duì)認(rèn)可其價(jià)值后再對(duì)critical級(jí)別的問(wèn)題設(shè)置必須修復(fù)的關(guān)卡。5. 超越檢測(cè)構(gòu)建Agent-Ready文檔的積極實(shí)踐檢測(cè)系統(tǒng)幫我們發(fā)現(xiàn)了問(wèn)題但最終目標(biāo)是產(chǎn)出高質(zhì)量的、Agent-Ready的文檔。這需要我們?cè)诰帉懞途S護(hù)文檔時(shí)就建立起一套積極的實(shí)踐準(zhǔn)則。5.1 編寫階段的“預(yù)防性”措施采用“文檔即代碼”Docs as Code理念將OpenAPI文檔YAML/JSON與業(yè)務(wù)代碼放在同一倉(cāng)庫(kù)管理。任何API的變更必須同步更新文檔并通過(guò)CI進(jìn)行校驗(yàn)。這從流程上保證了文檔的時(shí)效性。使用契約優(yōu)先Contract-First開(kāi)發(fā)在動(dòng)手寫代碼之前先和前端、移動(dòng)端、第三方消費(fèi)者一起評(píng)審并定稿OpenAPI文檔。這迫使你在設(shè)計(jì)階段就思考接口的清晰性、一致性和可用性從源頭上減少“壞味道”。工具如Stoplight Studio可以提供可視化的設(shè)計(jì)體驗(yàn)。利用模板和代碼生成不要從零開(kāi)始寫YAML。使用工具如OpenAPI Generator或Swagger Codegen可以從代碼注釋如Java的SpringFox、Python的FastAPI生成初始文檔框架。雖然生成的文檔通常需要大量潤(rùn)色但至少保證了基本結(jié)構(gòu)和語(yǔ)法正確。更重要的是可以創(chuàng)建團(tuán)隊(duì)內(nèi)部的OpenAPI文檔片段模板確保securitySchemes、error responses、pagination models等通用部分保持一致。為L(zhǎng)LM而寫而不僅為人在填寫每一個(gè)description字段時(shí)心里多問(wèn)一句“如果我是LLM僅憑這段文字能準(zhǔn)確理解該做什么嗎” 避免使用代詞“它”、“這個(gè)”明確指代。使用結(jié)構(gòu)化的描述例如對(duì)于查詢參數(shù)可以按“用途-是否必填-示例-備注”的格式來(lái)寫。5.2 維護(hù)階段的“增強(qiáng)性”手段豐富示例Examplesexamples字段是LLM的“訓(xùn)練數(shù)據(jù)”。為不同的場(chǎng)景提供示例創(chuàng)建成功、創(chuàng)建失敗驗(yàn)證錯(cuò)誤、查詢空結(jié)果、分頁(yè)第二頁(yè)等等。示例越豐富LLM的理解就越精準(zhǔn)。引入鏈接關(guān)系Links CallbacksOpenAPI 3.0的links和callbacks特性可以描述操作之間的關(guān)系和異步通知。雖然目前LLM可能還無(wú)法充分利用這些高級(jí)特性但這是向“可發(fā)現(xiàn)API”Discoverable API和HATEOAS邁進(jìn)的重要一步為未來(lái)更智能的Agent打下基礎(chǔ)。維護(hù)變更日志Changelog在文檔的info部分或一個(gè)單獨(dú)的x-changelog擴(kuò)展中記錄重要的、不兼容的變更。這有助于LLM和人類理解不同版本API的差異特別是在進(jìn)行版本遷移時(shí)。定期“健康檢查”將前面構(gòu)建的多智能體檢測(cè)系統(tǒng)不僅集成到CI也作為定期如每周運(yùn)行的獨(dú)立任務(wù)對(duì)全量API文檔進(jìn)行掃描生成健康度報(bào)告跟蹤“壞味道”數(shù)量的變化趨勢(shì)。5.3 度量Agent-Ready程度如何衡量我們的文檔是否真的對(duì)Agent友好了除了問(wèn)題數(shù)量的減少還可以定義一些可度量的指標(biāo)描述覆蓋率擁有非空、非模板化描述的路徑、操作、參數(shù)的百分比。示例覆蓋率擁有至少一個(gè)有效示例的請(qǐng)求和響應(yīng)的百分比。一致性得分基于命名、格式、錯(cuò)誤響應(yīng)模式的一致性計(jì)算的分?jǐn)?shù)。LLM理解測(cè)試構(gòu)建一套基準(zhǔn)測(cè)試使用固定的Prompt讓LLM如GPT-4基于文檔生成調(diào)用代碼然后自動(dòng)執(zhí)行這些代碼統(tǒng)計(jì)調(diào)用成功率。成功率是“Agent-Ready”程度的終極量化指標(biāo)。將文檔質(zhì)量從一個(gè)模糊的概念轉(zhuǎn)化為一系列可測(cè)量、可改進(jìn)的指標(biāo)是推動(dòng)團(tuán)隊(duì)持續(xù)投入資源進(jìn)行優(yōu)化的關(guān)鍵。從我推動(dòng)這項(xiàng)工作的經(jīng)驗(yàn)來(lái)看最大的阻力往往不是技術(shù)而是意識(shí)和習(xí)慣。開(kāi)發(fā)者習(xí)慣了為“看得懂的人”寫文檔。引入多智能體檢測(cè)系統(tǒng)和Agent-Ready標(biāo)準(zhǔn)初期會(huì)增加一些工作量可能會(huì)聽(tīng)到“這有必要嗎”的質(zhì)疑。最好的破局方式是快速展示價(jià)值在一次關(guān)鍵的跨團(tuán)隊(duì)聯(lián)調(diào)或第三方接入中因?yàn)槲臋n清晰明確對(duì)方用Agent快速生成了可用的集成代碼節(jié)省了數(shù)天的溝通成本。當(dāng)團(tuán)隊(duì)親眼看到一份優(yōu)秀的、機(jī)器友好的文檔所帶來(lái)的效率提升和協(xié)作順暢時(shí)他們就會(huì)從被動(dòng)的“遵守規(guī)范”轉(zhuǎn)變?yōu)橹鲃?dòng)的“創(chuàng)造價(jià)值”。這個(gè)過(guò)程本質(zhì)上是在為API生態(tài)的智能化未來(lái)鋪設(shè)軌道。
返回列表
PREV
查看更多資訊
NEXT
返回資訊列表
日本狠狠色| 精品久热| 日日操,夜夜撸| 99热xx| 婷婷五月天情色| 精品九九在线观看视频| 婷婷五月综合久久中文字幕| 日本nghangse中文字幕| 操大屄五月天视频| 日本精品人妻无码77777| 日本熟女二区| 国产做爰视频免费播放| 激情综合五月天| 五丁香激情综合| 成人欧美日韩| 丁香五月综合激情性爱| 丁香六月色| 国产AV一区二区三区最新精品| 99精品在线观看视频| 婷婷99狠狠| 亚洲婷婷综合视频| 亚洲激情Av| 99热这里只有精品青草| 综合五月婷婷| 五月天大香蕉| 超碰狠狠操| 狠狠草狠狠草| 5月婷婷6月六月丁香| 91啪级电影| 久久久18| 亚洲思思热久| 久久久久久天天日天天爱| 99日在线观看视频| 九九精品亚洲| 91丨九色丨大屁股| 中文字幕婷婷五月天| 99在线公开视频| 久久五月婷综合网| 婷婷的色色五月天| 成人婷婷| 狠狠爱综合网| 六月激情婷婷色| 天天色综和网| 激情五月婷婷在线区| 亚洲精品电影| 99re熱| 五月丁香好婷婷A片网| www.91在线看| 91人人操.COM| 丁香六月天婷婷在线| 超碰免费人人| 五月丁香av在线| 激情丁香婷婷五月天| 色婷视频| 内射激情在线| 另类图片五月天| 五月综合婷婷五月| 啊V视频在线观看| 97久久久久| 色五月婷婷在线| 五月天亭亭俺也| 久久久久久久久人妻| 色欲AV导航| 五月天综合激情网| 久久精品视频99| 成人午夜无码视频| 7EzOBIhNq85TO| 欧美激情综合五月色丁香| 日韩免费视频| 久久狠婷婷| av国产精品偷| 99精品视频在线| 五月天激情啪啪| 啪啪小说五月天| 激情五月天开心| 99操免费视频| 精品亚洲国产成AV人片传媒| 色原狠狠综合| WWW、日本色丁香co m| 六月丁香啪| 五月婷婷丁香在线视频| 99热18| 国产亚洲在线| 九九热婷婷| 黄色激情久久| 亚洲第一视频 久久| 久久这里有精品| 激情久久久久久久久久| www.wuyuetian啪啪| 丁香五月激情五月| 天天爱天天日| www.色色五月天.com| 色五月天堂| 久久伊人五月天| 九月停停| 婷婷六月综合在线| 亚洲成人av在线| 丁香五月性| 欧美A片在线视频免费观看| 婷婷之玖玖| 丁香六月婷婷久久综合| 久久丁香五月| 五月丁香亚州综合网| 五月婷婷婷综合网| 五月婷婷丁香网| 五月婷婷激情久久| 婷婷午夜综合| 色99网站| 亚洲精品第一国产综合亚AV | 午夜理论片最新午夜理论剧| 97色天堂| 五月亭亭色| 综合久久婷婷五月丁香| 超碰成人在线观看| xx久久| 欧美色播综合在线观看| 六月丁香久久| 五月丁香久久精品在线观看| 秋霞AV淫| 亚洲热久| 26uuu亚洲| 欧美一级色| 91精产一区三区免费观看| 亚洲激情 久久| 日韩淑女人妻luan伦激情精品一区二| 伊人超碰在线| 99性视频| 激情五月天福利| 色色综合色视频| 亚洲色婷婷五月天| 青青草Avb在线| 亚洲熟妇AV综合网五月丁香伊人 | 香蕉国产2013| 棕合影院色色| 97精品综合久久| 26uuu在线观看| 影音先锋美国A| 久热只有这里有精品| 这里只有精品久久| 久久综合首页| 丁香五月性爱| 无码se| 庭庭久久内射| 婷婷五月天最新综合你懂的| www.夜夜| 久草五月天电影网| 婷婷久久色五月婷婷久久久| 色婷婷九月| 日本人妻伦在线中文字幕| 丁香香蕉婷婷| 色99欧洲色19| 欧美久久久中文字幕| 成人小说 五月天 婷婷| 狠狠婷婷色| 婷婷五月天天| 色五月色五天色情网址| 色欲久久久久久综合网综合网| 婷婷性爱综合| 香蕉操亚洲| 亚洲一区国产传媒| 99热官网| 99热成人在线| 婷婷情色五月天| 伊人久久大香蕉网| 快乐婷婷五月天| 丁香五月婷婷影院| 99热99精品在线观看| 夜夜爽77777妓女免费下载| 久这里只有精品| 亚洲亚洲人成综合网络| 伊人五月丁香| 丁香五月性| 狠狠色噜噜狠狠狠888| 狠色综合网| 久久99热这里只频精品6学生| 2015好吊操| 99性爱视频| 婷婷五月天激情在线观看| 激情色播| 日本高清综合网五月丁香| 激情五月天第四色| 天天日天天摸| 天天操天天曰| 996er在线观看| 天天日天天插| 99热在线看片| 26uuu国产精品| 人人摸人人干| 婷婷激情六月| 久久99热久久99精品| 91 九色 入口| 亚洲乱码日产精品BD| 在线A色| 亚洲成人无码免费| 亚洲综合在线视频| 婷婷激情综合| 久婷婷久草| av五月丁香| 91丨九色丨国产打屁股| 热久视频| 99热国内| 综合久久婷婷| 久久182| www.99热| 91ncm视频| 久久老码第一| 欧美精品99| 在线观看免费视频| 久久人人看| 色天天综合| 亚洲成人在线免费| 国产操逼网站| 丁香五月婷中字在线| 综合激情在线视频| 丁香五月婷中字幕| 99爱免费视频在线观看| 六月五月久久丁香| 色激情综合狠狠婷婷| 丁香五月天堂网AV| 久久久久视剧HD| 99热这里都是精品| 婷婷午夜天| 色色色.COM| 婷婷伊人綜合中文字幕| 久热99热| 伊人网啪啪| 丰满人妻妇伦又伦精品国产| 久热免费视频| 色色色色网| 99精在线| 五月丁香六月婷婷欧美综合| 99精品免费欧美小视频| 99re这里只有精品视频了| 丁香五月婷婷激情小说| 四色永久成人网站| 久婷五月| 亚洲天堂久久| 天天性视频| 九热视频精品| 4399高清无码视频| 久久人人九| 99碰碰碰| 免费99色| 丁香五月最新网址| se99热久久一本| 激情 久久 婷婷| 久久久久9999| 韩国真做片在线观看| 99热精品在线播放| 婷婷久久久| 九九热在线视频观看| 婷婷激情六月综合| 中文字幕在线免费观看视频| 丁香色五月天| 亚洲视频在线观看| 成人草榴视频| AⅤ在线播放网| 五月天丁香婷婷久久九| 五月婷婷9| 国产九月婷婷| 夜夜大香蕉婷婷丁香| 久久99免费视频| 影院久久久| 99热免费18| 97伦色婷婷| 日本波多野结衣视频| 最新无码专区| 欧美日韩成人高清在线| 大香蕉av在线| 99色色最新视频| 久久99热 这里有精品| 97深爱伊人综合| 亚洲无码成人性爰网| 五月婷婷色播网| 五月婷久久| 天天干天天 亚洲| 五月婷六月天| 亚洲在线综合| 99热在线观看| 婷婷伊人75| 99九九99九九九视频精彩| 婷婷色五月丁香六月欧美啪| 五月天婷婷色播在线网| 天堂五月婷婷| 666555。COm毛片| 激情五月婷色| 丁香六月婷婷激情综合| 欧美va欧美va差| 一级黄色尤物综合视频手机在线观看| 三级黄网站| 婷婷久久五月| 色情五月天导航| 色吧五月婷婷| 狠狠草综合网| 婷婷综合激情| 五月做爱| 丁香五月天在线观看视频| 天天日夜夜草进麻麻的子宫| 99热精品在线| 成人αV视频免费观看| 久久激情四射| 五月天色婷好好| 日日艹思思热| 大香蕉AV在线| 九月婷婷色色| 怡红院精品视频久久久久久久久| 色玖玖综合网| 国产高清视频91九九九久久久| 91丨九色丨熟女丰满| 美妞av| 女人天堂 AV| 国产.亚洲.欧洲视频在线| 五月综合久久| av久热| 五月天激情开心网| 婷婷五月天激情网| 狼人狠狠操| 秋霞电影理论| 综合久久婷婷| 丁香五月婷婷啪| 色噜噜狠狠狠综合曰曰曰| 97人人做| 天堂综合久| 狠狠色五月| 色色色婷婷五月天| 9 大屁股在线视频精品| 色狠狠综合| 色婷婷99| 天堂在线9| 久久99这里只有精品视频| 日本九九网| 色综合综合综合| 久99视频| 91男同| 奇米影视777在线_在线观看午夜_h小视频在线观看_岛国大片 | 老师高潮流白浆喷水的A片| 日韩久热| 香焦网五月天| 九九综合网色全集| 日本成人噜噜噜| 欧美色片中文字幕久久久久| 天天噜天天爱| 蜜臀AV在线观看| 成人 在线 日韩| 五月丁香啪啪| 欧美日韩国产一区二区| av人人干| 久久婷婷五月激情综合| 99免费| 激情五月婷婷色综合| 99这里只有精品国产| 91色在线/日韩| 日都一级A片| 26uuu欧美宗合| 五月色情| 色播婷婷五月天| 久久精品国产AV一区二区三区 | 99热资源在线| 97影院一级片| 91欧美| 欧美在线操| 色五月五月婷婷| 铁牛TV人妻| 色五月婷婷九月| 激情五月天第四色| 2017人人操| 大香蕉中文| 99热资源在线| 区区久久妻| 色婷婷狠狠| 日韩色色网| 99热精品中文字幕| 一區四區歐美日韓| 97超级啪啪在线观看| 色婷婷先锋| 五月婷狠狠| 五月天婷婷婷| 97人人干人人操| 久久九九99| 五月天婷婷六月激情网| 中文字幕1区2区。| 激情综合激情综合| 色五月婷婷五月丁香五月激情五月视频| 婷婷五月天开心网| 26UUU精品一区二区c〇m| 91色五月在线观看| 99碰碰视频| 日本91在线| 婷婷五月天成人网| 欧美日韩AAAA| 亚洲久热| 丁香五月激情啪啪综合| 国产精品成人AV在线| 狠狠综合| 精品五月花| 大香线蕉伊人| 99热在线中文字幕| www.91在线观看| 色五月成人| 天天射夜夜骑| 亚洲视频二区| 婷婷天堂伊人| 久99热| 精品婷婷五月视| 超碰人人摸AV| 婷婷五月天亚洲| 激情黄色五月天| 午夜福利8055| 天天弄天天操| 五月丁香六月激情在线| 婷婷成人综合免费视频| 综合网啪| 丁香五月天成人| 色婷婷天堂| 天天AV导航网| 97久久精品| 亚洲字幕AV一区二区三区四区 | 婷婷五月天激情网| 裸体美女丁香五月天。| 五月婷成人网| 9色在线| 99综合入口| 久久这里都是精品| 五月综合色| 天天摸天天爽| www.99视频| 九九爱精品网站| 色香欲综合| 色五月婷婷五月天| 欧美色五月天| 九九操综合网| 99热欧| 天堂久久婷婷| 婷婷之玖玖| 九九9久九9国产视频| 五月丁香黄色视频| 在线观看免费狠狠色丁香香综合| 久久人妻伦理| 99热在线免费| 天天干天天爽天天操| 无码九九| 天天爽在线视频| 午夜婷婷久久| 美国不卡视频| 一级性爱大片| 婷婷丁香五月天色色| 免费视频WWW在线观看网站| 久久婷婷91| 99热在线精品观看| 天天爽综合网| 天天干天天射综合网| 丁香婷婷丁香五月欧美人| av在线免费播放| 亚洲有码在线视频| 亚洲婷婷激情综合激情999精品| 色综合99无码 | 99热这里精品| 色五月天成人| 激情五月影院| 69色婷婷| 午夜成人AV在线| 99热这里只有精| 天天色综网| 色婷婷激情五月天在线观看| 婷婷色5月激情网| 色久综合天天做视频| 五六月丁香激情视频| 五月婷婷五月天激情视频| 色综合色| 日韩狠狠色婷婷| 亚洲色欲欧美一区二区三区| 激情亚洲色图片丁香综合| 激情com| 色色色视频免费无码| 99er精品| 成人欧美Va| 九月婷婷丁香| 另类激情中文| 大香线蕉伊人| 九色婷婷| 黄色网址五月婷婷| 久久婷婷五月综合啪| 婷婷成人AV| 成人婷99最新| av在线超清中文| 一本久久亚洲五月婷婷| 亚洲激情网站| 91.com男女操| 色婷婷六月| 97日韩无套内| 9久9久| 亚洲六月婷婷| 狠狠色综合777| 天天摸天天高潮天天爽| 庭庭久久内射| 青柠影视免费高清电视剧| 伊人久久丁香狠狠婷婷综合香蕉 | 日本久碰| 九九99在线免费在线观看视频| 99噜噜噜在线播放| 色区域网站视频| 99性爱视频| 天天色综网| 91丁香综合| 九月av在线| 成人在线网| 狠狠va| 色五月婷婷激情| 在线视频你懂得| 白人荫道BBWBBB大荫道| 久久伊人9| 99 频99热国里只有精品| 久久色这里只有精品| 97视频91| 五月停停99| 99热这里只有精品1025| 色播五月丁香| 91超级碰碰| 操比激情五月| 久久er九九| 色欲午夜无码久久久久久张津瑜| 亚洲精品V天堂中文字幕| 综合激情在线观看| 婷婷六月中文字幕| 91九九| 中文字幕人妻一区二区| 久久久久久久综合狠狠综合| 丁香婷婷情色五月天| 精品人妻伦九区久久AAA片| 九九美女视频| 天天射射夜| 激情综合网址| 亚洲视频无| 丁香五月婷婷激情123| 色吧五月婷婷| 伊人影院久久网| 丁香六月av| 五月天综合激情网| 成人一区在线观看| 五月精品免费XXX| 玖玖婷婷五月天| 第四色网婷婷| 五月开心激情| 五月刺激丁香月综合| 99在线er热| 亚洲婷婷久久综合| 色99婷婷五月天| 开心激情久久久久久久| 色五月婷婷五月天| 97爱艹婷婷开心丁香激情综合| 色婷婷欧美| AV性爱在线| 六六久久黄色| 久热中文字幕在线线观看| 色香欲综合| 色婷婷亚洲| 国产美女视频久| 丰滿爆乳一区二区三区| 色婷婷丁香五月天激情综合网| 丁香色五月天| 热中文字幕| 五月婷婷99热| 亚洲精品亚洲人成人网| www.五月婷婷久久.com| 99九九综合久久九九| 99色色网| 婷婷丁香九月| 婷婷五月天影院| 色色五月天网站| 亚洲成人网站在线播放| xx久久| 停停五月色宗合| 国产精品岛国片在线观看免费| 色婷婷综合网站| 色五月天婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷 | 超碰成人电影| 久久丁香| 丁香婷婷综合激情五月色| 丁香六月天婷婷在线| 99热综合网| 亚洲精品色色| 国产精品天天狠天天看| 天天做 天天爱| 免费日本aⅴ中文字幕 | 人人干女人| 日韩AV片| 26uuu淫色| 亚洲亚洲人成综合网络| 激情婷婷五月天日本系列| 婷婷六久久| 色婷婷狠狠| 九九精品热播| 综合五月天| 五月激情开心婷婷| 91 久热| 欧美性丁香色色五月天干干| 综合另类视频| .精品久久久麻豆国产精品| 五月丁香啪啪综合网| 五月婷九月| 久99热在线观看| 婷婷91| 色五月综合| 婷婷伊人久久综合| 欧美日韩国产一区| 99热久久这里只有精品| 国产综合网在线| 色噜噜狠狠色综合成人网| 天天爽天天日| 天天插天天插天天插| 日本色色网站| 国产精品国产成人国产三级| 美女天天爽| 婷婷伊人| 大大香蕉综合在线| 亚洲热视频在线| 五月丁香六月欧美| 啊V视频在线观看| 99婷婷精品推荐在线视频| 国产视频婷婷| 婷婷五月天无码熟女| 午夜福利成人AV91| 思思99热| caop在线| 久热播这里只有精品| 日本婷久久| 99riav 亚洲| www.婷婷五月天| 色青青视频| 五月色婷婷影院| 婷婷视频在线碰| 色综合久久久久| 久久久久人妻精选| 色五月丁香五月激情五月激情| 五月色情婷婷| 国外亚洲成AV人片在线观看| 无码人妻激情| 99热在这里只有精品| 五月丁香综合网色欲| 色色婷婷丁香五月天| 国产精品99久久久久久久女警| 激情六月婷婷| 激情丁香五月婷婷啪啪| 婷婷五月天国产手机在线视频观看| 五月婷婷黄| wwwav大香蕉| 国产欧洲欧洲精品久久| 久久丝袜婷婷| 色色色色综合| 天天色综合网1| 夜夜躁狠狠 | 日本在线视频www色| 啪到高潮激情丁香五月| 3p日韩网站视频| 无码se| 玖玖婷婷综合| 9九色首页| 另类图片五月天激情| 七月婷婷色香综合网| 九九色色| 婷婷成人五月天成人文学| 97干在线观看视频| 日韩另类在线观看| 丁香六月婷婷| 99re热在线视频观看| 狠狠做深爱婷婷久久综合一区| 99re热久久| 国产成人VA| anquye伊人| 五月丁香激情片| 天天干,天天舔| 激情五月天色色网| 9久热| 97人人草| anquye伊人| 丁香女人五月天| 综合激情五月四射婷婷| 精品无码av丁香五月激情| 99在线精品视频观看免费下载| 538任你爽| 黄色三级日本| 欧美在线视频99| 丁香久久| 99re在线观看视频| 亚洲麻豆乱码国产2028| 国产成人+亚洲+欧洲| 26uuu亚洲精品国产| 天天做天天摸| 久久久久网站| 六月婷婷开心| 日本人妻伦在线中文字幕| av大片在线| 九九色情网五月天| 亚洲一区国产传媒| site:pzdcoin.com| 天天拍夜夜爽日日| 色婷婷激情五月天| 99在线资源| 五月丁香婷婷综合网| 99热在线观看| 五月天丁香花婷婷| 欧洲综合视频| 亚洲 在线 性爱 | 婷婷五月天xxx| 婷婷五月天亚洲图片| 色五婷婷开心缴| 久久xxxx| 久久R激情| 日韩综合久| 色色色色欧洲| 丁香婷婷综合激情五月色| 五月丁香六月综合激情| 日本天天操| 国产AV成人精品| 亚洲综合视频网| 五月婷婷狠天天色综合| 强伦轩人妻一区二区电影| 91九色国产| 亚洲九N| 亚洲成人av在线播放| 五月天丁香六月综合| 五月婷婷色吧!| 久久久99免费视频| 夜夜嗨一区二区三区直播内容| AV免费在线网站| 熟女色专区| 夜夜撸天天操| 91久操| 成人午夜在线视频| 99这里精品| 五月天婷综合| 婷婷综合性爱网| 999婷婷综合| 丁香五月婷婷俺也要去| 六月婷婷色综合| 91九色无码内射| 天天拍天天做视频| 久久综合五月天| 婷婷五月天97干| 热99这里只是精品| 天天爱天天操| 九色视频九色九色91jiuseshipin| 色婷婷97| 色色射| 麻豆AV一区二区三区| 狠狠人妻色综合| 婷婷情色激情| 少妇AB又爽又紧无码网站| 婷婷丁香九月| 久久六月天| 亚洲中字AV电影在线网站| 婷婷久久网| 久久久无码精品成人A片小说| 成人.在线日韩| 五月婷婷高清| 综合五月婷婷| 无码髙清| 天天爽天天爽视频| 色五月天婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷婷 | 东京热免费视频网站| 99色热综合| 被强行糟蹋的女人A片| 超碰亚洲天堂| 99热这里只有精品1025| 婷婷丁香成人五月天| 九九精品在线观看视频6| 亚洲蜜桃精久久久久久久久久久久| 久久婷五月| 丁香五月91| 二级黄色毛片| 天天色天天| 99久久高清视频| 婷婷五月天堂一本在线| 色欲AVV| 日韩无码人妻一区二区三区综合| 亚洲人妻av| 九九激情网| 深爱激情五月天| 99久久免费性爱视频`| 五月丁香香蕉| 日日爱678| 极品人妻VideOssS人妻| 五月天色婷婷激情综合| 午夜大香蕉| 成人羞羞啪啪 全 视频| 狠狠干综合| 五月婷婷这里都是精品| 成人午夜天| 天天操夜夜肏| 婷婷五月激情视频网| 淑女丝袜bi操逼123| 黄色91在线观看| 激情视频综合| 六月色色| 能看的AV| 五月丁香六月情亚洲| #NAME?| 亚洲国产99| 激情五月天综合网| 色色色色色色色色网站| 人人玩人人橾| 久久99最新地址| 亚亚州久久高潮| 婷婷久久五月天丁香| 99操| 色婷綜合网| 国产色色小草视频| 色五月婷婷91| 六月丁香啪| 2018夜夜草| 草综合14| 久99热| 久久97久久99久久综合欧美| 丁香五月色欲| 婷婷六月色开| 久久久99精品免费观看| 天天综合中文| 婷婷香香五月| 色噜噜丁香| 五月天激情久久| AV九九| 97色射| 五月丁香福利| 最新精品视频99| 1囯产午夜仑鲁鲁| 丁香五月天啪啪| 久久婷婷五月综合色播| 天天综合网~91| 婷婷在线视频| 狠狠色狠狠操| 日韩无码一区二区三区四区| AV大片在线观看| 欧美激情综合| 思思精品热在线| 97人人射| 中文字幕高清av| 色五月激情网| 婷婷激情六月| 天天操夜夜夜拍拍拍| 激情无码网| 久久精品A片777777| 激情 婷婷| 青青草护士中出内射-欧美电影在线天堂新版| 超91在线视频| 一本大道熟女人妻中文字幕在线| www.99热精品| 狠狠插狠狠| 青草青草久热这里只有精品| 99热欲| AA丁香综合激情| 婷婷五月色综合| 五月丁香激情在线| 五月婷婷激情综合在线| 色婷婷久久视屏| 亚洲V国产V欧美V久久久久久| 棕合影院色色| 99热精品在线播放| 激情五月婷婷网在线观看| 色琪琪一综合久久激情五月视频| 十二区无码| 欧美成人精品A片免费一区99| 99久久婷婷五月综合| 国语精品探花| 丁香五月宝贝激情网| 91狠狠综合久久| 在线看黄色| 伊人香大香蕉视频| 激情第四色| 色色色色色综合| 99久精品视频| 日本狠狠网| 欧美激情凹凸丁香网| 天天在线久久综合 | 日本婷久久| 99A片| 婷婷五月天另类网站| 99热精品在线播放观看| 99色视频| 九九色精品| 91人人网| 色域五月婷婷丁香| 五月婷婷六月丁香首页| 9一精品视频观看| 琪琪狠狠干| 亚洲岛国电影| 色99久草在线| 99热最新国内| 五月综合激情网| 999热视频精品99免费在线| 男女啪啪做爰高潮无遮挡| 九九色精品| 五月综合久久| 色丁香五月婷婷| 乱岳熟女50岁| 专区无日本视频高清8| 国外亚洲成AV人片在线观看| 九九伊人网| h在线看免费版在线看| 超碰狠狠操| 欧美三级A做爰在线观看| 天天干,夜夜爽| 四川BBB搡BBB搡多人乱亂| 五月婷婷深深爱| 亚洲V国产V欧美V久久久久久| 国产精品99久久久久久久女警| 激情五月婷| 亚洲情综合五月天| 五月天丁香婷婷视频网址| 色天使久久综合| 超碰99成人在线| 热996精品在线观看| 欧美乱码国产一级A片| 热99精品视频五月| 草草视频91| 亚洲激情电影五月天色婷婷丁香一起草| 色噜噜狠狠色综合日日免费| WWW.桔色成人.COM| 五月激情六月婷婷| 亚洲午夜电影| 99热精品在线观看| 日韩av手机在线观看| 91色色色视频| 一级性感黄色内射视频| 中文字幕婷婷五月天| 蜜臀九九九九| 婷婷丁香十月| 日韩中文欧美| 婷色影院| 婷婷五月天丁香社区| 性爱综合网| 婷婷成人综合五月| 色停停五月,在线观看| 91丨九色丨高潮丰满日本| 久久538| 婷婷热色| 久久多色| 五月开心婷婷| 欧洲亚洲午夜| 亚洲亚洲人成综合网络| 99热999| 色色精品色| 九九热精品6| 狠狠爱综合| 无码视频国内精品久久久| 亚洲超级碰| 777久久综合视频| 色五月综合在线| 色欲色香综合网| 五月激香蕉网| 97香蕉碰碰人妻国产欧美| 狠狠999| 五月丁香婷草| 日韩乱轮AV| 成人婷99最新| 婷婷五月天日本无码| 色狠狠综合| 日本97人人| 激情五月天在线观看色婷婷| 99精品福利视频| 狠狠干综合| 欧美久久网| 天天狠狠色综合| 色欲色香综合网| 九九热99精品| 婷婷久久五月天亚洲欧美国产日韩在线观看 | 婷色五月| 综合网狠狠| 思思久久思思| 狠狠狠狠狠狠狠狠| 日本 色综合| 亚洲五月丁| 5月丁香啪啪啪| 91xxxx九色| 色婷婷五月婷婷五月婷婷五月| 丁香五月91| 麻豆123区| 春色激情第四色| 婷婷五月激情五月激情| 亚洲无码黄色| 五月婷婷人妻| 亚洲精品一区无码A片| 日本色道视频网站| 综合伊人久久| 九一牛视频探花| 天天做天天要天天爽| 色婷婷影视| 五月天天综合| 丁香婷婷噜噜| 碰超亚洲| 丁香五月天欧美| 99综合| 丁香六月婷婷激情综合| 激情五月天啪啪| 91热久| 深爱婷婷丁香五月激情| 中文字幕无码AV| 高清激情av在线观看| 色综合激情| 人人摸人人操人人爽| 99久视频| 久久精品噜噜噜成人A∨色欲| 五月婷丁香亚洲| 桃色成人网| 伊人六月无码视频| 午夜天堂一区人妻| 久久久久综合激动五月天| 色五月成人| 婷婷欧美激情综合| 天天操天天干天天日| 丁香五月激情六月欧亚激情综合导航| 色色色国产| 亚洲综合成人网| 亚洲色久| 亚洲激情亚洲激情 | 亚洲AV久久久久久久久久久久久久久久 | 五月草视频| 97婷婷丁香五月综合| 丁香六月伊人| 97AV人人插人人操| 涩五月婷婷| 草榴视频网| 久久久香| 丁香成人五月天| 天天插天天干| 色婷婷最爱五月| 亚洲亚洲人成综合网络| 五月欧美色色五月| 丁香婷婷影院| 99热这里只有精品1| 《丁香激情综合久久伊人久久》影视在线观看 -高清预告手机免费播放 -三妹影院 | 婷婷八月激情| 国产成人精品亚洲线观看| 五月天自拍网| 久草 tingting| 六月激情久久| 人人97碰| 丁香激情网| 久久成人天| 久久色午夜在线导航| 久久九九@| 五月婷丁香花| 狠狠色噜噜狠| 热思思九九| 天天操天天操天天操| 国产91在线视频| 久久98热re| 丁香五月在线伊人| 无码成人播放器| 精品久久人妻| 五六月婷婷| 综合狠久久| 丁香六月婷婷久久综合| 婷婷五月天AV| 江苏少妇性BBB搡BBB爽爽爽| 激情五月色播五月| 精品久热| 久热A片| 久久永久视频| 五月天六月天| 综合久久伊人| 天天爽天天操| 九九性视频| 五月香婷婷| 九九99精品视品| 干一干xxxx| 天天天天天色| 六月婷婷九月丁香| 色色无码| 色色无码| 69婷婷丁香午夜| 97色啪| 人与禽A片啪啪| 991国产精选视频在线播放下载| 思思热思在线精品视频| 五月天婷婷涩涩| 色爱综合网| 另类激情中文| 婷婷激情五月天色| 婷婷综合97| 我淫我色婷婷五月天激情四射| 激情亚洲婷婷| www.六月丁香看AV| AV九九| 丁香五月天婷婷大香蕉| 色色五月丁香| 五月天激情四射网站| 日韩激情人伦人| 欧美日朝成人| 97人人操人人操人人操人人| www.夜夜操| 男人天堂99| 婷婷.com| 男人综合网| 九九精品热| enecarbon-materials.com污K127封锁请涟系@wip1688 | 日熟女| 亚洲AV日韩在线观看| 欧美性丁香色色五月天干干| 五月婷婷中文| 丁香五月天五码婷婷| 玖热精品综合视频| www.99精品视频| 亚洲av另类在线观看| 99综合网| 婷婷激情小说| 激情综合网五月| 婷婷午夜天| 欧美综合激情五月| 激情综合播播| 激情九月综合| 老妇操B| AV六月丁香| 91黄色五月天视频| 禁欲电影完整版在线播放| 丁香五月影院| 翔田千里 50岁 无码| 日本成人噜噜噜| 无码 色| 牛牛碰免费| 激情婷婷六月| 5月婷婷性视频| 丁香六月视频| 亚洲人人96@| 无码地址| 狠狠色噜噜狠狠色噜噜噜999| 丁香五月综合婷婷| 久久久久久激情| 婷婷五月天堂| 久热人妻| 婷婷九月色| 超碰人人干| 91久久婷婷| 久久99久久99久久99人受| 午夜免费试看| 欧美人妻一区二区| 高清无码入口| 九月婷婷久久| 五月激情综合网| 色婷婷成人做爰A片免费看网站| 久久婷婷五月天| 欧洲色区| 精品成人在线| 99ri6在线视频| 婷婷色一二三区波多野结衣| 午夜色丁香| 九月av| 91 九色 熟女| 久青青久| 2025天天爽天天摸| 久狠日av| 婷婷五月天视频| 五月丁香久| 99这里有精品| 610018岁成人视频| 日本97在线看片| 婷婷网影院| 性爱动图国产麻豆一区二区三区| 狠狠操天天操| 一级二级香港秋霞欧美欧美秋霞| 天天狠狠六月婷丁香影院| 在线观看免费狠狠色丁香香综合| 中文字幕综合网| 五月丁香激情综合网| 新激情婷婷| 97欧美在线| 99在线观看视频免费| 婷婷六月插屄激情| 五月天涩涩| 日韩人妻无码专区| 图片区 小说区 区 亚洲五月| 久久99激情五月天| 婷婷激情六月综合| 精品色情一区二区三区四区| 婷婷五月天激情AV影院| 久久色亭亭五月天| 九九精品免费| 1024AV视频| 97资源欧美日韩大香蕉超碰一区| 婷婷五月四狠狠| 五月天伊人手机在线播放AV| 婷婷五月天激情小说| 天天日天天操心| 琪琪色网址| 久久综合激情| 日本va视频| 色婷婷亚洲| 日韩欧美不卡| 色综合天堂| 久久五月天黄色五月天色网址| 色五月婷婷九月| 26uuu国产| 五月婷婷黄色毛片| 五月天婷婷色五月天| 日本色天堂| 国产色五月婷婷| 97狠狠色| 天堂网亚洲色图| 丁香五月天啪啪| 亚洲激情97五月天| 99精品在线观看视频| 99视频日韩| 日韩人妻无码一区二区| 思思热在线精品视频| 国产乱妇无乱码大黄AA片| 久久99精品久久久久久三级| 婷婷九月激情| 中文资源在线a | 十一月婷婷激情四射| 免费看欧美成人A片无码| 丝袜激情网| 天天精品视频在线观看视频| 婷婷五月综合激情| 99精品偷拍视频| 丁香五月综合在线播放| 超碰久热| 欧美日韩五月婷婷| 婷婷五月天激情影片| 九九在线视频| 色色色色色五月丁香| ss视频xx91| 久久久天堂国产精品女人| 五月丁香福利| 青青草五月天| 婷婷五月天成人视频| 免费99情趣网视频| 色五月婷婷av| g00d人体西西| 五月丁香六月激情啪| 无码人妻少妇色欲AV一区二区 | 操人视频91| 99热最新网址| 性爱电影科技贸易有限公司| 91丨九色丨国产打屁股| 婷婷五月丁香色播| 五月好婷婷| 性爱激情五月| 五月天婷婷网站| 色综合色| 色欲婷婷夜夜| 99爱这里只有精品免费视频| 激情图片婷婷| 香蕉人在线香蕉人在线 | 色激情网| 丁香五月停停av| 大香蕉色婷婷伊人在线| 亚洲色婷婷激情| 大香蕉综合| 操91| 超碰AV在线| 精品99在线| 亚洲精品午夜国产va久久成人| 97操资源婷婷| 五月婷婷六月奇米网丁香| 青青久在线视频免费观看| 五月婷婷综合激情| 五月天综合视频| 99色色热| 五月丁香啪| 婷婷五月天在线观看av| 国产精品色色| 久久婷婷五月国产色综合激情| 99爱视频免费| 五月噜噜噜色综合| 国产伦亲子伦亲子视频观看| 狠狠狠激情网| 国产美女无遮挡裸体毛片A片 |