Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Met de agentmodus kan de AI-assistent in uw editor PostgreSQL-hulpprogramma's uit de extensie gebruiken als onderdeel van één gesprek met meerdere stappen. In plaats van alleen een vraag te beantwoorden, kan de assistent verbinding maken met een database, een schema inspecteren, query's uitvoeren, scripts openen en u helpen een workflow van begin tot eind te doorlopen.
De agentmodus wordt uitgevoerd in zowel Visual Studio Code (met GitHub Copilot) als Cursor (met de ingebouwde AI). De extensie toont hetzelfde PostgreSQL-hulpprogrammaoppervlak in beide editors; alleen het chatvenster dat wordt geopend, verschilt.
Gebruik de Agentmodus wanneer u wilt dat de AI gestructureerde acties uitvoert, en niet alleen uitleg geeft of SQL opstelt.
Prerequisites
Voordat u begint, moet u ervoor zorgen dat u het volgende hebt:
- De PostgreSQL-extensie is geïnstalleerd.
- Copilot/AI-functies ingeschakeld in de extensie (
pgsql.copilot.enableistrue). - Ten minste één databaseverbinding die is geconfigureerd in de extensie.
- Een AI-assistent die beschikbaar is in uw editor:
- Visual Studio Code: GitHub Copilot of GitHub Copilot Chat geïnstalleerd en actief.
- Cursor: geen extra installatie; de ingebouwde AI wordt automatisch gebruikt.
Agentmodus starten
- Maak verbinding met de doelserver of -database in de PostgreSQL-extensie.
- Klik in de structuur Verbindingen met de rechtermuisknop op de database die u wilt gebruiken.
- Selecteer Verbinding maken met AI.
- Zet het gesprek voort in het chatvenster dat wordt geopend voor de werkstroom die u wilt voltooien.
- In Visual Studio Code is dit het deelvenster GitHub Copilot Chat in de agentmodus.
- In Cursor is dit het systeemeigen AI-deelvenster van Cursor; de extensie biedt een korte MCP-georiënteerde preambule, zodat de assistent weet wat de beschikbare PostgreSQL-hulpprogramma's zijn.
Nadat de sessie is gestart, kan de AI PostgreSQL-hulpprogramma's achter de schermen combineren terwijl deze via uw aanvraag werkt.
De juiste toegangsmodus kiezen
De instelling pgsql.copilot.accessMode bepaalt hoeveel databasetoegang de Agent-modus krijgt. De instellings-id behoudt het pgsql.copilot.* voorvoegsel voor compatibiliteit. Het zichtbare label is Copilot toegangsmodus in Visual Studio Code en AI-toegangsmodus in Cursor.
| Mode | Wat de AI kan doen | Aanbevolen gebruik |
|---|---|---|
ro |
Alleen-leesbewerkingen zoals SELECT, SHOW, EXPLAIN, schema-inspectie en analyse |
Productiesystemen of gedeelde omgevingen waar u onderzoek wilt uitvoeren zonder wijzigingen |
rw |
Leesbewerkingen plus instructies voor het wijzigen van gegevens en DDL, met expliciete bevestiging vóór uitvoering | Lokale ontwikkeling, wegwerp sandboxes en gecontroleerde testomgevingen |
Caution
Gebruik ro de modus voor productiedatabases, tenzij u opzettelijk schema- of gegevenswijzigingen beschikbaar wilt maken via de agentmodus.
Maak kennis met de toolfamilies
De agentmodus kan meerdere hulpprogrammafamilies gebruiken, afhankelijk van de werkstroom.
| Toolfamilie | Wat het doet | Wanneer u deze gebruikt |
|---|---|---|
| Verbindingshulpprogramma's | Lijstprofielen, verbinding maken, verbinding verbreken, databases weergeven | Context starten of schakelen |
| Hulpprogramma's voor schemacontext | Objectdefinities ophalen of schema visualiseren | Tabellen, weergaven, functies, indexen en relaties begrijpen |
| Querytools | Leesquery’s uitvoeren, queryplannen inspecteren, scripts openen | Gegevens onderzoeken, ideeën valideren of gegenereerde SQL beoordelen |
| Wijzigingshulpmiddelen | DDL of DML uitvoeren met bevestiging | Gecontroleerde schema- of gegevenswijzigingen toepassen in rw de modus |
| Hulpprogramma's voor gegevensimport | CSV-bestanden beschrijven en bulksgewijs laden | CSV-importwerkstromen plannen en uitvoeren |
Tip
In Cursor worden dezelfde hulpprogramma's ook weergegeven via de MCP-serverregistratie. De ingebouwde chat van Cursor kan die rechtstreeks aanroepen zonder gebruik te maken van het toegangspunt Connect AI. Zie MCP-server voor meer informatie.
Agentmodus gebruiken voor algemene werkstromen
In de volgende voorbeelden ziet u hoe u de agentmodus gebruikt voor taken die variëren van het verkennen van een nieuwe database tot het verfijnen van query's.
Een onbekende database verkennen
Vraag de AI om verbinding te maken met de database, sleutelobjecten weer te geven en de schemagebieden samen te vatten die belangrijk zijn voor uw taak.
Example:
Maak verbinding met mijn ontwikkelingsdatabase, vermeld de tabellen in het openbare schema en vertel me welke eruitzien met betrekking tot klanten en orders.
Queryprestaties onderzoeken
Vraag de AI om schemacontext te combineren met queryuitvoering of inspectie van plannen.
Example:
Maak verbinding met de stagingdatabase, voer deze query uit in alleen-lezenmodus en leg uit welk deel van het uitvoeringsplan de kosten veroorzaakt.
Gegevens laden of hervormen
Gebruik de agentmodus wanneer de werkstroom scripts of CSV-bewerkingen bevat.
Example:
Bekijk dit CSV-bestand, vertel me welk schema het inhoudt en bereid een veilig importplan voor de
sales.recordstabel voor.
Van concept naar handmatige beoordeling gaan
Wanneer u een controlepunt voor menselijke controle wilt voordat u deze uitvoert, vraagt u de AI om de gegenereerde SQL te openen in de query-editor in plaats van deze onmiddellijk uit te voeren.
Weten wanneer de agentmodus moet worden gebruikt in plaats van @pgsql
Gebruik @pgsql chatdeelnemer wanneer u een schemabewust antwoord of een queryconcept wilt. De @pgsql deelnemer is alleen beschikbaar in Visual Studio Code.
Gebruik de agentmodus (beschikbaar in zowel Visual Studio Code als Cursor) wanneer u de AI wilt gebruiken:
- verbinding maken met de juiste database voor u,
- meerdere hulpprogramma's in één gesprek koppelen,
- resultaten controleren vóór de volgende stap, of
- bereid een script of beheerde wijzigingswerkstroom voor.
Note
In cursor is de agentmodus het primaire pad omdat de @pgsql chatdeelnemer daar niet beschikbaar is. Hetzelfde gereedschapoppervlak is ook bereikbaar via de systeemeigen chatfunctie van Cursor via de MCP-server.
Problemen met agentmodus oplossen
Als de agentmodus niet werkt zoals verwacht, controleert u eerst de toegangsmodus en beschikbaarheid van hulpprogramma's.
De AI kan de database niet wijzigen
Controleer pgsql.copilot.accessMode en bevestig dat de actieve verbinding niet wordt omgezet naar ro.
Het hulpprogramma dat u verwacht, is niet beschikbaar
Zorg ervoor dat Copilot integratie is ingeschakeld en dat u bent gestart vanuit een database met een geldige PostgreSQL-verbindingscontext.
Een verbindingsaanvraag mislukt
Controleer of het verbindingsprofiel nog bestaat, dat de referenties beschikbaar zijn en dat de extensie verbinding kan maken met dezelfde database buiten de agentmodus.
Ik wil een eenvoudigere chat-first-werkstroom
Gebruik in Visual Studio Code@pgsql chatdeelnemer wanneer u uitleg, het opstellen van query's of schemavragen wilt zonder automatisering op basis van hulpprogramma's. Stel in Cursor dezelfde soorten vragen vanuit de systeemeigen chat. De MCP-hulpprogramma's van de extensie zijn nog steeds vindbaar, maar de chat voelt natuurlijker en meer gespreksmatig aan zonder een expliciete optie voor de Agent-modus.