Superflows是什麼
Superflows是一套專為SaaS產品團隊所設計的嵌入式AI助手工具。使用者可以以自然語言來查詢產品相關資料、獲得文件中的答案、生成分析圖表,而在確認之後,還可以讓該助手透過產品API來執行相關操作。
該專案同時提供託管雲服務、開發者控制台、React介面組件以及Apache-2.0開源後端。目前官方網站仍可訪問,但官方文件網站已無法使用,且程式碼更新時間較早,因此在進行實際採用之前,應先確認其維護與支援狀況。
一句話介紹
Superflows將OpenAPI、產品文件、代碼分析與聊天介面結合,打造出可嵌入SaaS應用的AI Copilot。
核心組成
| 組件 | 主要作用 | 交付形態 |
|---|---|---|
| Superflows後端 | 規劃API呼叫、檢索知識和分析數據 | 開源或託管 |
| Developer Dashboard | 配置、測試、調試和查看用量 | 雲端控制台 |
| Chat UI | 把聊天按鈕、窗口或側欄嵌入產品 | 開源React組件 |
| Playground | 在上線前驗證回答和動作 | 控制台測試環境 |
| Cloud API | 連接前端與託管助手 | 按查詢額度計費 |
自然語言調用產品API
Superflows會讀取產品的OpenAPI規範,了解可用的端點、參數及回應內容,再根據用戶的問題選擇適當的函式來呼叫。它很適用於已經擁有穩定API的SaaS產品。
- 上傳OpenAPI規範快速導入端點
- 選擇允許助手使用的API操作
- 將自然語言問題轉換為端點調用
- 組合多個回應完成複雜查詢
- 將調用結果整理成可讀答案
- 對失敗、權限和無數據情況給出解釋
- 在開發者模式查看計劃與呼叫過程
數據分析與圖表
助手可根據API返回的數據編寫程式進行計算,並生成用戶所需的圖表。如此一來,產品團隊便能減少為每個臨時問題單獨開發看板的必要。
- 計算匯總、趨勢、比例和排名
- 比較時間段、客戶群和業務渠道
- 將多個端點數據組合分析
- 生成適合問題的可視化圖表
- 用文字解釋關鍵結果和異常
- 限制代碼運行資源和允許的依賴
- 核對金額、時區及指標口徑
基於文件的問答
Superflows透過檢索增強方式來回應與靜態產品相關的知識問題,同時能連接API數據與文件。使用者既可詢問如何使用各項功能,亦可查詢自身的業務數據。
- 導入產品說明和幫助內容
- 根據用戶問題檢索相關片段
- 生成與產品功能一致的答案
- 在一個對話中結合知識與即時數據
- 降低用戶離開產品搜尋文件的比例
- 從反饋中發現缺失或過期內容
執行產品操作
助手不僅能回答問題,還能負責資料的建立、更新或移動等操作。對於可能會產生影響的動作,Superflows會先呈現相關計劃,並請求使用者確認。
- 創建任務、提醒或業務記錄
- 更新客戶、交易或工作流狀態
- 批量調整滿足條件的數據
- 在執行前展示動作和參數
- 要求用戶明確確認潛在破壞性操作
- 記錄呼叫結果和失敗原因
- 為敏感端點設置額外權限控制
行為控制與答案格式
產品團隊可以批准助手允許輸出的回答格式,並控制其可訪問的端點。這樣能減少自由生成而偏離產品邏輯的風險。
- 規定可用回答、表格和圖表格式
- 限制端點、方法和參數範圍
- 為不同用戶或租戶應用不同權限
- 設定確認、拒絕和人工支援路徑
- 在Playground比較預期與實際行為
- 收集用戶對回答的正負反饋
- 透過測試和配置逐步擴大能力
Developer Dashboard
開發者控制台用於上傳API規範、設定動作、處理連線認證、使用測試工具,並查看使用狀況。它是讓託管方案能夠快速上線的主要入口。
- 上傳或手動輸入API端點
- 選擇助手可以調用的動作
- 配置身份驗證與多租戶參數
- 在Playground發送測試問題
- 使用Mock回應驗證未接通的端點
- 透過開發者模式檢查計劃過程
- 查看查詢量與用戶反饋
React聊天組件
官方chat-ui倉庫提供預製的React組件,可用於按鈕、聊天窗口、模態框或側欄等情境中的整合。這些組件適合快速嵌入,同時也讓產品團隊能夠自訂互動方式。
- 使用SuperflowsButton快速接入
- 使用SuperflowsChat獲得更高定制能力
- 以Modal或Sidebar控制觸發入口
- 匹配產品顏色、佈局和品牌樣式
- 傳遞當前用戶與租戶上下文
- 處理流式回答、確認和反饋互動
多租戶SaaS支援
Scale方案公開包含多租戶API和無限席位。實施時必須保證每次呼叫都帶有正確的租戶身份,避免跨客戶數據洩露。
- 把登入用戶映射到正確租戶
- 由後端簽發短期訪問憑證
- 在每個端點執行伺服器權限檢查
- 禁止依賴模型自行判斷數據權限
- 記錄租戶、使用者、端點及操作結果
- 使用自動化測試覆蓋越權嘗試
模型支援
開源倉庫說明:該專案曾支援GPT系列、Mixtral、Llama等多種模型,亦可在自托管方案中使用開放模型。具體的相容版本需透過程式碼及部署測試來確認。
- 根據規劃、分析與成本選擇不同模型
- 在託管與開放模型之間比較品質
- 控制上下文、輸出長度和呼叫費用
- 為模型不可用設計回退策略
- 用真實API任務建立評估集
- 避免把舊README的型號視為持續支持承諾
典型使用場景
- CRM用戶查詢交易並創建跟進任務
- 分析產品用戶透過對話生成臨時圖表
- 財務軟體用戶查詢收入、成本和異常
- 運營平台用戶批量更新工作流狀態
- 複雜B2B軟體提供內嵌產品使用指導
- 數據產品讓非技術用戶透過自然語言分析
- 垂直SaaS把常用API操作變成對話入口
CRM Copilot範例
官網使用CRM Copilot說明產品價值:用戶可詢問應優先推進哪些交易、比較獲客策略,並讓助手創建提醒任務。
- 按交易金額和成交概率排序機會
- 分析歷史聯繫和下一步建議
- 創建跟進電話或任務
- 比較不同外聯策略的線索貢獻
- 用確認步驟防止錯誤批量修改
- 讓權限和審計沿用CRM後端規則
適合哪些團隊
- 擁有穩定產品API和OpenAPI規範的SaaS公司
- 希望快速驗證內嵌AI助手的產品團隊
- 需要同時回答文件與即時數據問題的應用
- 願意維護權限、評估和安全控制的工程團隊
- 需要開源代碼或自託管選擇的企業
- 不希望從零開發規劃、聊天和反饋基礎設施的團隊
Superflows價格
官網目前公開了Testing、Scale和Enterprise三種方案。Scale的價格為每月999美元,而Enterprise則需要聯絡銷售人員;官網上關於企業版功能的說明寫著“All Growth features”,此名稱與現行的Scale版本不一致,採購時應以書面方式確認。
| 套餐 | 價格 | Chat-to-API | Chat-to-Docs | 主要權益 |
|---|---|---|---|---|
| Testing | 免費 | 測試環境50次查詢 | 未單獨標明 | 單席位、社區支持、Playground |
| Scale | 999美元/月 | 10,000次 | 200,000次 | 多租戶、無限席位、自訂設定、優先郵件支援 |
| Enterprise | 訂製詢價 | 10,000次以上 | 200,000次以上 | 審計日誌、自訂設定、優先功能請求 |
查詢計量方式
官網將Chat-to-API Query定義為使用者傳送到聊天介面,並觸發產品API查詢的一則訊息。至於連續追問、多個端點、失敗後的重試,以及無法觸發API的訊息,應如何在合約中加以規定。
- 區分API查詢與文件查詢額度
- 確認一次消息呼叫多個端點是否只計一次
- 核對失敗、重試和測試流量的計算方式
- 確認超量價格、限速和停用策略
- 按租戶和用戶監控消耗
- 估算高峰期併發和模型費用是否包含
概念驗證服務
官網提供工作坊及兩週的PoC流程:團隊先評估需求、建立針對客戶場景的原型,再由客戶進行測試與調整,之後決定是否上線。實際週期則取決於API的品質、認證流程以及需求範圍。
- 與Superflows團隊完成需求工作坊。
- 選擇少量高價值查詢和操作。
- 提供OpenAPI規範、測試帳戶和文件。
- 由團隊在約兩週內構建PoC。
- 用代表性使用者任務進行評估。
- 調整格式、端點和確認規則。
- 通過安全與產品驗收後再上線。
託管版快速接入教學
- 清理並上傳最新OpenAPI規範。
- 只啟用試點所需的只讀端點。
- 在Playground用Mock回應驗證規劃。
- 連接測試API和短期認證憑證。
- 上傳經過審核的產品文件。
- 安裝React聊天組件並傳遞使用者上下文。
- 配置確認、反饋和錯誤回退。
- 小流量上線並監控查詢與業務結果。
自託管教學
- 審查Apache-2.0代碼、依賴項目及目前的提交狀態。
- 準備Docker、Node環境和本地Supabase。
- 從範例檔案建立獨立環境變數設定。
- 配置資料庫、身分、郵件和模型金鑰。
- 在隔離網絡中啟動後端與相關服務。
- 導入API規範並運行安全測試。
- 建立日誌、備份、升級和漏洞修復流程。
- 生產前完成許可、性能和災難恢復驗收。
API安全教學
- 將讀取和寫入端點按風險分級。
- 預設只開放最低限度的唯讀操作。
- 由產品後端驗證用戶和租戶權限。
- 為寫入動作要求明確確認。
- 加入幀等鍵、參數校驗和速率限制。
- 記錄每次計劃、調用和最終結果。
- 覆蓋越權、提示注入和惡意參數測試。
- 定期覆核端點與OpenAPI規範變化。
測試與評估
產品團隊應針對文件問答、數據分析及寫入動作分別建立測試集。僅在演示中成功並不足以證明其在生產環境中的可靠性。
- 驗證端點選擇和參數完整性
- 檢查數值計算、時區及指標口徑
- 比較圖表與原始數據一致性
- 測試無數據、超時和權限拒絕
- 確認危險動作總是要求批准
- 模擬提示注入和跨租戶訪問
- 記錄用戶反饋和人工修正
- 在模型、API或文件更新後回歸
安全與隱私
Superflows會處理產品API規範、使用者問題、業務回應以及認證相關的內容,屬於高敏感度的整合服務。目前官方文件網站無法使用,企業應直接取得最新的安全、隱私及資料處理相關資料。
- 不要把長期秘密直接放入瀏覽器組件
- 使用短期、最小權限的伺服器令牌
- 在業務API再次驗證所有權限
- 限制模型可見的個人和商業敏感數據
- 對日誌和反饋設定保留與遮擋規則
- 確認模型供應商和數據儲存地區
- 為刪除、導出和安全事件建立流程
- 自託管客戶自行承擔補丁和基礎設施安全
效果評估
| 指標 | 衡量內容 | 建議 |
|---|---|---|
| 任務完成率 | 用戶目標是否正確完成 | 對照業務系統結果 |
| 端點選擇準確率 | 是否調用正確API | 按任務類別分層 |
| 參數錯誤率 | 缺失或錯誤參數比例 | 分析失敗日誌 |
| 分析正確率 | 計算與圖表是否準確 | 與標準腳本對照 |
| 確認合規率 | 高風險動作是否先確認 | 設為強制門檻 |
| 響應時間 | 從問題到可用答案 | 同時觀察多端點任務 |
| 用戶採用率 | 活躍、重複使用和回饋 | 結合留存與支持量 |
| 單位任務成本 | 平台、模型和基礎設施成本 | 按有效完成計算 |
產品優勢
- 專門面向SaaS產品內嵌AI助手
- 可從OpenAPI規範快速導入產品動作
- 同時支援API調用、文件問答和數據分析
- 能編寫代碼計算並生成圖表
- 對潛在破壞性操作設置用戶確認
- 開發者控制台支援Mock和調試
- 提供可訂製的開源React聊天組件
- 核心後端採用Apache-2.0許可證
- 託管和自託管路徑都可選擇
使用限制與注意事項
- Scale價格為999美元/月,小團隊成本較高
- 免費檔只有測試環境和50次查詢
- 官網套餐文案存在Growth與Scale名稱不一致
- 官方文件站目前不可用且證書已失效
- 主要開源倉庫最後更新集中在2024年
- 網站頁腳註明公司曾發生業務轉向
- 自託管指南仍不完整,需要較強工程能力
- AI生成代碼和分析可能出現計算錯誤
- API寫入與多租戶隔離必須由後端嚴格控制
- 購買前應核驗支援、路線圖和當前客戶服務能力
GitHub與開源情況
Superflows擁有官方的GitHub組織。其核心的superflows倉庫以及chat-ui倉庫都採用Apache-2.0許可證,因此可以依照該許可證的規定來使用、修改及散布這些軟體。
公開組織還包含文件、模型代理、瀏覽器擴充等功能庫。雖然核心庫是開源的,但近期提交的更新較少,因此在部署之前應先檢查其依賴項目、安全漏洞,以及與現有模型介面的相容性。
| 倉庫 | 許可證 | 主要用途 |
|---|---|---|
| superflows | Apache-2.0 | AI助手後端、控制台和API能力 |
| chat-ui | Apache-2.0 | React聊天界面組件 |
| rollup-plugin-tailwindcss | MIT | 前端構建插件 |
| openapi-llm | MIT | 從應用生成和增強API規範 |
| docs | 未聲明 | 歷史產品文件源碼 |
基本資訊
| 字段 | 內容 |
|---|---|
| 工具名稱 | Superflows |
| 開發公司 | Learney AI Ltd. |
| 產品類型 | SaaS產品內嵌AI助手與開源Copilot框架 |
| 主要能力 | API調用、RAG、代碼分析、圖表與動作 |
| 主要用戶 | SaaS產品、工程和數據團隊 |
| 價格模式 | 免費測試、999美元/月與企業詢價 |
| 接入方式 | Cloud API、OpenAPI和React組件 |
| 是否開源 | 是;核心與聊天組件採用Apache-2.0 |
| 維護提示 | 文件站不可用,倉庫更新較早,需採購前核驗 |
推薦指數
3.9 / 5。Superflows的OpenAPI驅動助手、數據分析、確認機制以及Apache-2.0代碼,對SaaS團隊而言仍具有參考與自托管價值;但文檔網站無法使用、倉庫更新停滯,且套餐說明不一致,這些問題都使得在實際採用時需要進行額外的調查。
常見問題
Superflows主要做什麼?
它幫助SaaS產品嵌入可調用的業務API、回答文件相關問題以及分析數據的AI助手。
Superflows可以執行操作嗎?
可以,它能調用寫入端點,並在潛在破壞性操作前請求使用者確認。
Superflows支援OpenAPI嗎?
支援,可上傳OpenAPI規範以快速配置助手可用的端點。
Superflows多少錢?
Testing免費,Scale為999美元/月,Enterprise需聯繫銷售獲取報價。
什麼是Chat-to-API Query?
它是一條由使用者傳送到聊天介面,並觸發產品API查詢的訊息。
Superflows可以自托管嗎?
可以,但官方自託管文件不完整,團隊需要自行配置Supabase、模型、郵件和運維。
Superflows現在還在維護嗎?
官網仍在上線,但文件站無法使用且主要倉庫的資料更新較早,建議在採購或部署前向官方確認。
Superflows是開源的嗎?
開源,核心後端和React聊天組件均採用Apache-2.0許可證。
桂公網安備45132202000164號