Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El modo de agente permite GitHub Copilot orquestar las herramientas aportadas por la extensión MSSQL para Visual Studio Code. Cuando la extensión está instalada y activa, GitHub Copilot puede listar conexiones a Microsoft SQL Server, conectarse a un servidor y a una base de datos, recuperar metadatos del esquema, ejecutar consultas e investigar el rendimiento de Almacén de consultas, todo a partir de indicaciones en lenguaje natural. Los requisitos de aprobación dependen de la herramienta.
Todas las acciones usan el mismo contexto de conexión y credenciales que la extensión MSSQL. El modo de agente no introduce otros cambios de autenticación o permiso.
Tip
Use el modo de agente para flujos de trabajo de varios pasos, exploración a escala y cambios delegados. Use el modo de pregunta cuando necesite una sola respuesta o una consulta de una sola toma. Use el modo de planeación cuando necesite analizar un diseño antes de escribir lenguaje de definición de datos (DDL) de Transact-SQL (T-SQL).
Conclusiones clave
- El modo de agente recoge automáticamente las herramientas de extensión de MSSQL. No se requiere ninguna mención de
@mssql. - Revisa y aprueba las llamadas a las herramientas cuando se te solicite. Las lecturas de diagnóstico de Almacén de consultas no solicitan confirmación; forzar o desvincular un plan requiere revisión y confirmación.
- El modo de agente tiene conocimiento del esquema gracias a sus herramientas: cada llamada a una herramienta devuelve datos reales de tu base de datos conectada.
- Para ver el contexto arquitectónico en todas las superficies, consulte Cómo funciona GitHub Copilot con la extensión MSSQL.
Cuándo usar el modo de agente
El modo de agente es el mejor para:
- Flujos de trabajo de varios pasos. "Conéctese a LocalDev, cambie a AdventureWorks y, a continuación, muéstrame todas las tablas con una clave externa al cliente".
- Exploración a gran escala. "Busque los procedimientos almacenados que hagan referencia a SalesOrderHeader y resuma lo que hace cada uno".
- Investigaciones de rendimiento. Use Almacén de consultas para encontrar las consultas con mayor uso de CPU en las últimas 24 horas y luego analice el historial, las esperas y los planes de la consulta principal.
- Cambios delegados. "Agregue columnas de auditoría a cada tabla del esquema Sales y vuelva a generar los procedimientos almacenados relacionados".
Use el modo de pregunta cuando una sola pregunta o una consulta de una sola toma responda a su necesidad. Use comandos de barra diagonal cuando ya sepa qué acción desea. Use el modo de plan cuando desee un plan escrito antes de cualquier cambio.
Para obtener más información sobre cómo el modo de agente selecciona y ejecuta herramientas, consulte la documentación de Visual Studio Code en el modo de agente.
¿Qué es el modo de agente?
El modo Agente permite a GitHub Copilot realizar acciones relacionadas con SQL utilizando la extensión MSSQL. Las herramientas que requieren confirmación presentan la acción solicitada para su revisión antes de la ejecución.
Puede invocar estas acciones mediante variables de chat como #mssql_connect, o emitiendo solicitudes de lenguaje natural equivalentes, por ejemplo:
Connect to my Library database using my LocalDev profile
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. Las herramientas de diagnóstico de Almacén de consultas leen los datos de rendimiento capturados sin solicitar confirmación. Revise y apruebe otras acciones cuando se le solicite.
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 |
Se conecta a una base de datos mediante un perfil de conexión guardado o un servidor y una base de datos especificados. |
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
Use las siguientes frases 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
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. Aquí se muestra cómo funciona la lógica de conexión.
Cuando te conectas con un perfil guardado:
- Para conectarse, haga referencia al nombre de un perfil de conexión guardado.
- GitHub Copilot usa la
mssql_list_serversherramienta para comprobar que el perfil existe. - A continuación, la herramienta
mssql_connectusa elprofileIdguardado y sus parámetros para establecer la conexión.
Al conectarse especificando un servidor y una base de datos:
Si un perfil guardado coincide con el servidor y la base de datos especificados:
- GitHub Copilot usa
mssql_list_serverspara buscar la coincidencia. - A continuación, llama a
mssql_connectutilizando el perfil completo.
- GitHub Copilot usa
Si un perfil guardado coincide solo con el servidor:
- GitHub Copilot busca el perfil de servidor coincidente.
- Intenta conectarse sustituyendo la base de datos solicitada por el usuario en ese perfil.
- 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 GitHub Copilot controlar una variedad de escenarios de conexión. Minimiza el esfuerzo del usuario a la vez 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
Use las siguientes frases 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?
Ejecución de consultas
| Nombre de la herramienta | Description |
|---|---|
run_query |
Ejecuta una consulta SQL en la base de datos conectada. |
Examples
Use las siguientes frases 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
Herramientas de rendimiento de Almacén de consultas (vista previa)
Utilice estas herramientas para investigar el rendimiento de consultas capturadas en lugar de construir manualmente SQL de diagnóstico. Requieren una base de datos que soporte Almacén de consultas, datos capturados para el periodo que solicites y permiso para leer esos datos. Puede identificar un destino mediante una conexión existente o un perfil de conexión guardado y el nombre de la base de datos.
| Nombre de la herramienta | Description |
|---|---|
mssql_query_store_status |
Lee el estado de Almacén de consultas, los motivos de solo lectura y el historial disponible. |
mssql_query_store_top_queries |
Encuentra consultas ordenadas por una métrica de recursos o un recuento de ejecuciones en una ventana de tiempo. |
mssql_query_store_query_details |
Lee el texto, las estadísticas de ejecución y los planes con sus estadísticas de una consulta. |
mssql_query_store_query_history |
Lee el rendimiento de una consulta a lo largo del tiempo, incluyendo estadísticas de los planes que se ejecutaron en cada intervalo. |
mssql_query_store_wait_stats |
Lee el tiempo de espera por categoría para una base de datos, consulta o plan. Requiere soporte y captura de Almacén de consultas para estadísticas de espera. |
mssql_query_store_plan_summary |
Resume la información de la instrucción de un plan almacenado, las advertencias, las recomendaciones de índice faltante y los operadores costosos. |
mssql_query_store_analyze_query |
Combina detalles de consulta, planes, historial de ejecución, esperas y resúmenes de los planes principales en una sola llamada de diagnóstico. |
mssql_open_performance_dashboard |
Abre el Panel de Rendimiento de Consultas para una base de datos, o en una consulta y pestaña específicas. |
mssql_query_store_plan_forcing |
Fuerza o quita el forzado de un plan de consulta después de revisar y confirmar el SQL generado. |
mssql_query_store_verify_forced_plan |
Comprueba si las ejecuciones posteriores a que se forzara un plan utilizaron ese plan. |
Para iniciar una investigación, identifica la base de datos y el periodo en tu indicación:
Use Query Store to find the queries with the highest total CPU time in AdventureWorksLT in the past 24 hours. Analyze the top query, explain its execution history and waits, and open it in the performance dashboard. Don't make changes.
Sustituye el nombre de la base de datos de ejemplo por tu base de datos. También puedes referenciar una herramienta explícitamente, como #mssql_query_store_analyze_query, cuando ya conoces el ID de consulta y la base de datos objetivo.
La acción Chat del panel abre el modo agente y envía un mensaje que hace referencia #mssql_query_store_analyze_query explícita y proporciona el servidor, la base de datos, el ID de perfil guardado, el ID de consulta y el rango de tiempo de la consulta seleccionada. Para una guía y indicaciones de seguimiento, consulte Investigar el rendimiento de Almacén de consultas.
Importante
Las lecturas de diagnóstico no modifican la base de datos ni requieren confirmación. Forzar o desreforzar un plan es un cambio aparte: la herramienta presenta el SQL exacto y cualquier advertencia para su revisión y confirmación. La verificación de un plan fijado es de solo lectura. Diagnostica el problema y revisa la evidencia antes de solicitar un cambio de plan.
La retención y captura de Almacén de consultas determina los datos disponibles. Si Almacén de consultas está desactivado o el periodo solicitado no tiene datos capturados, las herramientas no pueden proporcionar un diagnóstico de rendimiento para ese periodo. Para detalles de configuración, consulte Requisitos previos del Panel de Rendimiento de Consultas.
Cómo se administran las herramientas en modo agente
GitHub Copilot puede usar herramientas específicas de MSSQL y otras herramientas de extensión aportadas mientras procesa la solicitud. Puede ver estas herramientas en la interfaz modo de agente en el menú Herramientas , donde también puede activar o desactivar herramientas específicas.
Cuando una herramienta requiere confirmación, GitHub Copilot te pide que revises la acción solicitada antes de que se ejecute. Puede permitir esta herramienta solo para la sesión actual, el área de trabajo o permanentemente. Las lecturas de diagnóstico de Almacén de consultas no solicitan confirmación; lo hacen el forzado y las anulaciones del forzado de planes.
Para obtener más información sobre la visibilidad y las aprobaciones de herramientas, consulte Administración de aprobaciones de herramientas.
Flujo de trabajo de confirmación del modo de agente
Para herramientas que requieren confirmación, GitHub Copilot muestra detalles sobre la acción solicitada. Revise la solicitud antes de elegir una opción de aprobación:
- Permitir 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.
Catálogo de mensajes del modo de agente
Use estas indicaciones de lenguaje natural para invocar las herramientas de extensión de MSSQL a través del modo de agente. Para cada categoría, se hace referencia cruzada a un comando de barra diagonal equivalente o al símbolo del modo de solicitud .
Administración de conexiones
Connect to my LocalDev profile and set AdventureWorks as the active database.
List all my saved connection profiles and tell me which one I'm currently connected to.
Disconnect from my current database.
Comandos de barra diagonal equivalentes: /connect, /listServers, /changeDatabase, /disconnect.
Exploración de esquemas
Show me every table in the SalesLT schema, grouped by whether they're
referenced by a foreign key from another table.
Find all stored procedures that reference SalesLT.SalesOrderHeader and
summarize what each one does in one sentence.
Which tables in the current database have no primary key?
Los equivalentes solicitan indicaciones: consulte Chatear con el @mssql participante.
Ejecución de consultas
Run a query to count the number of active customers in SalesLT.Customer,
then show me the top 10 by order total.
Show me the execution plan for this query: SELECT ... FROM ...
Execute the last query I ran against my Dev database instead.
Flujos de trabajo de varios pasos
Connect to LocalDev, switch to AdventureWorks, list all tables with a
foreign key to SalesLT.Customer, and save the list to a file called
customer-dependents.md.
Find every stored procedure that uses dynamic SQL and open each one
in a new editor tab so I can review them.
Cambios de esquema delegados
Note
Los cambios de esquema son buenos candidatos para pasar primero por el modo de planificación. Planee los cambios, repárelos y, a continuación, entregue el plan al modo de agente para su ejecución.
Add createdAt and updatedAt audit columns to every table in the Sales
schema that doesn't already have them. Use DATETIME2(7) with a default
of GETUTCDATE().
Regenerate every stored procedure that inserts into SalesLT.Customer
to include the new email column.
Contenido relacionado
- Cómo funciona GitHub Copilot con la extensión MSSQL
- Panel de Rendimiento de Consultas (vista previa)
-
Inicio rápido: Chatea con el
@mssqlparticipante (modo preguntar) - Inicio rápido: Usar el modo plan para el diseño de bases de datos basado en especificaciones
- Inicio rápido: Usar comandos de barra de GitHub Copilot
- Inicio rápido: Utiliza instrucciones personalizadas para alinear GitHub Copilot con tus convenciones T-SQL
- Inicio rápido: Generar código
- Inicio rápido: Diseña esquemas visualmente con escenarios GitHub Copilot integrados
- Inicio rápido: Utilice el generador de consultas inteligentes
- Inicio rápido: Asistente optimizador de consultas
- Integraciones de mapeo objeto-relacional con GitHub Copilot
- Limitaciones y problemas conocidos