摘要
本指南說明如何在 Astra 中設定「Google Sheets — 搜尋並尋找列」動作。此動作可讓您的代理程式讀取和擷取所選「Google Sheets 工作表（分頁）」中的列，並以結構化清單的形式傳回結果。
為確保動作正確運作，您的試算表必須在頂端包含「一個非空的標頭列」。這些標頭定義了 Astra 讀取資料的結構。
在設定動作之前，請確保您的 Google 帳戶已連線至 Astra。
指示
請依照下列步驟設定「Google Sheets — 搜尋並尋找列」動作：
步驟 1：開啟動作範本
登入您的 Astra 帳戶。
前往「動作庫」。
選擇「Google Sheets — 搜尋並尋找列」。
開啟「設定」頁面。
您將在此頁面設定數個區段。
步驟 2：設定動作意圖
在「動作意圖」區段中：
輸入「動作名稱」。
撰寫一個「意圖」，說明何時應該代理程式搜尋試算表中的列。
這很重要
意圖有助於代理程式了解「何時應該使用此動作」。
清晰的指示可以提高觸發動作的準確性。
例如，當使用者要求客戶詳細資訊或需要擷取已儲存的資訊時，代理程式可能會搜尋試算表。
步驟 3：選取 Google 帳戶
在「Google 帳戶」區段中：
選擇「已連線的 Google 帳戶」，該帳戶有權存取試算表。
運作方式
Astra 使用選定的帳戶透過安全的 OAuth 驗證存取 Google Sheets。
必須能夠從該帳戶存取試算表。
步驟 4：選取試算表和工作表
在「試算表和工作表」區段中：
選擇「雲端硬碟位置」。
選擇「試算表」。
選擇包含數據的「工作表（分頁）」。
重要提示：
只能使用位於「我的雲端硬碟」或「共用雲端硬碟」中的試算表。
Astra 只會讀取所選工作表中的數據。
步驟 5：設定列篩選
您可以使用「僅讀取相關列」切換按鈕來控制 Astra 如何讀取列。
選項 1：關閉切換（讀取整個工作表）
當切換按鈕為「關閉」時：
Astra 會讀取「整個工作表」。
所有列都會傳回給代理程式。
適用於：
包含「小型數據集」（約 1,000 列或以下）的工作表。
選項 2：開啟切換（僅讀取相關列）
當切換按鈕為「開啟」時：
Astra 會嘗試「篩選並傳回相關列」。
代理程式會搜尋數據，而不是讀取整個工作表。
關於比對的注意事項：
ASCII 文字的比對是「近似（模糊）」的。
搜尋通常是：
不區分大小寫
對空格或標點符號不敏感
對於「非拉丁文字」，比對會更嚴格，可能需要更精確的比對。
適用於：
包含「大型數據集」的工作表，若讀取整個工作表會效率低下。
動作執行時的情形
當動作觸發時：
Astra 會讀取所選的「Google Sheets 工作表」。
它會根據已設定的條件擷取列。
這些列會以「結構化的數據清單」傳回給代理程式。
這可讓您的工作流程動態擷取儲存在 Google Sheets 中的資訊，例如客戶記錄、產品數據或內部追蹤資訊。