Megosztás:

Rövid útmutató: A GitHub Copilot Agent mód használata

Az Ügynök mód lehetővé teszi, hogy a GitHub Copilot a Visual Studio Code MSSQL-bővítményében elérhető eszközöket használja. A bővítmény telepítésekor és aktív állapotában a Copilot felsorolhatja az SQL Server-kapcsolatokat, csatlakozhat egy kiszolgálóhoz és adatbázishoz, és lekérheti az adatbázis metaadatait.

Minden művelet ugyanazt a kapcsolati környezetet és hitelesítő adatokat használja, mint az MSSQL-bővítmény. Az ügynök mód nem vezet be további hitelesítést vagy engedélymódosításokat.

Tip

Ügynök mód használatakor nem kell kifejezetten hivatkoznia az MSSQL-bővítményre (@mssql). Ha a bővítmény aktív, az eszközei automatikusan elérhetők. További információ: Ügynök mód eszközei.

Az Ügynök mód eszközök kiválasztásával és végrehajtásával kapcsolatos részletekért tekintse meg a Visual Studio Code ügynök módra vonatkozó dokumentációját.

Mi az ügynök mód?

Az Ügynök mód lehetővé teszi, hogy a GitHub Copilot SQL-hez kapcsolódó műveleteket hajt végre az MSSQL-bővítmény használatával, és a végrehajtás előtt felhasználói megerősítésre van szükség.

Ezeket a műveleteket csevegési változók, például #mssql_connect, használatával hívhatja meg, vagy természetes nyelvi kérések kiadásával, például:

Connect to my Library database using my LocalDev profile

Képernyőkép a GitHub Copilot Agent módú csevegőfelületéről.

MSSQL-ügynök mód eszközreferenciája

Ez a szakasz részletesen ismerteti a GitHub Copilot Agent módban elérhető SQL-specifikus eszközöket. Az MSSQL-bővítmény hozzájárul ezekhez az eszközökhöz, így a GitHub Copilot csevegőváltozókon vagy természetes nyelvi kéréseken keresztül hajthat végre műveleteket. Minden eszközhöz felhasználói megerősítés szükséges a végrehajtás előtt.

Képernyőkép az MSSQL-bővítmény által a Copilot Agent módban létrehozott SQL-specifikus eszközök listájáról.

Tip

Csevegőváltozókat is használhat, például #mssql_connect közvetlenül meghívhatja ezeket az eszközöket, vagy természetes nyelven írhat utasításokat, például:

Connect to my development database

A GitHub Copilot automatikusan kezeli az eszközök kiválasztását.

Kapcsolatkezelés

Eszköz neve Description
connect Egy adatbázishoz egy mentett kapcsolatprofil vagy egy megadott kiszolgáló és adatbázis használatával csatlakozik.
disconnect Véget vet az aktuális aktív kapcsolati munkamenetnek.
change_database Egy meglévő kapcsolati munkamenet adatbázisának módosítása.
get_connection_details Lekéri egy adott MSSQL-kapcsolat kapcsolati adatait.
list_servers Felsorolja a környezetében mentett SQL Server-kapcsolatprofilokat.
list_databases Egy csatlakoztatott MSSQL-kiszolgáló összes elérhető adatbázisának listája.

Examples

Használja az alábbi kifejezéseket a GitHub Copilot használatához.

- Connect to my LocalDev environment
- Disconnect from my current database
- List my available connection profiles
- List all databases in the localhost server
- Set the active connection to localhost
- Set AdventureWorks as the active database
- Get the connection string for AdventureWorks on localhost

Képernyőkép a GitHub Copilot-csevegésben egy adatbázishoz való csatlakozáshoz használt ügynökeszközről.

A kapcsolatlogika működése

A GitHub Copilot Agent Mód támogatja az SQL-adatbázishoz való rugalmas kapcsolódást a mentett profilok hivatkozásával, vagy egy kiszolgáló és egy adatbázis közvetlen megadásával. Így működik a kapcsolatlogika.

Mentett profilhoz való csatlakozáskor:

  1. A csatlakozáshoz hivatkoznia kell egy mentett kapcsolatprofil nevére.
  2. A GitHub Copilot az mssql_list_servers eszközzel ellenőrzi, hogy létezik-e a profil.
  3. Az mssql_connect eszköz ezután a mentett profileId és annak paramétereit használja a kapcsolat létrehozásához.

