Athena 工具¶
讓 Agent 對 AWS Athena 下查詢，把查到的資料用來回答。可透過 Connector（連結器）連到指定的 AWS 設定，不填則使用平台預設 AWS 設定。
開始前
Athena 可使用 AWS 類型的 Connector（連結器）提供連線設定；若不填，會使用平台預設的 AWS 設定。需要時請先建立 Connector，見 Connector 資源。
預設唯讀，保護資料
Athena 工具預設為「唯讀」，只允許查詢、不允許寫入。除非你清楚風險，建議保持開啟。
「描述」決定 Agent 會不會用對工具
Agent 是靠每個工具的「描述」（Description）判斷何時、該不該用它。描述寫得越清楚具體，Agent 越能在對的時機正確使用；寫得太籠統，可能該用時沒用、或用錯場合。建議寫明這份資料的內容與查詢時機。
欄位說明¶
對 AWS Athena 下查詢。
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱（Name） | 是 | （無） | 工具識別名稱，同一 Agent 內不可重複。 |
| 描述（Description） | 是 | （無） | 說明這份資料的內容與查詢時機。 |
| 連結器（Connector） | 否 | 平台預設 AWS 設定 | AWS 類型的 Connector；不填則使用平台預設 AWS 設定。 |
| 資料庫（Database） | 否 | （無） | 預設查詢的資料庫／schema；可在執行時覆寫。 |
| 執行與輸出設定（Workgroup / Output Location） | 是 | （無） | 畫面上是「二擇一」的介面：要嘛選一個 工作群組（Workgroup，沿用它預設的輸出位置），要嘛填一個 輸出位置（Output Location，s3://... 的 S3 路徑），兩者擇一即可。不確定該選哪個、值是什麼，請工程同事給你其中一個值照填。 |
| 目錄（Catalog） | 否 | （無） | Athena 資料目錄名稱。 |
| 唯讀（Read Only） | 否 | 開啟 | 開啟後只允許 SELECT / WITH / SHOW / DESCRIBE / EXPLAIN，並拒絕多語句查詢。 |
| 顯示名稱 / 標籤 | 否 | （無） | 顯示名稱與標籤，位於進階設定。 |
實際效果¶
設定好之後，當使用者問到 Athena 裡的資料，Agent 會自動把問題轉成查詢語句、透過 Connector 連到 Athena 執行，再用查回來的資料作答。對話會以可展開的卡片，依序顯示：
- 使用 …查詢相關資訊：Agent 送出的查詢語句（例如一段
SELECT）。 - 接收 …的查詢結果：Athena 回傳的資料列。
- 最後 Agent 根據查到的資料整理出回答。
執行效果截圖待補
本頁的實際執行截圖需要連到一個可運作的 Athena 才能擷取；目前文件環境尚無可連線的環境，待後端就緒後補上。設定完成後，你可在 Agent 的對話中以實際問題驗證效果。
下一步¶
- 還沒建連線 → Connector 資源
- 回到 工具總覽