text-to-sql

Text-to-SQL 技能是一種專門的代理能力，旨在架起人類可讀的自然語言與關聯式資料庫操作之間的橋樑。它透過將使用者的意圖轉換為有效、高效且安全的 SQL 語法，為開發人員、資料分析師和系統管理員提供支援。該技能與 database-architect 架構深度整合，能夠理解資料庫表之間的關係、外部鍵和索引策略，確保產生的查詢不僅語法正確，且針對目標環境進行了效能最佳化。

• 進階查詢生成：將複雜的自然語言提示轉換為精確的 SQL 查詢，包括對連接（joins）、聚合（aggregations）、子查詢及條件過濾的支援。

• 基於架構的精確度：直接參考 database-architect 的定義來進行資料表與欄位驗證，從而最大限度地減少幻覺並降低執行時錯誤。

• 安全優先設計：強制使用參數化查詢以防止 SQL 注入攻擊，並具備語法驗證與測試執行功能。

• 效能最佳化：自動考量連接效率、索引使用及資料傳輸限制，以產生高效能的程式碼。

• 評估整合：與 promptfoo 測試框架相容，允許對語法準確性、功能正確性及架構合規性進行嚴格評估。

• 提供完整的資料庫架構（包括資料表定義、欄位型別與約束）以確保輸出具備高保真度。

• 對於涉及多表連接或分析報告的複雜查詢，建議使用思維鏈（chain-of-thought）提示，確保邏輯流向正確。

• 務必對 SELECT 操作設定明確的限制（LIMIT），以在進行臨時探索時保護資料庫穩定性。

• 將輸出視為參數化查詢；避免手動進行字串串接，以維持安全性協定的合規性。

• 最適用於生產或開發環境中的報告生成、資料探索、稽核記錄及臨時問題排除等任務。