@@ -10,16 +10,16 @@ info: To determine the technical writer assigned to the Stage/Group associated w
> - [Removed third-party AI setting](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/136144) in GitLab 16.6.
> - [Removed support for OpenAI from all GitLab Duo features](https://gitlab.com/groups/gitlab-org/-/epics/10964) in GitLab 16.6.
GitLab is creating AI-assisted features across our DevSecOps platform. These features aim to help increase velocity and solve key pain points across the software development lifecycle.
GitLab is creating AI-assisted features across our DevSecOps platform. These features aim to help increase velocity and solve key pain points across the software development lifecycle. GitLab Duo features are accessible through the [IDE extension](../editor_extensions/index.md) and the GitLab UI. Some of the features are accessible through [GitLab Duo Chat](gitlab_duo_chat.md), which is available in both interfaces.
Some features are still in development. View details about [support for each status](../policy/experiment-beta-support.md#experiment)(Experiment, Beta, Generally Available).
As features become Generally Available, GitLab is [transparent](https://handbook.gitlab.com/handbook/values/#transparency) and updates the documentation to clearly state how and where you can access these capabilities.
GitLab is [transparent](https://handbook.gitlab.com/handbook/values/#transparency). As GitLab Duo features mature, the documentation will be updated to clearly state how and where you can access these capabilities.
| Goal | Feature | Tier/Offering/Status |
|---|---|---|
| Helps you write code more efficiently by showing code suggestions as you type. <br><br><iclass="fa fa-youtube-play youtube"aria-hidden="true"></i>[Watch overview](https://www.youtube.com/watch?v=hCAyCTacdAQ) | [Code Suggestions](project/repository/code_suggestions/index.md) | **Tier:** Premium or Ultimate with [GitLab Duo Pro](../subscriptions/subscription-add-ons.md)<br>**Offering:** GitLab.com, Self-managed, GitLab Dedicated |
| Processes and generates text and code in a conversational manner. Helps you quickly identify useful information in large volumes of text in issues, epics, code, and GitLab documentation. | [Chat](gitlab_duo_chat.md) | **Tier:** Premium, Ultimate<br>**Offering:** GitLab.com, Self-managed, GitLab Dedicated <br>**Status:** Beta (Subject to the [Testing Agreement](https://handbook.gitlab.com/handbook/legal/testing-agreement/)) |
| Processes and generates text and code in a conversational manner. Helps you quickly identify useful information in large volumes of text in issues, epics, code, and GitLab documentation. | [Chat](gitlab_duo_chat.md) | **Tier:**For a limited time, freely available for Premium and Ultimate<br>**Offering:** GitLab.com, Self-managed, GitLab Dedicated |
| Helps you discover or recall Git commands when and where you need them. | [Git suggestions](../editor_extensions/gitlab_cli/index.md#gitlab-duo-commands) | **Tier:** Ultimate <br>**Offering:** GitLab.com <br>**Status:** Experiment |
| Assists with quickly getting everyone up to speed on lengthy conversations to help ensure you are all on the same page. <br><br><iclass="fa fa-youtube-play youtube"aria-hidden="true"></i>[Watch overview](https://www.youtube.com/watch?v=IcdxLfTIUgc) | [Discussion summary](#summarize-issue-discussions-with-discussion-summary) | **Tier:** Ultimate <br>**Offering:** GitLab.com <br>**Status:** Experiment |
@@ -60,7 +60,7 @@ To enable Beta and Experimental AI-powered features, use the [Experiment and Bet
#### GitLab self-managed
To enable Beta and Experimental AI-powered features for GitLab versions where GitLab Duo Chat is not yet generally available, see the [GitLab Duo Chat documentation](gitlab_duo_chat.md#for-self-managed-and-gitlab-dedicated).
To enable Beta and Experimental AI-powered features for GitLab versions where GitLab Duo Chat is not yet generally available, see the [GitLab Duo Chat documentation](gitlab_duo_chat.md#for-self-managed).
### Enable outbound connections to enable GitLab Duo features on Self-managed instances
...
...
@@ -74,7 +74,7 @@ To enable Beta and Experimental AI-powered features for GitLab versions where Gi
Network policy restrictions on `wss://` traffic can cause issues with some GitLab Duo Chat
services. Consider policy updates to allow these services.
### Disable GitLab Duo features for specific groups or projects or an entire instance
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/117695) as an [Experiment](../policy/experiment-beta-support.md#experiment) for SaaS in GitLab 16.0.
> - Changed to [Beta](../policy/experiment-beta-support.md#beta) for SaaS in GitLab 16.6.
> - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/11251) as a [Beta](../policy/experiment-beta-support.md#beta) for self-managed in GitLab 16.8.
> - Changed from Ultimate to [Premium](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/142808) tier in GitLab 16.9.
> - Changed to [Generally Available](../policy/experiment-beta-support.md#generally-available-ga) in GitLab 16.11.
> - Freely available for Ultimate and Premium users for a limited time.
GitLab Duo Chat is your personal AI-powered assistant for boosting productivity.
It can assist various tasks of your daily work with the AI-generated content.
NOTE:
GitLab Duo Chat is a Beta feature. We're continuously extending the capabilities and reliability of the responses.
> For a limited time, the following users have free access to GitLab Duo Chat:
>
> - GitLab.com users who are members of at least one group with a Premium or Ultimate subscription.
> - GitLab self-managed users with a Premium or Ultimate subscription.
> - GitLab Dedicated users.
>
> Eventually a subscription add-on will be required for continued access to GitLab Duo Chat.
Here are examples of common use cases:
| Feature | Use case example | Supported interfaces | Supported deployments |
| [Ask about GitLab](#ask-about-gitlab) | I want to know how to create an issue in GitLab. | GitLab, VS Code, and Web IDE <sup>1</sup> | GitLab.com |
| [Ask about a specific issue](#ask-about-a-specific-issue) | I want to summarize this issue. | GitLab, VS Code, and Web IDE <sup>1</sup> | GitLab.com, self-managed, and GitLab Dedicated |
| [Ask about a specific epic](#ask-about-a-specific-epic) | I want to summarize this epic. | GitLab, VS Code, and Web IDE <sup>1</sup> | GitLab.com, self-managed, and GitLab Dedicated |
| [Ask about code](#ask-about-code) | I want to understand how this code works. | GitLab, VS Code, and Web IDE <sup>1</sup> | GitLab.com, self-managed, and GitLab Dedicated |
| [Ask about CI/CD](#ask-about-cicd) | I want to create a new CI/CD pipeline configuration. | GitLab, VS Code, and Web IDE <sup>1</sup> | GitLab.com, self-managed, and GitLab Dedicated |
| [Explain code in the IDE](#explain-code-in-the-ide) | I want to understand how this code works. | VS Code and Web IDE <sup>1</sup> | GitLab.com, self-managed, and GitLab Dedicated |
| [Refactor code in the IDE](#refactor-code-in-the-ide) | I want to refactor this code. | VS Code and Web IDE <sup>1</sup> | GitLab.com, self-managed, and GitLab Dedicated |
| [Write tests in the IDE](#write-tests-in-the-ide) | I want to write a test for this code. | VS Code and Web IDE <sup>1</sup> | GitLab.com, self-managed, and GitLab Dedicated |
**Footnotes:**
1. GitLab Duo Chat is not available in the Web IDE on self-managed.
| [Ask about GitLab](#ask-about-gitlab) | I want to know how to create an issue in GitLab. | GitLab, VS Code, and Web IDE | GitLab.com |
| [Ask about a specific issue](#ask-about-a-specific-issue) | I want to summarize this issue. | GitLab, VS Code, and Web IDE | GitLab.com, self-managed, and GitLab Dedicated |
| [Ask about a specific epic](#ask-about-a-specific-epic) | I want to summarize this epic. | GitLab, VS Code, and Web IDE | GitLab.com, self-managed, and GitLab Dedicated |
| [Ask about code](#ask-about-code) | I want to understand how this code works. | GitLab, VS Code, and Web IDE | GitLab.com, self-managed, and GitLab Dedicated |
| [Ask about CI/CD](#ask-about-cicd) | I want to create a new CI/CD pipeline configuration. | GitLab, VS Code, and Web IDE | GitLab.com, self-managed, and GitLab Dedicated |
| [Explain code in the IDE](#explain-code-in-the-ide) | I want to understand how this code works. | VS Code and Web IDE | GitLab.com, self-managed, and GitLab Dedicated |
| [Refactor code in the IDE](#refactor-code-in-the-ide) | I want to refactor this code. | VS Code and Web IDE | GitLab.com, self-managed, and GitLab Dedicated |
| [Write tests in the IDE](#write-tests-in-the-ide) | I want to write a test for this code. | VS Code and Web IDE | GitLab.com, self-managed, and GitLab Dedicated |
## Watch a demo and get tips
...
...
@@ -65,7 +67,7 @@ You can ask questions about how GitLab works. Things like:
NOTE:
This feature is not currently supported in self-managed instances.
See [this epic](https://gitlab.com/groups/gitlab-org/-/epics/11600) for more information.
For more information, see [issue 451215](https://gitlab.com/gitlab-org/gitlab/-/issues/451215).
### Ask about a specific issue
...
...
@@ -257,28 +259,37 @@ you must enable GitLab Duo Chat.
### For GitLab.com
To enable GitLab Duo Chat on GitLab.com:
For a limited time, GitLab Duo Chat is available for all GitLab.com users
who are members of at least one group with a Premium or Ultimate subscription.
- At least one group that you're a member of must
have the [Experiment and Beta features setting](group/manage.md#enable-experiment-and-beta-features) enabled.
- You must belong to a group that has a Premium or Ultimate subscription.
### For self-managed
You can ask questions only about resources that belong to groups where the experiment and beta features setting is enabled.
### For self-managed and GitLab Dedicated
To enable GitLab Duo Chat on a self-managed instance,
you must have the following prerequisites.
Prerequisites:
- You must have GitLab version 16.8 or later.
- You must have a Premium or Ultimate subscription that is [synchronized with GitLab](https://about.gitlab.com/pricing/licensing-faq/cloud-licensing/).
- You must have GitLab version 16.8 or later. You should use the latest GitLab version to benefit from the latest improvements to GitLab Duo Chat. The generally available version of GitLab Duo Chat in GitLab 16.11 has significant improvements in the quality of the answers.
- You must have a Premium or Ultimate subscription that is [synchronized with GitLab](https://about.gitlab.com/pricing/licensing-faq/cloud-licensing/). To make sure GitLab Duo Chat works immediately, administrators can
[manually synchronize your subscription](#manually-synchronize-your-subscription).
- Your firewalls and HTTP proxy servers must allow outbound connections
to `cloud.gitlab.com`. To use an HTTP proxy, both
`gitLab _workhorse` and `gitLab_rails` have the necessary
- All of the users in your instance have the latest version of their IDE extension.
- You must be an administrator.
To enable GitLab Duo Chat for your self-managed GitLab instance:
Then, depending on the version of GitLab you have, you can enable GitLab Duo Chat.
#### In GitLab 16.11 and later
In GitLab 16.11 and later, GitLab Duo Chat is generally available
and automatically enabled for all users who have a subscription to the Premium or Ultimate tier.
You do not need to do anything to enable GitLab Duo Chat if you have GitLab 16.11 or later.
#### In earlier GitLab versions
In GitLab 16.8, 16.9, and 16.10, GitLab Duo Chat is available in Beta. To enable GitLab Duo Chat for your self-managed GitLab instance, an administrator must enable Experiment and Beta features:
1. On the left sidebar, at the bottom, select **Admin Area**.
1. Select **Settings > General**.
...
...
@@ -288,18 +299,25 @@ To enable GitLab Duo Chat for your self-managed GitLab instance:
[manually synchronize your subscription](#manually-synchronize-your-subscription).
NOTE:
Usage of GitLab Duo Chat is governed by the [GitLab Testing Agreement](https://handbook.gitlab.com/handbook/legal/testing-agreement/).
Usage of GitLab Duo Chat Beta is governed by the [GitLab Testing Agreement](https://handbook.gitlab.com/handbook/legal/testing-agreement/).
Learn about [data usage when using GitLab Duo Chat](ai_features.md#data-usage).
#### Manually synchronize your subscription
You must[manually synchronize your subscription](../subscriptions/self_managed/index.md#manually-synchronize-your-subscription-details) if either:
You can[manually synchronize your subscription](../subscriptions/self_managed/index.md#manually-synchronize-your-subscription-details) if either:
- You have just purchased a subscription for the Premium or Ultimate tier and have upgraded to GitLab 16.8.
- You already have a subscription for the Premium or Ultimate tier and have upgraded to GitLab 16.8.
Without the manual synchronization, it might take up to 24 hours to activate GitLab Duo Chat on your instance.
### For GitLab Dedicated
In GitLab 16.11 and later, on GitLab Dedicated, GitLab Duo Chat is generally available and
automatically enabled.
In GitLab 16.8, 16.9, and 16.10, on GitLab Dedicated, GitLab Duo Chat is available in Beta.
## Use GitLab Duo Chat in the GitLab UI
1. In the upper-right corner, select **GitLab Duo Chat**. A drawer opens on the right side of your screen.
...
...
@@ -320,25 +338,20 @@ To delete all previous conversations:
## Use GitLab Duo Chat in the Web IDE
DETAILS:
**Tier:** Premium, Ultimate
**Status:** Experiment
> - Introduced in GitLab 16.6 as an [Experiment](../policy/experiment-beta-support.md#experiment)
> - Introduced in GitLab 16.6 as an [Experiment](../policy/experiment-beta-support.md#experiment).
> - Changed to Generally Available in GitLab 16.11.
To use GitLab Duo Chat in the Web IDE on GitLab:
1. Open the Web IDE:
1.On the left sidebar, select **Search or go to** and find your project.
1.In the GitLab UI, on the left sidebar, select **Search or go to** and find your project.
1. Select a file. Then in the upper right, select **Edit > Open in Web IDE**.
1. Then open Chat by using one of the following methods:
- On the left sidebar, select **GitLab Duo Chat**.
- In the file that you have open in the editor, select some code.
1. Right-click and select **GitLab Duo Chat**.
1. Select **Explain selected code** or **Generate Tests**.
- Use the keyboard shortcut: <kbd>ALT</kbd>+<kbd>d</kbd> (on Windows and Linux) or <kbd>Option</kbd>+<kbd>d</kbd> (on Mac)
1. In the message box, enter your question and press **Enter** or select **Send**.
If you have selected code in the editor, this selection is sent along with your question to the AI. This way you can ask questions about this code selection. For instance, `Could you simplify this?`.
...
...
@@ -346,13 +359,24 @@ If you have selected code in the editor, this selection is sent along with your
NOTE:
GitLab Duo Chat is not available in the Web IDE on self-managed.
## Use GitLab Duo Chat in VS Code
### Perform standard task in the IDE from the context menu or by using slash commands
DETAILS:
**Tier:** Premium, Ultimate
**Status:** Experiment
Get code explained, refactored, or generate tests for code.
1. In VS Code or in the Web IDE, select code in your editor.
1. In the **Chat** box, type one the following slash commands:
-[`/explain`](#explain-code-in-the-ide)
-[`/refactor`](#refactor-code-in-the-ide)
-[`/tests`](#write-tests-in-the-ide)
Alternatively, use the context menu to perform these tasks.
When you use a slash command, you can also add additional instructions, for example: `/tests using the Boost.Test framework`.
## Use GitLab Duo Chat in VS Code
> - Introduced in GitLab 16.6 as an [Experiment](../policy/experiment-beta-support.md#experiment).
> - Changed to Generally Available in GitLab 16.11.
To use GitLab Duo Chat in GitLab Workflow extension for VS Code:
...
...
@@ -404,15 +428,15 @@ If the button is not visible in the upper-right of the UI,
ensure GitLab Duo Chat [is enabled](#enable-gitlab-duo-chat).
The **GitLab Duo Chat** button is not displayed on personal projects,
as well as groups and projects with GitLab Duo features disabled.
as well as [groups and projects with GitLab Duo features disabled](ai_features.md#disable-gitlab-duo-features).
After you enable GitLab Duo Chat, it might take a few minutes for the
button to appear.
### `This feature is only allowed in groups or projects that enable this feature`
This error occurs when you ask about resources that do not have
GitLab Duo Chat [enabled](#enable-gitlab-duo-chat).
This error occurs when you ask about resources that do have
GitLab Duo [disabled](ai_features.md#disable-gitlab-duo-features).
If any of the settings are not enabled, information about resources
(like issues, epics, and merge requests) in the group or project
...
...
@@ -424,18 +448,3 @@ This error occurs when you ask GitLab Duo Chat about resources you don't have ac
or about resources that do not exist.
Try again, asking about resources you have access to.
### Reponses are unexpected
If you have are on GitLab.com and have access to GitLab Duo Chat responses you did not expect,
you might be part of a group that has the **Use Experiment and Beta features** setting enabled.
Review the list of your groups and verify which ones you have access to.
GitLab.com administrators can verify your access by running this snippet in the Rails console:
