Compartir a través de

Inicio rápido: Uso del modo agente de Copilot de GitHub

El modo del agente copilot de GitHub ofrece una experiencia de chat contextual controlada por acciones en la extensión MSSQL para Visual Studio Code. Con el modo de agente, GitHub Copilot puede ir más allá de sugerir código: puede ejecutar de forma segura tareas reales de base de datos mediante avisos de lenguaje natural o herramientas integradas. Puede enumerar todas las conexiones, conectarse a servidores o bases de datos específicos y explorar esquemas sin salir del editor.

Tip

No es necesario mencionar a un participante como @mssql para usar herramientas SQL en modo agente. Una vez que la extensión MSSQL está activa, sus herramientas están disponibles automáticamente en la interfaz del modo agente. Para obtener más información, vea Herramientas de modo agente.

Estas acciones están basadas en herramientas aportadas por la extensión MSSQL y se muestran directamente en el modo de agente de GitHub Copilot. Para obtener más información sobre cómo funciona el modo de agente, consulte la documentación de Visual Studio Code en modo agente.

¿Qué es el modo de agente?

El modo de agente permite a GitHub Copilot ir más allá de sugerir código. Ahora puede realizar acciones seguras y confirmadas dentro del entorno de desarrollo de SQL, mediante variables de chat como #mssql_connect, o frases naturales como:

Connect to my Library database using my LocalDev profile

Captura de pantalla de la interfaz de chat del modo de agente copilot de GitHub.

Referencia de la herramienta para el modo agente de MSSQL

En esta sección se proporciona una referencia detallada para las herramientas específicas de SQL disponibles en el modo del agente copilot de GitHub. La extensión MSSQL contribuye a estas herramientas, lo que permite a GitHub Copilot ejecutar acciones a través de variables de chat o mensajes de lenguaje natural. Todas las herramientas requieren confirmación del usuario antes de la ejecución.

Captura de pantalla de la lista de herramientas específicas de SQL que ha contribuido la extensión MSSQL en el modo agente de Copilot.

Tip

También puede usar variables de chat como #mssql_connect invocar estas herramientas directamente o escribir mensajes en lenguaje natural, como:

Connect to my development database

GitHub Copilot controla automáticamente la selección de herramientas.

Administración de conexiones

Nombre de la herramienta Description
connect Establece una conexión de base de datos mediante un perfil de conexión guardado o un par de servidor o base de datos especificado.
disconnect Finaliza la sesión de conexión activa actual.
change_database Cambia la base de datos de una sesión de conexión existente.
get_connection_details Obtiene los detalles de conexión de una conexión MSSQL específica.
list_servers Enumera todos los perfiles de conexión de SQL Server guardados en su entorno.
list_databases Enumera todas las bases de datos disponibles para un servidor MSSQL conectado.

Examples

Las siguientes frases se pueden usar para interactuar con GitHub Copilot.

- 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

Captura de pantalla del ejemplo mediante una herramienta de agente para conectarse a una base de datos en el chat de GitHub Copilot.

Funcionamiento de la lógica de conexión

El modo agente copilot de GitHub admite formas flexibles de conectarse a la base de datos SQL, ya sea haciendo referencia a perfiles guardados o especificando directamente un servidor y una base de datos. Este es el funcionamiento de la lógica de conexión:

Cuando se conecta a través del perfil guardado:

  1. Un usuario puede conectarse haciendo referencia al nombre de un perfil de conexión guardado.
  2. GitHub Copilot usa la mssql_list_servers herramienta para comprobar que el perfil existe.
  3. A continuación, la herramienta mssql_connect usa el profileId guardado y sus parámetros para establecer la conexión.

Al conectarse a través de la especificación de servidor o base de datos:

  • Si un perfil guardado coincide con el servidor y la base de datos especificados:

    1. GitHub Copilot usa mssql_list_servers para buscar la coincidencia.
    2. A continuación, llama a mssql_connect utilizando el perfil completo.

  • Si un perfil guardado coincide solo con el servidor:

    1. GitHub Copilot busca el perfil de servidor coincidente.
    2. Intenta conectarse sustituyendo la base de datos solicitada por el usuario en ese perfil.
    3. Si se produce un error en la conexión, se muestra un error.

  • Si ningún perfil coincide con el servidor especificado:

    • GitHub Copilot notifica un error.

Este sistema de coincidencia flexible permite que GitHub Copilot controle una serie de escenarios de conexión, lo que minimiza el esfuerzo del usuario al tiempo que garantiza acciones seguras y confirmables.

Exploración de esquemas

Nombre de la herramienta Description
show_schema Muestra un diagrama de alto nivel del esquema de base de datos conectado, incluidas las tablas y las relaciones.
list_schemas Enumera todos los esquemas de una base de datos para un servidor MSSQL conectado.
list_tables Enumera todas las tablas de una base de datos para un servidor MSSQL conectado.
list_views Enumera todas las vistas de una base de datos para un servidor MSSQL conectado.
list_functions Enumera todas las funciones de una base de datos para un servidor MSSQL conectado.

Examples

Las siguientes frases se pueden usar para interactuar con GitHub Copilot.

- 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?

Captura de pantalla de la animación que muestra la herramienta visualizador de esquemas de base de datos en modo agente de Copilot.

Ejecución de consultas

Nombre de la herramienta Description
run_query Ejecuta una consulta SQL en la base de datos conectada.

Examples

Las siguientes frases se pueden usar para interactuar con GitHub Copilot.

- 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

Captura de pantalla del ejemplo mediante una herramienta de agente para conectarse a una base de datos y recuperar datos.

Captura de pantalla de otro ejemplo mediante una herramienta de agente para conectarse a una base de datos y recuperar datos.

Cómo se administran las herramientas en modo agente

GitHub Copilot puede invocar herramientas específicas de MSSQL y otras herramientas con contribución de extensión al procesar la solicitud. Estas herramientas están visibles en la interfaz modo de agente en el menú Herramientas, donde puede habilitar o deshabilitar herramientas específicas.

Cuando se invoca una herramienta ,especialmente si interactúa con la máquina o la base de datos, GitHub Copilot solicita confirmación para garantizar la ejecución segura. Puede permitir la herramienta solo para la sesión actual, el área de trabajo o aprobarla de forma permanente.

Para más información sobre la visibilidad y las aprobaciones de herramientas, visite Administrar aprobaciones de herramientas.

Flujo de trabajo de confirmación del modo de agente

Cuando GitHub Copilot selecciona una herramienta, se muestra un diálogo de confirmación que presenta detalles de la acción solicitada. Debe aprobar explícitamente la solicitud para poder ejecutar cualquier comando que interactúe con la máquina o la base de datos:

  • Permitir en esta sesión
  • Permitir en este espacio de trabajo
  • Permitir siempre

Este paso de confirmación ayuda a garantizar interacciones seguras e intencionadas con el entorno de desarrollo.

Note

Para obtener más información sobre cómo funciona la confirmación en todas las herramientas del modo agente, consulte la documentación de Visual Studio Code sobre aprobaciones de herramientas.

Contenido relacionado

  • Last updated on