PostgreSQL 擴充功能透過三個介面整合 AI 助理：@pgsql聊天參與者（僅限Visual Studio Code）、代理模式工具，以及 PostgreSQL 工具的 MCP 伺服器提供者。 本頁協助你選擇合適的入口點，並了解適用於這三個階段的共用配置。
該擴充套件可在 Visual Studio Code（搭配 GitHub Copilot）和 Cursor（內建 AI）中運行。 大多數功能在兩個編輯器中運作方式相同;本文中提及少數編輯者特定的行為。
先決條件
在使用任何 AI 輔助功能之前，請確保符合以下要求：
- PostgreSQL 擴充功能已安裝，且至少設定了一個資料庫連線。
- 你的編輯器中有一個 AI 助理：
- Visual Studio Code：安裝 GitHub Copilot 或 GitHub Copilot Chat，並以有效訂閱登入。
- 游標：無額外安裝;內建的 AI 會自動運作。
Note
Copilot 功能預設已啟用（pgsql.copilot.enable是 true）。 當你將此設定為 false時，@pgsql聊天參與者（僅限Visual Studio Code）、AI 查詢動作編輯器子選單、代理模式工具以及 MCP 伺服器提供者都會被隱藏。
Tip
AI 協助在你已經有活躍資料庫連線時效果最佳。 如果你還沒連結過，先從 連結和身份開始。
選擇合適的入門方式
| 如果您想要... | 從這裡開始 | 可取得性 | 瞭解更多資訊 |
|---|---|---|---|
| 問一個關於資料庫結構的問題 | @pgsql 聊天參與者 | 僅限 Visual Studio Code | @pgsql聊天室參與者 |
| 在已將特定資料庫納入範圍的情況下啟動代理模式 | 從連線樹中的資料庫節點連接 AI | Visual Studio Code 與游標 | 代理模式 |
| 從編輯器中解釋、重寫或分析 SQL | 編輯器右鍵選單中的 AI 查詢動作子選單 | Visual Studio Code 與游標 | 編輯者操作 |
| 自動化多步驟資料庫任務 | 在資料庫節點上連接 AI以啟動代理程式模式 | Visual Studio Code 與游標 | 代理模式 |
| 將 PostgreSQL 工具公開給相容 MCP 的主機 | PostgreSQL 工具 MCP 伺服器提供者 | Visual Studio Code 與游標 | MCP 伺服器 |
使用 @pgsql 進行可感知結構描述的聊天
Note
@pgsql 聊天參與者僅在 Visual Studio Code 中註冊，並整合到 GitHub Copilot Chat。 在游標中，使用連接樹中的資料庫節點 Connect AI 啟動代理模式，並使用相同的結構上下文，或依賴游標原生聊天畫面中的 MCP 伺服器。
該擴充功能會在 GitHub Copilot Chat 註冊一個 @pgsql 聊天參與者（ID： vscode-postgresql.chat-agent），用於具備結構感知的對話。
@pgsql輸入後再輸入你的問題，參與者會利用你連接的資料庫中的即時架構上下文來回答。
若要啟動一個工具驅動的工作流程，且資料庫已在範圍內，請在 連接 樹中右鍵點擊資料庫節點，選擇 「Connect AI」。
如需終端使用者指南、提示詞範例及疑難排解，請前往 @pgsql chat participant。
使用編輯器動作以獲得查詢相關協助
當你在查詢編輯器中開啟 SQL 時，右鍵點擊即可找到 AI 查詢動作 子選單。 它包含以下動作：
| Action | Description |
|---|---|
| 解釋查詢 | 回傳一個簡單的說明，說明查詢的功能。 |
| 重寫查詢 | 建議查詢的替代版本，同時保留預期結果。 |
| 分析查詢效能 | 會對連接的資料庫執行 EXPLAIN ANALYZE ，然後將執行計畫送給 AI 進行分析。 |
你也可以從編輯器工具列選擇 「詢問 AI 關於此查詢 」，以開啟以當前編輯內容為基礎的聊天對話。
若要重設方案分析中已記住的查詢納入選擇，請從命令面板執行 清除 AI 分析的查詢納入偏好設定。
使用代理模式進行工具驅動的工作流程
代理模式讓 AI 助理能存取 PostgreSQL 工具，能在一次對話中連線、檢查結構、執行查詢、開啟腳本，並完成多步驟任務。 在 連接 樹中右鍵點擊資料庫節點，選擇 「Connect AI 」以啟動代理模式會話。
關於工具系列、範例工作流程及故障排除，請繼續使用 代理模式。
在支援的主機上使用 MCP 伺服器
該擴充套件註冊一個 PostgreSQL 工具 MCP 伺服器提供者 （ID： pgsql-tools-mcp-server-provider），透過模型上下文協定（Model Context Protocol）暴露相同的 PostgreSQL 工具表面。 相容 MCP 的主機可以在不使用內建聊天流程的情況下發現並調用這些工具。
如需瞭解支援的主機、自動註冊行為，以及透過 MCP 提供的工具系列，請參閱 MCP 伺服器。
設定存取模式
此 pgsql.copilot.accessMode 設定控制 AI 助理在代理模式與 MCP 工具間獲得多少資料庫存取。 預設為 讀寫 （rw）。
| 設定值 | UI 標籤 | AI 助理能做什麼 |
|---|---|---|
ro |
唯讀 | 唯讀操作：SELECT、SHOW、EXPLAIN、綱要檢查 |
rw |
讀寫 | 讀取操作加上資料修改語句與 DDL，並明確確認 |
逐連線覆寫
你也可以在個別連線上設定存取模式。 在連線對話框中，展開 Copilot 區段（游標中的 AI），並將 Copilot 存取模式（游標中的 AI 存取模式）設為以下之一：
| Option | 行為 |
|---|---|
| 使用全域設定 | 回退到全域 pgsql.copilot.accessMode 值（預設值） |
| 唯讀 | 無論全域設定為何，強制此連線只讀存取 |
| 讀寫 | 無論全域設定如何，都會強制此連線的讀寫存取權限 |
擴充功能會依照下列後備順序判定有效的存取模式：各連線的值 → 全域 pgsql.copilot.accessMode 設定 → 預設值（rw）。
注意事項
除非你有意讓 AI 助理可進行結構描述或資料變更，否則請對生產資料庫使用 唯讀。
進行其他設定
| 設定 | 它控制的是什麼 | 預設 |
|---|---|---|
pgsql.copilot.enable |
啟用或停用擴充功能中的所有 AI 整合功能 | true |
pgsql.copilot.accessMode |
全域 AI 存取模式（唯讀 或 讀寫） | rw |
pgsql.copilot.autoAttachQuery |
分析 AI 計畫時是否包含 SQL 查詢文字： 每次詢問、 永遠包含，或 永不包含 | ask |
pgsql.copilot.modelOptions |
為擴充套件的 AI 工作流程提供進階模型調校（最大標記、溫度、top_p） | - |
設定 ID 會在兩個編輯器中保留 pgsql.copilot.* 前綴，以確保向下相容，即使使用者可見的標籤寫著「AI」。
特定功能的 AI 整合
多項功能包含專屬的 AI 整合點：
| Feature | 人工智慧能力 |
|---|---|
| 查詢計畫視覺化工具 | 使用 Analyze with Copilot 分析執行計畫資料（或在游標中用 AI 分析） |
| 伺服器儀表板 | 從 詢問 Copilot 按鈕（游標中的 Ask AI）在查詢、等待、會話和指標圖表面板上開啟聊天會話 |
| 結構視覺化工具 | 從代理模式工作流程中視覺化結構關係 |