Quickstart - Conclusão da equipe da IntelliCode - sugestões intelliSense assistidas por IA com base no seu códigoQuickstart - IntelliCode team completions - AI-assisted IntelliSense suggestions based on your code

O Visual Studio IntelliCode usa aprendizado de máquina para oferecer sugestão útil, contextualmente rica de conclusão de código, em linha como você codifica.Visual Studio IntelliCode uses machine learning to offer useful, contextually rich code completion suggestion, in-line as you code.

Para obter as sugestões de conclusão contextual estreladas da IntelliCode para seus próprios tipos, ou outros tipos não comumente encontrados em código aberto, use finalizações de equipe.To get IntelliCode's starred contextual completion suggestions for your own types, or other types not commonly found in open source, use team completions. A equipe de conclusão treina um modelo apenas para sua base de código, e permite compartilhá-lo apenas com qualquer pessoa com acesso ao seu código.Team completions trains a model just for your codebase, and lets you share it just with anyone with access to your code. Você também pode mantê-lo atualizado automaticamente, incluindo uma tarefa em seu pipeline de compilação de CI.You can also keep it up to date automatically by including a task in your CI build pipeline.

Observação

As conclusões da equipe do IntelliCode são um recurso de pré-visualização na versão 16.4 ou superior do Visual Studio e são desativadas por padrão.IntelliCode team completions is a preview feature in Visual Studio version 16.4 and above and are disabled by default. Ele pode ser habilitado através deopções de > ferramentas > IntelliCode.It can be enabled through Tools > Options > IntelliCode. Atualmente, eles estão disponíveis apenas para código C# e C++.They are currently available only for C# and C++ code.

Como obter finalizações da equipeHow to obtain team completions

Você pode treinar modelos para conclusão de equipe para um repositório e todos os usuários que podem clonar e editar o repositório têm acesso automático às suas conclusões.You can train models for team completions to a repository and all users who can clone and edit the repository are granted automatic access to your completions. Consulte a aquisição automática de modelos de equipe para obter mais informações.See automatic acquisition of team models for more information.

NOTA: Sua base de código deve estar sob o controle de origem do Git e empurrada para um controle remoto para criar um modelo associado ao repositório.NOTE: Your codebase must be under Git source control and pushed to a remote to create a repository-associated model.

Dois passos para a conclusão da equipeTwo steps to team completions

Obter conclusões de equipe em sua base de código é rápido e fácil, em apenas dois passos:Getting team completions on your codebase is quick and easy, in just two steps:

Passo 1: Treine as conclusões da equipe para o seu repositório manualmente e experimente as conclusões do seu códigoStep 1: Train team completions for your repository manually and try out the completions on your code
Passo 2: Automatize o treinamento como parte da sua compilação de ICStep 2: Automate the training as part of your CI build

Modelos de trem para conclusão de equipeTrain models for team completions

Para treinar as conclusões da equipe em seu repo, siga estas etapas:To train team completions on your repo, follow these steps:

  1. Clone o repositório com a solução que você gostaria de treinar.Clone the repository with the solution you’d like to train on.
  2. Abra a pasta de solução ou repositório no Visual Studio.Open the solution or repository folder in Visual Studio.
  3. Crie um modelo indo para exibir > outro > modelode IntelliCode do Windows Train neste repositório ou procurando por "Train" no Visual Studio Search (Ctrl + Q).Create a model by going to View > Other Windows > Train IntelliCode model on this repository or by searching for "Train" in Visual Studio Search (Ctrl + Q).
  4. Você será solicitado a fazer login com a conta que você gostaria de usar.You’ll be prompted to sign-in with the account you’d like to use. Use a conta com a que você normalmente faz login no Visual Studio.Use the account you normally log in to Visual Studio with.
  5. Após a criação bem-sucedida do modelo, ele será automaticamente baixado para o Visual Studio.Upon successful creation of the model, it will be automatically downloaded to Visual Studio. Você pode acompanhar o progresso do modelo abrindo a janela de saída e mudando para IntelliCode no dropdown.You can track the model’s progress by opening the Output Window and switching to IntelliCode in the dropdown.

Requisitos:Requirements:

  • O repositório ainda não deve ter um modelo associado ao repositório já treinado nele.The repository must not already have a repository-associated model already trained on it.

  • O repositório deve estar sob controle de origem do Git.The repository must be under Git source control.

  • Habilite as seguintes configurações naopção > Ferramentas > IntelliCode.Enable the following settings in Tools > Option > IntelliCode.

    • Modelos de equipe C# ou C++ para finalizaçõesC# or C++ team models for completions
    • Adquira modelos de equipe para finalizaçõesAcquire team models for completions

    Observação

    Se você não ver as configurações acima no Visual Studio, certifique-se de que você instalou pelo menos a versão 16.4 ou superior do Visual Studio.If you don't see the above settings in Visual Studio, be sure that you have installed at least Visual Studio version 16.4 or above. Uma vez que a visualização tenha sido instalada, você pode habilitar a aquisição de modelos de equipe para conclusão atravésde opções de > ferramentas > IntelliCode.Once the preview has been installed, you can enable acquiring team models for completions through Tools > Options > IntelliCode.

