原書用 Figure 12-7 解釋本機 Python add-in 架構:Excel、xlwings、Python、OpenAI API 各自負責不同層次,形成資料與控制的循環。
當工作需要 internet、OpenAI API 或未預載 packages 時,原書從內嵌 Python 轉向 xlwings Standard + 本機 Python。
| 元件 | 角色 | 主要輸入/輸出 |
|---|---|---|
| Excel | Frontend | cell ranges、macro/formula triggers、results |
| xlwings | Mediator | 啟動 Python、轉換 cell ranges、回寫 output |
| Python | Processing | scripts、packages、OpenAI client、environment variables |
| OpenAI API | External AI | Python request → model response |
資料路徑:Excel → xlwings → Python → OpenAI over internet → Python → xlwings → Excel。OpenAI 只看到 Python program 的 request,不知道 Excel 是前端。
此案例沒有單一數值結果;正式結果是明確的責任分層與資料流。
分層架構讓問題更容易定位:worksheet input 錯屬 Excel 層;bridge/interpreter 設定錯屬 xlwings;package/script 錯屬 Python;authentication/model request 錯屬 API 層。
請根據錯誤訊息先判斷問題屬於 Excel、xlwings、Python 還是 API 層,再提出檢查步驟。不要一次更改四層設定;每次只驗證一層。
**問題:**如果 Excel 能讀資料、Python script 能啟動,但 API request authentication 失敗,優先檢查哪一層?