Partilhar via

Início rápido: Usar o Modo Agente Copilot do GitHub

O GitHub Copilot Agent Mode traz uma experiência de bate-papo contextual e orientada por ação para a extensão MSSQL para Visual Studio Code. Com o Modo Agente, o GitHub Copilot pode ir além da sugestão de código — ele pode executar com segurança tarefas reais de banco de dados usando prompts de linguagem natural ou ferramentas integradas. Você pode listar todas as suas conexões, conectar-se a servidores/bancos de dados específicos e explorar esquemas sem sair do editor.

Tip

Você não precisa mencionar um participante como @mssql para usar ferramentas SQL no Modo Agente. Quando a extensão MSSQL estiver ativa, suas ferramentas estarão automaticamente disponíveis na interface do Modo de Agente. Para obter mais informações, consulte Ferramentas do modo de agente.

Essas ações são alimentadas por ferramentas contribuídas pela extensão MSSQL e exibidas diretamente no Modo de Agente do GitHub Copilot. Para obter mais informações sobre como o Modo de Agente funciona, consulte a documentação do Visual Studio Code no Modo de Agente.

O que é o Modo Agente?

O Modo de Agente permite que o GitHub Copilot vá além de sugerir código. Agora ele pode executar ações seguras e confirmadas dentro do seu ambiente de desenvolvimento SQL, usando variáveis de bate-papo como #mssql_connect, ou frases naturais como:

Connect to my Library database using my LocalDev profile

Captura de tela da interface de bate-papo do GitHub Copilot Agent Mode.

Referência da ferramenta MSSQL Modo de Agente

Esta seção fornece uma referência detalhada para as ferramentas específicas do SQL disponíveis no GitHub Copilot Agent Mode. A extensão MSSQL contribui com essas ferramentas, permitindo que o GitHub Copilot execute ações por meio de variáveis de chat ou prompts de linguagem natural. Todas as ferramentas requerem confirmação do usuário antes da execução.

Captura de tela da lista de ferramentas específicas do SQL contribuídas pela extensão MSSQL no modo Copilot Agent.

Tip

Você também pode usar variáveis de bate-papo, como #mssql_connect invocar essas ferramentas diretamente, ou escrever prompts em linguagem natural, como:

Connect to my development database

O GitHub Copilot lida com a seleção de ferramentas automaticamente.

Gestão de ligações

Nome da ferramenta Description
connect Estabelece uma conexão de banco de dados usando um perfil de conexão salvo ou um par servidor/banco de dados especificado.
disconnect Encerra a sessão de conexão ativa atual.
change_database Altera o banco de dados para uma sessão de conexão existente.
get_connection_details Obtém detalhes de conexão para uma conexão MSSQL específica.
list_servers Lista todos os perfis de conexão do SQL Server salvos em seu ambiente.
list_databases Lista todos os bancos de dados disponíveis para um servidor MSSQL conectado.

Examples

As frases a seguir podem ser usadas para interagir com o 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 tela de exemplo usando uma ferramenta de agente para se conectar a um banco de dados no chat do GitHub Copilot.

Como funciona a lógica de conexão

O GitHub Copilot Agent Mode suporta maneiras flexíveis de se conectar ao seu banco de dados SQL, seja fazendo referência a perfis salvos ou especificando um servidor e um banco de dados diretamente. Veja como funciona a lógica de conexão:

Quando você se conecta através do perfil salvo:

  1. Um usuário pode se conectar fazendo referência ao nome de um perfil de conexão salvo.
  2. O GitHub Copilot usa a mssql_list_servers ferramenta para verificar se o perfil existe.
  3. A ferramenta mssql_connect então utiliza os dados guardados de profileId e os seus parâmetros para estabelecer a conexão.

Quando você se conecta via especificação de servidor/banco de dados:

  • Se um perfil salvo corresponder ao servidor e ao banco de dados especificados:

    1. O GitHub Copilot usa mssql_list_servers para encontrar a correspondência.
    2. Em seguida, liga mssql_connect usando o perfil completo.

  • Se um perfil guardado corresponder apenas a um servidor:

    1. O GitHub Copilot encontra o perfil de servidor correspondente.
    2. Ele tenta se conectar substituindo o banco de dados solicitado pelo usuário nesse perfil.
    3. Se a conexão falhar, um erro será mostrado.

  • Se nenhum perfil corresponder ao servidor especificado:

    • O Copilot do GitHub relata um erro.

Este sistema de correspondência flexível permite que o GitHub Copilot lide com uma variedade de cenários de conexão, minimizando o esforço do utilizador e garantindo ações seguras e verificáveis.

Exploração de esquemas

Nome da ferramenta Description
show_schema Exibe um diagrama de alto nível do esquema do banco de dados conectado, incluindo tabelas e relações.
list_schemas Lista todos os esquemas em um banco de dados para um servidor MSSQL conectado.
list_tables Lista todas as tabelas em um banco de dados para um servidor MSSQL conectado.
list_views Lista todas as vistas numa base de dados de um servidor MSSQL conectado.
list_functions Lista todas as funções em um banco de dados para um servidor MSSQL conectado.

Examples

As frases a seguir podem ser usadas para interagir com o 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 tela da animação mostrando a ferramenta de visualização de esquema de banco de dados no modo Copilot Agent.

Execução da consulta

Nome da ferramenta Description
run_query Executa uma consulta SQL no banco de dados conectado.

Examples

As frases a seguir podem ser usadas para interagir com o 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 tela de exemplo usando uma ferramenta de agente para se conectar a um banco de dados e recuperar dados.

Captura de tela de outro exemplo usando uma ferramenta de agente para se conectar a um banco de dados e recuperar dados.

Como as ferramentas são gerenciadas no Modo de Agente

O GitHub Copilot pode invocar ferramentas específicas do MSSQL e outras ferramentas de extensão enquanto processa sua solicitação. Essas ferramentas são visíveis na interface do Modo de Agente, no menu Ferramentas, onde você pode habilitar ou desabilitar ferramentas específicas.

Quando uma ferramenta é invocada, especialmente se ela interage com sua máquina ou banco de dados, o GitHub Copilot solicita confirmação para garantir uma execução segura. Você pode permitir a ferramenta apenas para a sessão atual, o espaço de trabalho ou aprová-la permanentemente.

Para saber mais sobre a visibilidade e as aprovações de ferramentas, visite Gerenciar aprovações de ferramentas.

Fluxo de trabalho de confirmação do Modo de Agente

Quando o GitHub Copilot seleciona uma ferramenta, aparece uma caixa de diálogo de confirmação que mostra os detalhes da ação solicitada. Você deve aprovar explicitamente a solicitação antes que ela possa executar quaisquer comandos que interajam com sua máquina ou banco de dados:

  • Permitir nesta sessão
  • Permitir neste espaço de trabalho
  • Permitir sempre

Esta etapa de confirmação ajuda a garantir interações seguras e intencionais com seu ambiente de desenvolvimento.

Note

Para obter mais informações sobre como a confirmação funciona em todas as ferramentas no Modo de Agente, consulte a documentação do Visual Studio Code sobre aprovações de ferramentas.

Conteúdo relacionado

  • Last updated on