Uma vez que o treinamento esteja concluído, tente escrever algum código usando as classes/tipos que são particulares ao seu repo - você deve ver sugestões estreladas para os casos mais comuns.Once the training is complete, try writing some code using the classes/types that are particular to your repo - you should see starred suggestions for the most common cases.

Uma vez que você esteja feliz com as conclusões da equipe em seu repo, você pode configurar para criar e retreinar automaticamente as conclusões da equipe como parte de seu pipeline de integração contínua no Azure Pipelines com a tarefa de compilação IntelliCode.Once you are happy with the team completions on your repo, you can set up to automatically create and retrain team completions as part of your continuous integration pipeline in Azure Pipelines with the IntelliCode build task.

O que acontece quando você treina seu modelo?What happens when you train your model?

Quando você inicia o treinamento do seu modelo para finalizações da equipe:When you kickoff training your model for team completions:

  • Analisamos seu código localmente.We analyze your code locally.
  • Extraímos um arquivo de resumo com metadados sobre seus tipos e seus usos.We extract a summary file with metadata on your types and their usages.
  • Nós o carregamos com segurança para o serviço IntelliCode e treinamos um modelo de conclusão adaptado ao seu código.We securely upload it to the IntelliCode service and train a completions model tailored to your code.
  • Seu modelo de conclusão é compartilhado automaticamente com aqueles que têm acesso ao seu repo.Your completions model is automatically shared with those who have access to your repo.

Você verá o progresso do treinamento na seção IntelliCode da janela de saída do Visual Studio.You will see the training progress in your Visual Studio output window's IntelliCode section. Uma vez que o treinamento esteja completo, você poderá ver seu resumo e o novo modelo adaptado ao seu código.Once the training is complete, you will be able to see your summary and the new model tailored to your code. Em seguida, você pode tentar escrever algum código usando as classes/tipos que são particulares ao seu repo - você deve ver sugestões estreladas para os casos mais comuns.You can then try writing some code using the classes/types that are particular to your repo - you should see starred suggestions for the most common cases.

Se você quiser mais informações sobre quais dados são usados e transferidos neste processo, consulte dados e privacidade da IntelliCode.If you want more information about what data is used and transferred in this process see IntelliCode data and privacy.

Automatize a requalificação do modeloAutomate model retraining

Para manter suas conclusões atualizadas à medida que seu código muda, você pode automatizar o treinamento do seu modelo no Azure DevOps com a tarefa de compilação CI do IntelliCode.To keep your completions up-to-date as your code changes, you can automate training your model in Azure DevOps with the IntelliCode CI build task.

Antes de começar, certifique-se de que:Before you start, make sure that:

  • Você tem permissão para criar e editar pipelines para o projeto.You have permission to create and edit pipelines for the project. Ou, pergunte ao seu ci admin.Or, ask your CI Admin.
  • O agente de compilação tem a versão mínima exigida do Visual Studio instalada:The build agent has the minimum required version of Visual Studio installed:
    • Para repositórios C#: Visual Studio 2017 ou superiorFor C# repositories: Visual Studio 2017 or higher
    • Para repositórios C++: Visual Studio 2019 Atualização 4 ou superiorFor C++ repositories: Visual Studio 2019 Update 4 or higher

InstalaçãoSetup

  1. Instale a tarefa de treinamento do modelo de equipe do Visual Studio IntelliCode do Visual Studio Marketplace para a organização Azure DevOps ou o Azure DevOps Server para retreinar automaticamente as conclusões da sua equipe sempre que o código for alterado.Install the Visual Studio IntelliCode team model training task from Visual Studio Marketplace to your Azure DevOps organization or Azure DevOps Server to automatically retrain your team completions whenever your code changes.
  2. Configure uma conexão de serviço para o IntelliCode.Set up a service connection for IntelliCode. Esta conexão é usada para carregar os dados de treinamento para criar o modelo.This connection is used to upload the training data to create the model.
  3. No painel de configuração da tarefa, digite o ramo em que deseja treinar o modelo.In the task configuration pane, type the branch that you want to train the model on.
  4. Selecione a conexão de serviço IntelliCode que você gostaria de usar para esta tarefa a partir do down.Select the IntelliCode service connection you'd like to use for this task from the drop down.
  5. Certifique-se de que a tarefa de treinamento do modelo IntelliCode ocorra após a etapa de compilação.Ensure that the IntelliCode Model Training task occurs after your build step.
  6. Salve e execute seu pipeline para criar seu modelo.Save and run your pipeline to create your model.
  7. Abra o repositório correspondente do seu pipeline no Visual Studio para baixar o modelo recém-criado.Open the corresponding repository from your pipeline in Visual Studio to download the newly created model.
  8. Seu modelo será atualizado automaticamente e compartilhado com cada compilação ci.Your model will be automatically updated and shared with each CI build.

Confira tambémSee also