From d3ede7563b4fc093f718f991d85708401d1547bd Mon Sep 17 00:00:00 2001 From: Roman Nikitenko Date: Tue, 12 May 2026 16:14:06 +0300 Subject: [PATCH] procedures: Document GitHub Copilot Chat usage Signed-off-by: Roman Nikitenko Assisted-by: Cursor AI --- modules/end-user-guide/nav.adoc | 1 + ...ft-visual-studio-code-open-source-ide.adoc | 2 + .../pages/using-github-copilot-chat.adoc | 81 +++++++++++++++++++ 3 files changed, 84 insertions(+) create mode 100644 modules/end-user-guide/pages/using-github-copilot-chat.adoc diff --git a/modules/end-user-guide/nav.adoc b/modules/end-user-guide/nav.adoc index 18c9c36cf4..5788bc03d7 100644 --- a/modules/end-user-guide/nav.adoc +++ b/modules/end-user-guide/nav.adoc @@ -34,6 +34,7 @@ * xref:devfile-introduction.adoc[] * xref:ides-in-workspaces.adoc[] ** xref:microsoft-visual-studio-code-open-source-ide.adoc[] +** xref:using-github-copilot-chat.adoc[] ** xref:connect-visual-studio-code-to-che-workspace.adoc[] ** xref:defining-a-common-ide.adoc[] * xref:using-credentials-and-configurations-in-workspaces.adoc[] diff --git a/modules/end-user-guide/pages/microsoft-visual-studio-code-open-source-ide.adoc b/modules/end-user-guide/pages/microsoft-visual-studio-code-open-source-ide.adoc index 046b3d954c..eed02b9370 100644 --- a/modules/end-user-guide/pages/microsoft-visual-studio-code-open-source-ide.adoc +++ b/modules/end-user-guide/pages/microsoft-visual-studio-code-open-source-ide.adoc @@ -32,6 +32,8 @@ You can automate installation of Microsoft Visual Studio Code extensions from th Configure IDE preferences on a per-workspace basis by invoking the link:https://code.visualstudio.com/api/ux-guidelines/command-palette[Command Palette] and selecting *Preferences: Open Workspace Settings*. ==== +TIP: To use GitHub Copilot Chat in your workspace, see xref:using-github-copilot-chat.adoc[]. + NOTE: You might see your organization's branding in this IDE if your organization customized it through a branded build. include::partial$proc_automating-installation-of-microsoft-visual-studio-code-extensions-at-workspace-startup.adoc[leveloffset=+1] diff --git a/modules/end-user-guide/pages/using-github-copilot-chat.adoc b/modules/end-user-guide/pages/using-github-copilot-chat.adoc new file mode 100644 index 0000000000..f11db9939f --- /dev/null +++ b/modules/end-user-guide/pages/using-github-copilot-chat.adoc @@ -0,0 +1,81 @@ +:_content-type: PROCEDURE +:description: Using GitHub Copilot Chat in a Che workspace +:keywords: copilot, github-copilot, copilot-chat, ai, extensions +:navtitle: Using GitHub Copilot Chat + +[id="using-github-copilot-chat"] += Using GitHub Copilot Chat + +You can use link:https://github.com/features/copilot[GitHub Copilot Chat] in a {prod-short} workspace with the Code - OSS editor by installing the link:https://open-vsx.org/extension/redhat/devspaces-copilot-chat-integration/0.36.2[Dev Spaces Copilot Chat Integration] extension (version 0.36.2) and authenticating with your GitHub account. + +.Prerequisites + +* A GitHub account with an active link:https://github.com/features/copilot[GitHub Copilot] subscription. +* A running {prod-short} workspace with the Code - OSS editor. + +.Procedure + +. Install version 0.36.2 of the *Dev Spaces Copilot Chat Integration* extension. ++ +Choose one of the following options depending on your Open VSX registry configuration: ++ +-- +* If your {prod-short} instance is configured to use the link:https://open-vsx.org[public Open VSX registry] or a standalone Open VSX registry that contains the extension: ++ +Open the Extensions view by pressing kbd:[Ctrl+Shift+X], search for `Dev Spaces Copilot Chat Integration`, select version *0.36.2*, and click *Install*. + +* If your {prod-short} instance uses the default embedded Open VSX registry or a registry that does not contain the extension, install it manually from a `.vsix` file: ++ +Download the `.vsix` file from the link:https://open-vsx.org/extension/redhat/devspaces-copilot-chat-integration/0.36.2[Open VSX registry], then press kbd:[F1] to open the Command Palette and run `Extensions: Install from VSIX...`. +-- ++ +[IMPORTANT] +==== +Use version 0.36.2 of the extension. Other versions may not be compatible with the current {prod-short} editor. +==== + +. Authenticate using Device Authentication. ++ +Press kbd:[F1] to open the Command Palette, type `GitHub: Device Authentication`, and select the command. ++ +[IMPORTANT] +==== +You must complete Device Authentication *before* attempting to use AI features. Initiating "Sign in to use AI Features" without a valid device authentication token causes authentication errors that require signing out and re-authenticating. +==== + +. Complete the device authentication flow. ++ +A notification appears with a device code. Click the link to open the GitHub device activation page in your browser, paste the code, and authorize access. + +. Refresh the browser page. ++ +After successful authentication, a notification prompts you to refresh the browser page. Refresh the page to apply the authentication token. Copilot Chat is authenticated automatically and ready to use. + +.Verification + +* The Copilot Chat panel opens and responds to prompts. + +[NOTE] +==== +Device Authentication is a one-time step. The credentials are saved as a Kubernetes object and persist across workspaces on the same cluster. +==== + +.Troubleshooting + +If you attempted to use Copilot Chat before completing Device Authentication, the extension may enter an error state. Typical symptoms include: + +* Copilot Chat appears to be connected but does not respond to prompts. +* The Copilot Chat output log contains errors such as: ++ +---- +Failed to get copilot token. reason: NotAuthorized +GitHub Copilot could not connect to server. Extension activation failed: "Failed to get copilot token. reason: NotAuthorized" +---- + +This happens when *Sign in to use AI Features* is triggered before a valid Device Authentication token exists. + +To recover: + +. Click the *Accounts* icon on the left activity bar, select your account, and click *Sign Out*. A confirmation dialog appears indicating the account has been used by the Dev Spaces Copilot Chat Integration. Click *Sign Out* to confirm. +. Press kbd:[F1] to open the Command Palette and run `GitHub: Device Authentication`. Complete the device authentication flow in the browser. +. Refresh the browser page when prompted. Copilot Chat is now ready to use.