MySQL 工具¶
讓 Agent 對 MySQL 資料庫下查詢，把查到的資料用來回答。透過 Connector（連結器）連到實際的資料來源。
開始前
這個工具靠 Connector（連結器）才能連到資料庫——連結器就是「事先存好的連線設定（位址、帳密等）」。請先建立一個 MySQL 類型的連結器，見 Connector 資源。
預設唯讀，保護資料
MySQL 工具預設為「唯讀」，只允許查詢、不允許寫入。除非你清楚風險，建議保持開啟。
「描述」決定 Agent 會不會用對工具
Agent 是靠每個工具的「描述」（Description）判斷何時、該不該用它。描述寫得越清楚具體，Agent 越能在對的時機正確使用；寫得太籠統，可能該用時沒用、或用錯場合。建議寫明這個資料庫裝什麼資料、什麼問題該來這裡查。
操作步驟¶
- 進入要設定的 Agent，點「編輯」。
- 展開「自訂工具」區塊，點表格中央的「+」圖示鈕。
- 在工具清單中選擇「MySQL」。
- 填入「名稱」與「描述」。
- 選擇「連結器」（MySQL 類型，必填），並視需要填預設「資料庫」。「連結器」的挑選對話框裡請點該列「名稱」以外的任一格（或列前面的選鈕）來選取，再按對話框右上角的「儲存」——點「名稱」會在新分頁開啟該資源的詳細頁，不會選取它（見資源挑選欄位）。
- 確認「唯讀」保持開啟。
- 點「儲存」，回到 Agent 設定後再按一次「儲存」才會生效。
欄位說明¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱（Name） | 是 | （無） | 工具識別名稱，同一 Agent 內不可重複。 |
| 描述（Description） | 是 | （無） | 說明這個資料庫裝什麼、何時該查。 |
| 連結器（Connector） | 是 | （無） | MySQL 類型的連結器。 |
| 資料庫（Database） | 否 | （無） | 預設連線的資料庫名稱；可在執行時改用其他資料庫。 |
| 唯讀（Read Only） | 否 | 開啟 | 開啟後每次查詢前會設定唯讀交易，防止任何寫入。 |
| 顯示名稱 / 標籤 | 否 | （無） | 顯示名稱與標籤，位於進階設定。 |
實際效果¶
設定好之後，當使用者問到資料庫裡的資料，Agent 會自動把問題轉成查詢語句、透過連結器連到資料庫執行，再用查回來的資料作答。對話會以可展開的卡片，依序顯示：
- 使用 …查詢相關資訊：Agent 送出的查詢語句（例如一段
SELECT）。 - 接收 …的查詢結果：資料庫回傳的資料列。
- 最後 Agent 根據查到的資料整理出回答。
本頁沒有執行畫面的截圖——請這樣自行判讀
這個工具要接上你自己的 MySQL 資料庫才會有結果，畫面內容完全取決於你的資料表，所以本頁不放截圖。設定完成後，在 Agent 的對話中問一個相關問題，點開回覆上方的「顯示思考過程」（見與 Agent 對話），用下面三種情況對照，就能判斷是正常還是哪裡沒設好：
- 正常：時間軸會出現一張「使用 <你在「名稱」填的工具名稱>…」卡片，點開看得到 Agent 這次送出的查詢語句；緊接著一張「接收 …的查詢結果」卡片，裡面是查回來的資料列。最後才是整理過的回答。
- 卡片出現了，但結果是空的或紅字錯誤：代表工具有被呼叫，問題在連線或查詢範圍（例如連結器的位址／帳密有誤、資料庫或資料表名稱不存在、查詢結果真的是零筆）。先到 Connector 資源確認這個連結器能連得上，再把錯誤訊息給負責這個資料庫的同事看。
- 完全沒有工具卡片：Agent 根本沒想到要用它。這幾乎都是「描述」寫得不夠具體——回到工具設定，把「描述」改成明確寫出「這個資料庫裝什麼、什麼問題該來這裡查」，再重開一段新對話試一次。
下一步¶
- 還沒建連線 → Connector 資源
- 回到 工具總覽