Compartilhar via

Início Rápido: Usar o Modo de Agente copilot do GitHub

O Modo Agente do Copilot do GitHub traz uma experiência de chat contextual orientada por ação para a extensão MSSQL para Visual Studio Code. Com o Modo de 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 internas. 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. Depois que a extensão MSSQL estiver ativa, suas ferramentas estarão automaticamente disponíveis na interface do Modo do Agente. Para obter mais informações, consulte As Ferramentas de Modo do 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 do Agente funciona, consulte a documentação do Visual Studio Code sobre o modo agente.

O que é o Modo do Agente?

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

Connect to my Library database using my LocalDev profile

Captura de tela da interface de chat do GitHub Copilot Agent Mode.

Referência da ferramenta no modo Agente do MSSQL

Esta seção fornece uma referência detalhada para as ferramentas específicas do SQL disponíveis no Modo do Agente Copilot do GitHub. 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 exigem 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 do Agente copilot.

Tip

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

Connect to my development database

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

Gerenciamento de conexões

Nome da ferramenta Description
connect Estabelece uma conexão de banco de dados usando um perfil de conexão salvo ou um par de 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 salvos do SQL Server 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 do 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 Modo do Agente Copilot do GitHub dá suporte a maneiras flexíveis de se conectar ao banco de dados SQL, fazendo referência a perfis salvos ou especificando diretamente um servidor e um banco de dados. Veja como funciona a lógica de conexão:

Quando você se conecta por meio 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. Em seguida, a ferramenta mssql_connect usa o salvo e seus parâmetros profileId para estabelecer a conexão.

Quando você se conecta por meio da 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 localizar a correspondência.
    2. Em seguida, ele chama mssql_connect usando o perfil completo.

  • Se um perfil salvo corresponder apenas ao servidor:

    1. O GitHub Copilot localiza 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 GitHub Copilot relata um erro.

Esse 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 usuário, garantindo ações seguras e verificáveis.

Exploração de esquema

Nome da ferramenta Description
show_schema Exibe um diagrama de alto nível do esquema de 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 visões em um banco de dados para 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 visualizador de esquema de banco de dados no Modo do Agente copilot.

Execução de 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 do 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 com contribuição de extensão ao processar sua solicitação. Essas ferramentas ficam visíveis na interface do Modo do Agente no menu Ferramentas, em que você pode habilitar ou desabilitar ferramentas específicas.

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

Para obter mais informações sobre visibilidade e 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, ele exibe uma caixa de diálogo de confirmação mostrando detalhes sobre a ação solicitada. Você deve aprovar explicitamente a solicitação antes que ela possa executar quaisquer comandos que interajam com seu computador ou banco de dados:

  • Permitir nesta sessão
  • Permitir neste ambiente
  • Sempre permitir

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 agente, consulte a documentação do Visual Studio Code sobre aprovações de ferramentas.

Conteúdo relacionado

  • Last updated on