如何讓 AI 搜尋 Google Sheet 中的資料來回答客戶
本指南將引導你為 Google Sheet 建立一個唯讀 API,並將其作為自訂工具連接到 AI 業務員工。
Google Sheet Integration Tutorial
第 1 部分:架設一個唯讀的 Google Sheet API
1. 準備你的試算表
- 建立一個新的 Google Sheet,或開啟一個現有的
- 為你要使用的具體工作表分頁命名(例如 Products、Services、Inventory)
- 在第一列輸入你的欄位標題。請確保它們是唯一的,且不含空格或特殊字元:
- \id | name | price | description | stock_quantity | permalink\
- 從第 2 列開始向下填入你的資料
2. 編寫並部署 Apps Script 網頁應用程式
- 在你的 Google Sheet 中,前往 Extensions → Apps Script
- 將開啟一個新的指令碼編輯器。刪除所有範本程式碼
- 將以下程式碼貼到編輯器中:
3. 設定 API 密鑰
- 在 Apps Script 編輯器中,點擊 Project Settings(齒輪圖示)
- 向下捲動到 Script Properties,點擊 Add script property
- Property: API_SECRET
- Value: 輸入一個強隨機字串(請勿包含任何符號,僅限字母和數字)
- 儲存指令碼屬性
4. 部署網頁應用程式
- 點擊 Deploy → New deployment
- 選擇 Web app 作為類型
- 將 Execute as: 設定為 Me
- 將 Who has access: 設定為 Anyone
- 點擊 Deploy 並授權該應用程式
- 複製網頁應用程式的 URL——這就是你的 API 端點
第 2 部分:在 ABC Sales AI 中設定自訂工具
- 在你的 ABC Sales AI 控制台中,前往 AI Agents → AI Tools
- 點擊 Add Tool 並選擇 Custom Tool
- 設定工具:
- Tool Name: search_sheet
- Description: 搜尋產品/資料並回傳相符的結果
- Method: GET
- URL: 貼上你的 Apps Script URL,並附上 \?secret=YOUR_API_SECRET&search=\
- 新增參數:
- Name: search
- Type: String
- Location: Query
- Required: Yes
- 儲存工具並將其新增到你的 AI 業務員工
💡
專業提示: 在瀏覽器中造訪該 URL 並附上一個搜尋詞來測試你的 API。你應該會看到 JSON 結果。