OpenSearch 工具¶
讓 Agent 對 OpenSearch 下查詢、搜尋索引與文件，把查到的資料用來回答。透過連結器連到實際的服務。
開始前
這個工具靠連結器才能連到服務——連結器就是「事先存好的連線設定（位址、帳密等）」。請先建立一個 OpenSearch 類型的連結器，見 連結器資源。
「描述」決定 Agent 會不會用對工具
Agent 是靠每個工具的「描述」（Description）判斷何時、該不該用它。描述寫得越清楚具體，Agent 越能在對的時機正確使用；寫得太籠統，可能該用時沒用、或用錯場合。建議寫明這個索引裝什麼資料、什麼問題該來這裡查。
操作步驟¶
- 進入要設定的 Agent，點「編輯」。
- 展開「自訂工具」區塊，點表格中央的「+」圖示鈕。
- 在工具清單中選擇「OpenSearch」。
- 填入「名稱」與「描述」。
- 選擇「連結器」（OpenSearch 類型，必填）。「連結器」的挑選對話框裡請點該列「名稱」以外的任一格（或列前面的選鈕）來選取，再按對話框右上角的「儲存」——點「名稱」會在新分頁開啟該資源的詳細頁，不會選取它（見資源挑選欄位）。
- 視需要調整「使用快取連線」與「逾時」。
- 點「儲存」，回到 Agent 設定後再按一次「儲存」才會生效。
欄位說明¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱（Name） | 是 | （無） | 工具識別名稱，同一 Agent 內不可重複。 |
| 描述（Description） | 是 | （無） | 說明這個索引裝什麼、何時該查。 |
| 連結器（Connector） | 是 | （無） | OpenSearch 類型的連結器，提供連線位址。 |
| 使用快取連線（Cache Connection） | 否 | 開啟 | 是否重複使用已建立的連線以加快查詢。 |
| 逾時（Timeout） | 否 | 30 | 單次查詢最長等待秒數，範圍 1–120 的整數。表單一打開就會帶入 30，不必自己填；查詢量大時再往上調。 |
| 顯示名稱 / 標籤 | 否 | （無） | 顯示名稱與標籤，位於進階設定。 |
這個工具沒有「唯讀」開關
同類的 MySQL、Athena、Redshift 工具都有一個「唯讀」開關，OpenSearch 工具沒有——表單上找不到它是正常的，不是漏設。這代表 Agent 除了查詢，原則上也能寫入或刪除索引裡的文件。
所以能不能動到資料，完全取決於你在連結器裡給的那組憑證有多大權限。若不希望 Agent 改到任何資料，請在建立連結器時使用只有讀取權限的帳號——這是這個工具唯一的防護點。
實際效果¶
設定好之後，當使用者問到索引裡的資料，Agent 會自動把問題轉成查詢、透過連結器連到 OpenSearch 執行，再用查回來的資料作答。對話會以可展開的卡片，依序顯示：
- 使用 …查詢相關資訊：Agent 送出的查詢。
- 接收 …的查詢結果：服務回傳的文件。
- 最後 Agent 根據查到的資料整理出回答。
本頁沒有執行畫面的截圖——請這樣自行判讀
這個工具要接上你自己的 OpenSearch 才會有結果，畫面內容完全取決於你的索引資料，所以本頁不放截圖。設定完成後，在 Agent 的對話中問一個相關問題，點開回覆上方的「顯示思考過程」（見與 Agent 對話），用下面三種情況對照，就能判斷是正常還是哪裡沒設好：
- 正常：時間軸會出現一張「使用 <你在「名稱」填的工具名稱>…」卡片，點開看得到 Agent 這次送出的查詢；緊接著一張「接收 …的查詢結果」卡片，裡面是查回來的文件。最後才是整理過的回答。
- 卡片出現了，但結果是空的或紅字錯誤：代表工具有被呼叫，問題在連線或查詢範圍（例如連結器的位址／憑證有誤、索引名稱不存在、查詢結果真的是零筆）。先到連結器資源確認這個連結器能連得上，再把錯誤訊息給負責該服務的同事看。
- 完全沒有工具卡片：Agent 根本沒想到要用它。這幾乎都是「描述」寫得不夠具體——回到工具設定，把「描述」改成明確寫出「這個索引裝什麼、什麼問題該來這裡查」，再重開一段新對話試一次。