Quickstart - IntelliCode team completions - AI-assisted IntelliSense suggestions based on your code
Visual Studio IntelliCode uses machine learning to offer useful, contextually rich code completion suggestion, in-line as you code.
To get IntelliCode's starred contextual completion suggestions for your own types, or other types not commonly found in open source, use team completions. Team completions trains a model just for your codebase, and lets you share it just with anyone with access to your code. You can also keep it up to date automatically by including a task in your CI build pipeline.
IntelliCode team completions is a preview feature in Visual Studio version 16.4 and above and are disabled by default. It can be enabled through Tools > Options > IntelliCode. They are currently available only for C# and C++ code.
How to obtain team completions
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. See automatic acquisition of team models for more information.
NOTE: Your codebase must be under Git source control and pushed to a remote to create a repository-associated model.
Two steps to team completions
Getting team completions on your codebase is quick and easy, in just two steps:
Step 1: Train team completions for your repository manually and try out the completions on your code
Step 2: Automate the training as part of your CI build
Train models for team completions
To train team completions on your repo, follow these steps:
- Clone the repository with the solution you’d like to train on.
- Open the solution or repository folder in Visual Studio.
- 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).
- You’ll be prompted to sign-in with the account you’d like to use. Use the account you normally log in to Visual Studio with.
- Upon successful creation of the model, it will be automatically downloaded to Visual Studio. You can track the model’s progress by opening the Output Window and switching to IntelliCode in the dropdown.
The repository must not already have a repository-associated model already trained on it.
The repository must be under Git source control.
Enable the following settings in Tools > Option > IntelliCode.
- C# or C++ team models for completions
- Acquire team models for completions
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. Once the preview has been installed, you can enable acquiring team models for completions through Tools > Options > IntelliCode.
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.
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.
What happens when you train your model?
When you kickoff training your model for team completions:
- We analyze your code locally.
- We extract a summary file with metadata on your types and their usages.
- We securely upload it to the IntelliCode service and train a completions model tailored to your code.
- Your completions model is automatically shared with those who have access to your repo.
You will see the training progress in your Visual Studio output window's IntelliCode section. Once the training is complete, you will be able to see your summary and the new model tailored to your code. 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.
If you want more information about what data is used and transferred in this process see IntelliCode data and privacy.
Automate model retraining
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.
Before you start, make sure that:
- You have permission to create and edit pipelines for the project. Or, ask your CI Admin.
- The build agent has the minimum required version of Visual Studio installed:
- For C# repositories: Visual Studio 2017 or higher
- For C++ repositories: Visual Studio 2019 Update 4 or higher
- 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.
- Set up a service connection for IntelliCode. This connection is used to upload the training data to create the model.
- In the task configuration pane, type the branch that you want to train the model on.
- Select the IntelliCode service connection you'd like to use for this task from the drop down.
- Ensure that the IntelliCode Model Training task occurs after your build step.
- Save and run your pipeline to create your model.
- Open the corresponding repository from your pipeline in Visual Studio to download the newly created model.
- Your model will be automatically updated and shared with each CI build.