Partilhar via

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

O Modo Agente permite ao GitHub Copilot utilizar as ferramentas disponíveis na extensão MSSQL para Visual Studio Code. Quando a extensão está instalada e ativa, o Copilot pode listar ligações SQL Server, ligar-se a um servidor e base de dados, e recuperar metadados da base de dados.

Todas as ações utilizam o mesmo contexto de ligação e credenciais da extensão MSSQL. O Modo Agente não introduz autenticação adicional nem alterações de permissões.

Tip

Não precisas de referenciar explicitamente a extensão MSSQL (@mssql) ao usar o Modo Agente. Se a extensão estiver ativa, as suas ferramentas estão disponíveis automaticamente. Para obter mais informações, consulte Ferramentas do modo de agente.

Para detalhes sobre como o Modo Agente seleciona e executa ferramentas, consulte a documentação do Visual Studio Code sobre o Modo Agente.

O que é o Modo Agente?

O Modo Agente permite ao GitHub Copilot realizar ações relacionadas com SQL usando a extensão MSSQL, sendo necessária a confirmação do utilizador antes da execução.

Pode invocar estas ações usando variáveis de chat como #mssql_connect, ou emitindo pedidos equivalentes em linguagem natural, por exemplo:

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 Liga-se a uma base de dados usando um perfil de ligação guardado ou um servidor e base de dados especificados.
disconnect Termina a sessão de ligaçã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

Use as seguintes frases 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. Eis como funciona a lógica da ligação.

Quando se liga a um perfil guardado:

  1. Conecta-se consultando o nome de um perfil de ligação guardado.
  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 se liga especificando um servidor e uma base 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 ao GitHub Copilot lidar com uma variedade de cenários de ligação. Minimiza o esforço do utilizador, garantindo ações seguras e confirmá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

Use as seguintes frases 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 na base de dados conectada.

Examples

Use as seguintes frases 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 usar ferramentas específicas do MSSQL e outras ferramentas contribuídas por extensões enquanto processa o seu pedido. Podes ver estas ferramentas na interface do Modo Agente, no menu Ferramentas , onde também podes ativar ou desativar ferramentas específicas.

Quando invocas uma ferramenta, especialmente se esta interagir com a tua máquina ou base de dados, o GitHub Copilot pede confirmação para garantir uma execução segura. Podes permitir a ferramenta apenas para a sessão atual, o espaço de trabalho ou permanentemente.

Para mais informações sobre visibilidade e aprovações de ferramentas, consulte Gerenciar aprovações de ferramentas.

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

Quando o GitHub Copilot seleciona uma ferramenta, ele apresenta um diálogo de confirmação que mostra detalhes sobre a 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