ai-integration

此技能為將 Anthropic 的 Claude API 整合至現代軟體應用程式提供了穩健的架構模式。它專為在 TypeScript 生態系統中構建 AI 功能的開發人員而設計，提供標準化的方法來處理請求生命週期管理、回應串流及複雜的函式呼叫。透過利用此技能，工程師可以快速構建對話介面、自動化內容生成引擎以及需要確定性結構化輸出的自適應工作流程。該模組透過提供 API 客戶端初始化、訊息處理以及整合 Zod schema 以確保從 AI 回應中解析出型別安全資料的清晰範例，來強調可維護性。

• 標準化的 Anthropic SDK 客戶端設定，包含環境變數配置以確保 API 存取安全性。

• 彈性的聊天完成模式，支援基本的請求-回應循環以及透過 ReadableStream 進行的高效伺服器端事件串流。

• 先進的結構化輸出生成，使用 Zod schema 進行驗證，非常適合生成符合 JSON 標準的網域物件，例如健身計畫或資料報告。

• 完整的工具呼叫 (Function Calling) 架構，允許 Claude 執行定義好的操作（如行事曆更新或強度調整），並具備清晰的輸入 schema 驗證。

• 預先定義的模型選擇策略，將任務需求（快速、平衡或強大）對應至特定的 Claude 模型版本（例如 Haiku 或 Sonnet）。

• 最佳實踐：務必包含系統提示詞 (System Prompt) 以定義 AI 的角色、操作限制及預期的輸出格式，以減少幻覺產生。

• 實用建議：使用工具呼叫時，為屬性和需求提供詳細的 schema 說明，以確保模型能可靠地預測正確的參數值。

• 限制：確保 ANTHROPIC_API_KEY 環境變數已正確注入執行環境，以避免客戶端初始化錯誤。

• 用途：適用於需要高保真互動的應用，例如 AI 教練、個人助理或自動化文件處理管線。

• 資料完整性：務必將產生方法的輸出包裝在 schema 驗證邏輯中，以處理模型可能偏離嚴格 JSON 格式的情況。