API Claws icon

API Claws

API Claws 是 Buda 用於整合受管理雲端 AI Agent 的 REST API 層,支援硬體、應用程式、瀏覽器擴充功能與 SaaS,提供 Space 範圍工作階段、Drive 知識及選用的嵌入式聊天,無需自行維運 Agent 基礎架構。

API Claws

適用於連線產品的受管理 AI Agent

API Claws 是 Buda 面向開發者的 REST API 層,用於將受管理、雲端代管的 AI Agent 加入第三方硬體與軟體。適用產品包括智慧型手錶、耳機、IoT 裝置、聊天應用程式、瀏覽器擴充功能與 SaaS 工具,這些產品需要對話式 AI,卻不必在本機執行大型模型。

此整合結合了模型存取、受管理的 Agent 執行環境、以 Drive 為基礎的知識、工作階段管理、租戶隔離,以及喚醒/休眠協調。開發者可以使用 API 金鑰與 Space 範圍資源,將使用者或裝置群組連線至 Agent、維持隔離的對話,並選擇透過短期有效的嵌入 URL 提供聊天功能。使用量透過 Space 點數系統計費,而不是另外訂閱 API。

API Claw 功能

存取雲端代管的 Agent

外部硬體與軟體可透過 `/api/v1` 下的 REST 資源存取雲端代管的 Buda Agent,不必在裝置上執行模型。

以工作階段為基礎的對話

Chat Session API 提供每位使用者的對話內容、非同步 Agent 執行作業、狀態與訊息。每位終端使用者都可以取得具獨立隔離內容的工作階段。

以 Drive 為基礎的知識

Drive API 支援持久性檔案、手冊、政策、狀態及 Agent 知識庫的長期記憶。

Space 隔離

Space 資源提供租戶、客戶、團隊或裝置群組的邊界。API 要求會使用 API 金鑰進行驗證,並在存取 Agent 前解析至某個 Space。

隨需執行環境

Agent 在閒置時可以休眠,收到訊息時再喚醒,因此連線產品不必持續維持 Agent 基礎架構運作。

嵌入式聊天存取

後端可以為瀏覽器、行動應用程式、小程式或擴充功能建立短期有效的嵌入 URL。回傳的權杖會保留在 URL 雜湊中,並用於前端安全的 `/api/v1/embed/...` 呼叫。

實際使用案例

  • 為智慧硬體加入助理

    智慧型手錶、耳機、語音終端或連線 IoT 裝置可以將輸入傳送至雲端 Agent,同時由裝置處理自身的輸入與輸出。Agent 升級會在伺服器端進行,不需要裝置在本機執行大型模型。

  • 擴充聊天應用程式

    聊天應用程式可以將 Agent 附加至對話,並使用獨立的 Chat Sessions,讓每位使用者的內容彼此分開。

  • 提供私有 AI 支援空間

    客戶服務 SaaS 可以為每位客戶提供私有的 AI 支援空間,並以客戶專屬的指示或檔案為基礎,使用 Space 邊界與以 Drive 為基礎的知識。

  • 在用戶端介面中嵌入 AI 聊天

    瀏覽器擴充功能、行動應用程式、小程式或內部工具可以使用由後端建立的短期有效嵌入 URL,讓使用者聊天而不會在前端公開主要 API 金鑰。

  • 建立以知識為基礎的產品工作流程

    產品團隊可以將手冊、政策或其他持久性參考資料儲存在 Agent 的 Drive 中,讓 Agent 使用維護中的知識,而不必重複接收大型提示。

Pros and Cons

Pros

  • 提供受管理的 Agent 層,無需開發者分別維運模型基礎架構、執行環境協調、檢索與工作階段管理。
  • 透過 Chat Sessions 為終端使用者提供獨立內容,並透過 Spaces 提供租戶或裝置群組的邊界。
  • 允許在 Drive 中維護持久性的 Agent 知識,而不必在提示中反覆加入相同內容。
  • 同時支援後端控制的 API 存取,以及供前端用戶端使用的短期有效嵌入式聊天存取。
  • Agent 在閒置時休眠、收到訊息時喚醒,適合需要隨需雲端 AI 的產品。

Cons

  • 提供的文件未包含完整的端點結構描述、每項操作的驗證範例,或詳細的要求與回應行為。
  • API 活動取決於 Space 的可用點數餘額;相關點數池耗盡時,AI 功能會暫停。
  • 連線產品仍需圍繞 API 或嵌入介面,自行建構使用者體驗與後端工作流程。

FAQ

應用程式如何連線至 API Claws?

API Claws 讓第三方產品透過 `/api/v1` 下的 REST 呼叫,連線至雲端代管的 Buda Agent。文件所述的工作流程包括使用 API 金鑰進行驗證、解析 Space、存取 Agent 及其 Drive,以及在 Chat Sessions 中執行要求。頁面也記載了嵌入流程,後端可為瀏覽器或應用程式建立短期有效的 URL。

對話與使用者內容如何處理?

每位終端使用者都可以擁有具獨立隔離內容的 Chat Session。工作階段會與 Agent 建立關聯,並支援對話、非同步 Agent 執行作業、狀態與訊息。來源未提供每個端點的完整要求與回應結構。

API Claw 可以使用私有知識庫嗎?

API Claws 使用 Agent 的 Drive 作為持久性知識庫,用於儲存手冊、政策及其他長期資訊等檔案。如此可避免在每次要求中重複傳送相同的大型提示,而檔案擷取與知識庫處理則由 Buda 管理。

API Claw 的使用量如何計費?

API Claw 的使用量透過 Space 點數系統計費,而不是另外訂閱 API。Space 點數由該 Space 中的所有 Agent 共用,並依模型使用量與工作複雜度消耗;可用點數池耗盡後,AI 功能會暫停,直到點數重設或為 Space 重新儲值。

Quick Facts

類別
開發者工具;AI 聊天
API 基底
`/api/v1` 下的 REST 資源
主要使用者
硬體製造商、軟體開發者與 SaaS 提供者
核心工作流程
API 金鑰 → Space → Agent 與 Drive → Chat Session
知識層
Agent Drive,用於檔案、手冊、政策、狀態及長期記憶
計費模式
Space 點數;未說明另行訂閱 API Claw
API Claws - AI Tool, Features, Use Cases & Alternatives | UStack