Amikor kiszolgáló és adatbázis megadásával csatlakozik:

  • Ha egy mentett profil megegyezik a megadott kiszolgálóval és adatbázissal:

    1. A GitHub Copilot a találat megkeresésére használja mssql_list_servers .
    2. Ezután a mssql_connect hívása a teljes profilt használva történik.

  • Ha egy mentett profil csak a kiszolgálónak felel meg:

    1. A GitHub Copilot megkeresi a megfelelő kiszolgálóprofilt.
    2. Úgy próbál csatlakozni, hogy a felhasználó által kért adatbázist behelyettesíti ebbe a profilba.
    3. Ha a kapcsolat meghiúsul, hibaüzenet jelenik meg.

  • Ha nincs a megadott kiszolgálónak megfelelő profil:

    • A GitHub Copilot hibát jelez.

Ezzel a rugalmas egyező rendszerrel a GitHub Copilot számos kapcsolati forgatókönyvet kezelhet. Minimálisra csökkenti a felhasználói munkát, miközben biztonságos, megerősíthető műveleteket biztosít.

Sémafeltárás

Eszköz neve Description
show_schema Megjeleníti a csatlakoztatott adatbázisséma magas szintű diagramját, beleértve a táblákat és a kapcsolatokat.
list_schemas Egy csatlakoztatott MSSQL-kiszolgáló adatbázisának összes sémáját felsorolja.
list_tables Egy csatlakoztatott MSSQL-kiszolgáló adatbázisának összes táblája.
list_views Egy csatlakoztatott MSSQL-kiszolgáló adatbázisának összes nézetét listázza.
list_functions Egy csatlakoztatott MSSQL-kiszolgáló adatbázisának összes függvényét felsorolja.

Examples

Használja az alábbi kifejezéseket a GitHub Copilot használatához.

- Show me the schema for this database
- Show me all tables in the current database
- List all views from this MSSQL database
- Give me a list of all the functions available in this schema
- What schemas are available in this database?

Képernyőkép az adatbázisséma-vizualizációs eszközről Copilot Agent módban.

Lekérdezés végrehajtása

Eszköz neve Description
run_query SQL-lekérdezést futtat a csatlakoztatott adatbázison.

Examples

Használja az alábbi kifejezéseket a GitHub Copilot használatához.

- Give me the top five posts published this week
- Execute the current file to find how many comments each post has
- Get all categories along with the number of posts in each

Képernyőkép egy ügynökeszközről az adatbázishoz való csatlakozáshoz és az adatok lekéréséhez.

Képernyőkép egy másik példáról, amely egy ügynökeszköz használatával csatlakozik egy adatbázishoz, és adatokat kér le.

Eszközök kezelése ügynök módban

A GitHub Copilot msSQL-specifikus eszközöket és más bővítményekkel kapcsolatos eszközöket használhat a kérés feldolgozása során. Ezeket az eszközöket az Eszközök menü Ügynök mód felületén tekintheti meg, ahol bizonyos eszközöket be- és kikapcsolhat is.

Amikor meghív egy eszközt, különösen ha az a géppel vagy az adatbázissal kommunikál, a GitHub Copilot megerősítést kér a biztonságos végrehajtás érdekében. Az eszközt csak az aktuális munkamenethez, a munkaterülethez vagy véglegesen engedélyezheti.

Az eszközök láthatóságával és jóváhagyásával kapcsolatos további információkért lásd: Eszközjóváhagyások kezelése.

Ügynök mód megerősítési munkafolyamata

Amikor a GitHub Copilot kiválaszt egy eszközt, egy megerősítést kérő párbeszédpanelt kap, amely a kért művelet részleteit jeleníti meg. A kérést explicit módon jóvá kell hagynia, mielőtt bármilyen, a géppel vagy adatbázissal kommunikáló parancsot végrehajthat:

  • Engedélyezés ebben a munkamenetben
  • Engedélyezés ezen a munkaterületen
  • Mindig engedélyezve

Ez a megerősítési lépés segít a fejlesztési környezettel való biztonságos és szándékos interakciók biztosításában.

Note

A megerősítés ügynök módban történő működésével kapcsolatos további információkért tekintse meg a Visual Studio Code eszközjóváhagyásokkal kapcsolatos dokumentációját.

Kapcsolódó tartalom

  • Last updated on