Logic

Logic 是什麼？

Logic 是一個規格驅動的代理平台，用於將純英文規格轉換為生產就緒的 AI 代理。它專注於從定義行為到可呼叫 API 的端到端工作流程，包括評估、版本管理和運營可見性。

核心理念是，您撰寫的代理規格定義其輸入和輸出。Logic 隨後生成測試變更、管理版本、透過 API 暴露代理以及路由請求至模型所需的工具。

主要功能

• 基於規格的代理定義（輸入/輸出）：在規格中定義行為，讓代理的介面和預期結果從您的書面定義衍生。
• 內建測試框架，含內嵌預期輸出：在代理定義中直接新增測試案例，儲存時執行以捕捉回歸問題。
• 自動回歸偵測與 CI/CD 整合透過 API：改用自動化管線執行評估，而非僅依賴手動測試。
• 版本管理、差異比較與回滾：每個規格變更皆會版本化並比較差異，提供可逆轉性和版本固定以維持 API 穩定。
• 非技術規格編輯者的審核工作流程：使用審核讓非工程師更新代理邏輯，而無需重新部署或在獨立工具管理提示。
• 類型化 REST API 生成與自動生成文件/UI：儲存代理規格即可生成嚴格類型化 API、文件以及具輸入表單的可分享網頁 UI。
• PII 遮罩與報告：偵測並遮罩文字中的個人資料，同時產生偵測內容的詳細報告。
• 政策評估與審核決策：評估產品清單是否符合政策，以核准、拒絕或升級項目。
• 智慧模型路由，含容錯與快取：Logic 根據任務複雜度，將請求路由至 OpenAI、Anthropic、Google 和 Perplexity；同時提供自動容錯與確定性工作負載的執行快取。
• 執行記錄用於除錯：記錄每個呼叫的完整脈絡（輸入/輸出、模型推理、延遲），跨代理版本適用。

如何使用 Logic

1. 撰寫或選擇代理規格（包含定義預期輸入和輸出）。
2. 新增內嵌測試案例與預期輸出，儲存時執行測試套件以驗證行為。
3. 依需求迭代規格，使用版本管理、差異比較與審核工作流程。
4. 準備就緒後，儲存以生成嚴格類型化 REST API、API 文件以及可分享網頁 UI。
5. 使用執行記錄檢查特定呼叫發生內容，並診斷錯誤的脈絡與延遲。

使用案例

• 合約條款審核：使用「Contract Clause Analyzer」規格標記風險條款並從合約提取關鍵條款。
• 跨系統記錄比對：套用「Entity Matcher」規格比對記錄並提供信心分數。
• 發票與採購訂單提取：使用「Invoice & PO Data Extractor」解析多格式文件並提取結構化明細項目。
• 文字工作流程的個人資料處理：執行「PII Redactor」偵測並遮罩個人資料，同時產生偵測實體報告。
• 產品清單審核：使用「Product Listing Moderator」比對清單與政策規則，決定核准、拒絕或升級。

常見問題

Logic 是否需要工程師為規格變更重新部署？

網站描述版本管理和審核工作流程，讓工程師維持穩定 API，同時透過審核更新代理邏輯，而無需重新部署或在獨立工具管理提示。

提供者失敗或錯誤時會如何？

Logic 包含自動容錯，若提供者回傳錯誤或中斷；同時依任務複雜度、延遲與成本路由請求。

Logic 如何在發佈前驗證代理行為？

每個代理包含內建測試框架：內嵌測試案例與預期輸出匹配，儲存時執行，具回歸偵測以捕捉問題；可透過 API 整合 CI/CD。

可以從代理規格生成 API 和 UI 嗎？

可以。Logic 根據儲存規格生成嚴格類型化 REST API、自動生成 API 文件，以及具輸入表單的可分享網頁 UI。

部署後有哪些可見性？

Logic 記錄每個 API 呼叫的完整執行脈絡，包括輸入、輸出、模型推理、延遲、錯誤呈現，以及跨代理版本的執行歷史。

替代方案

• 具內建提示與評估的無/低程式碼代理建構器：這些能幫助非開發者組裝代理，但可能較少依賴規格驅動的版本管理，以及從書面定義產生類型化 API。
• 提示評估工具與自訂測試框架：你可以組合獨立的提示測試、記錄與 CI 步驟，但這通常需要比使用統一平台更多的整合工作。
• 開源協調框架：你可以自行建置路由、記錄與評估，但這會將基礎設施與營運工具的負擔轉移到你的團隊。
• 自訂 API/前端堆疊：如果你自行建置類型化 REST 端點與 UI，可能獲得更多彈性，但你需要手動實作版本管理、測試工作流程與執行可觀察性。