zero-finance

AI 電子郵件管線是為 0 Finance 設計的自動化系統，用於直接透過 AI 管理內送與外寄通訊。此技能不依賴僵化的狀態機或基於 Regex 的意圖偵測，而是利用大型語言模型 (LLM) 來解讀財務對話的細微差別。系統將每封電子郵件視為對話的一部分，使 AI 能夠動態處理修正、澄清及複雜的用戶請求。該系統專為需要 CLI 優先銀行功能的代理而建構，將自動化財務任務與自然語言互動緊密結合。

• 完整的對話歷史管理：維護會話上下文，使 AI 能夠「記住」之前的互動、文件及待辦事項。

• 原生附件處理：支援直接讀取 PDF 與圖片（發票、收據），無需預先提取，讓 AI 能原生閱讀並解釋文件。

• 整合金融工具集：提供提取發票詳情、建立及更新發票、提議 ACH/IBAN 銀行轉帳以及查詢餘額的原子化工具。

• 安全憑證管理：支援 Resend 與 Amazon SES 等電子郵件供應商，並具備處理缺失憑證與無效 Webhook 的穩健邏輯。

• 架構模式：採用嚴格的對話模型，AI 根據完整電子郵件上下文決定何時呼叫 createInvoice、updateInvoice 或 sendReplyToUser 等工具。

• 輸入：需要內送 Webhook 負載（Resend/SES）、會話狀態、目前附件及工作區映射配置。

• 輸出：產生更新後的會話狀態、建立或修改發票與轉帳提議，並產生外寄電子郵件回覆。

• 運作要求：技能遵循「電子郵件到達 -> 解析附件 -> 建立歷史 -> 發送至 LLM -> 執行工具」的架構。避免使用硬編碼捷徑或基於 Regex 的解析，確保 AI 始終是意圖偵測的主要引擎。

• 限制：確保所有附件在對話過程中持續存在，方法是在每個訊息處理步驟中從 Vercel Blob 儲存體載入。系統旨在針對轉帳與發票最終確認等關鍵操作請求用戶確認，而非盲目自動化這些步驟。