Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 10 additions & 11 deletions content/copilot/how-tos/chat-with-copilot/chat-in-github.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ You can open {% data variables.copilot.copilot_chat_short %} from any page on {%

Depending on the question you ask, and your enterprise and organization settings, {% data variables.product.prodname_copilot_short %} may respond using information based on the results of a Bing search. By using Bing search, {% data variables.product.prodname_copilot_short %} can answer a broad range of tech-related questions with up-to-date details based on information currently available on the internet. For information on how to enable or disable Bing search integration, see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber#enabling-or-disabling-web-search-for-github-copilot-chat) and [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise).

{% data reusables.copilot.immersive-mode-instructions %}
{% data reusables.copilot.access-chat-instructions %}
1. In the prompt box, type a question and press <kbd>Enter</kbd>.

Some examples of general questions you could ask are:
Expand All @@ -61,11 +61,11 @@ Depending on the question you ask, and your enterprise and organization settings
> [!NOTE]
> This feature is currently in {% data variables.release-phases.public_preview %} and subject to change.

When you ask a question, {% data variables.product.prodname_copilot_short %} may generate one or more files as part of its response. In the {% data variables.copilot.copilot_chat_short %} panel, the files are displayed inline, within the chat response. In immersive view (that is, at [https://github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text)), the generated files are displayed in a side panel. You can view and edit the files in the panel, or download them to your computer.
When you ask a question, {% data variables.product.prodname_copilot_short %} may generate one or more files as part of its response. The generated files are displayed in a side panel. You can view and edit the files in the panel, or download them to your computer.

For example, asking {% prompt %}Generate a simple calculator using HTML, CSS, and JavaScript{% endprompt %} may generate multiple files, such as `index.html`, `styles.css`, and `script.js`.

In immersive view, you can also preview how some file formats, such as Markdown, render by toggling to the "Preview" tab in the side panel.
You can also preview how some file formats, such as Markdown, render by toggling to the "Preview" tab in the side panel.

### Regenerating a response with a different model

Expand All @@ -79,9 +79,9 @@ For help deciding which model to use, see [AUTOTITLE](/copilot/reference/ai-mode

Subthreads are branches of a conversation that are created from a point in a conversation where you asked a question. Subthreads offer more control and flexibility for exploring aspects of a topic, or new topics, all within the same thread.

You can create and navigate through subthreads in {% data variables.copilot.copilot_chat_short %}'s immersive view. In the {% data variables.copilot.copilot_chat_short %} panel, if you open a conversation that contains subthreads, only the most recently edited subthread is displayed.
You can create and navigate through subthreads in {% data variables.copilot.copilot_chat_short %}.

You can create a subthread in immersive mode by either editing or retrying any of your questions in the conversation.
You can create a subthread in {% data variables.copilot.copilot_chat_short %} by either editing or retrying any of your questions in the conversation.

To edit a question:

Expand Down Expand Up @@ -136,15 +136,14 @@ You can ask {% data variables.copilot.copilot_chat_short %} different types of q

> [!NOTE]
> * Attaching images to chat prompts is currently in {% data variables.release-phases.public_preview %} and is subject to change.
> * You can only attach an image in the immersive view of {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot)), not in the chat panel.

You can attach an image to {% data variables.product.prodname_copilot_short %} and then ask about the image. For example, you can attach:

{% data reusables.copilot.image-questions-and-file-types %}

### Attaching an image to your chat prompt

1. Go to the immersive view of {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text).
1. Go to {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text)).
1. If you see the AI model picker at the top of the page, select one of the models that supports adding images to prompts:

![Screenshot of the model picker with the list of models expanded.](/assets/images/help/copilot/model-picker-copilot-immersive.png)
Expand Down Expand Up @@ -181,14 +180,14 @@ You can ask {% data variables.product.prodname_copilot_short %} a question about

## Accessing {% data variables.copilot.copilot_chat_short %} from the dashboard

You can access {% data variables.product.prodname_copilot_short %}'s immersive view from the dashboard. The dashboard is your personalized overview of your activity on {% data variables.product.github %}, seen when you visit https://github.com while logged in.
You can access {% data variables.copilot.copilot_chat_short %} from the dashboard. The dashboard is your personalized overview of your activity on {% data variables.product.github %}, seen when you visit https://github.com while logged in.

1. Go to the dashboard at [https://github.com](https://github.com).
1. In the prompt box, type a question and press <kbd>Enter</kbd>.

![Screenshot of the dashboard with the Copilot Chat prompt box.](/assets/images/help/copilot/copilot-chat-dashboard.png)

You will be taken to the immersive view where {% data variables.product.prodname_copilot_short %} responds to your request.
You will be taken to {% data variables.copilot.copilot_chat_short %} where {% data variables.product.prodname_copilot_short %} responds to your request.

> [!NOTE]
> If you don't see the {% data variables.copilot.copilot_chat_short %} prompt box on your dashboard, check that **Dashboard entry point** in enabled in your {% data variables.product.prodname_copilot %} settings.
Expand All @@ -197,11 +196,11 @@ You can access {% data variables.product.prodname_copilot_short %}'s immersive v

> [!NOTE] This feature is currently in {% data variables.release-phases.public_preview %} and subject to change. During the {% data variables.release-phases.public_preview %}, this feature is only available to users without enterprise or team memberships.

You can share {% data variables.copilot.copilot_chat_short %} conversations from the immersive view ([https://github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text)). Shared conversations are public or private (i.e. permission-based), depending on the referenced content, for example, a conversation about a private repository. If you share a private conversation, the recipient must have the necessary permissions to view the content.
Shared conversations are public or private (i.e. permission-based), depending on the referenced content, for example, a conversation about a private repository. If you share a private conversation, the recipient must have the necessary permissions to view the content.

Once you share a conversation, the conversation and future messages will be visible to anyone with the link.

{% data reusables.copilot.immersive-mode-instructions %}
{% data reusables.copilot.access-chat-instructions %}
1. After you submit your first prompt, a share button is displayed in the upper right corner.
1. Click **{% octicon "lock" aria-hidden="true" aria-label="lock" %} Share** to open the share dialog.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ You can add custom instructions for {% data variables.copilot.copilot_chat %} in
## Adding personal custom instructions

You can add personal custom instructions in {% data variables.copilot.copilot_chat_short %}'s immersive view.
You can add personal custom instructions in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %}.

1. Open [{% data variables.copilot.copilot_chat_short %}](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text).
1. In the bottom left corner, click your profile picture, then click **{% octicon "note" aria-hidden="true" aria-label="note" %} Personal instructions**.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ This version of this article is for using repository custom instructions in Ecli

{% visualstudio %}

* The **Enable custom instructions...** option must be enabled in your settings. This is enabled by default. See [Enabling or disabling repository custom instructions](#enabling-or-disabling-repository-custom-instructions-2) later in this article.
* The **Enable custom instructions...** option must be enabled in your settings. This is enabled by default. See [Enabling or disabling repository custom instructions](#enabling-or-disabling-repository-custom-instructions-1) later in this article.

{% endvisualstudio %}

Expand Down Expand Up @@ -443,7 +443,7 @@ The instructions in the file(s) are available for use by {% data variables.produ

{% webui %}

In {% data variables.copilot.copilot_chat_short %}'s immersive view ([github.com/copilot](https://github.com/copilot)), you can start a conversation that uses repository custom instructions by adding, as an attachment, the repository that contains the instructions file.
In {% data variables.copilot.copilot_chat_short %} ([github.com/copilot](https://github.com/copilot)), you can start a conversation that uses repository custom instructions by adding, as an attachment, the repository that contains the instructions file.

Whenever repository custom instructions are used by {% data variables.copilot.copilot_chat_short %}, the instructions file is added as a reference for the response that's generated. To find out whether repository custom instructions were used, expand the list of references at the top of a chat response in the Chat panel and check whether the `.github/copilot-instructions.md` file is listed.

Expand Down Expand Up @@ -491,20 +491,14 @@ You can click the reference to open the file.

{% webui %}

{% data reusables.copilot.custom-instructions-enabling %}

1. On {% data variables.product.prodname_dotcom_the_website %}, do one of the following:
* Go to a repository with a custom instructions file and open the assistive chat panel.
* Go to the immersive view of {% data variables.copilot.copilot_chat_short %} ([github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text)) and attach a repository that contains a custom instructions file.
1. Click the {% octicon "kebab-horizontal" aria-label="Conversation options" %} button at the top of the Chat panel, or the top right of the immersive page.
1. Click **Disable custom instructions** or **Enable custom instructions**.
## Enabling or disabling custom instructions for {% data variables.copilot.copilot_code-review_short %}

> [!NOTE]
> You will only see these options in the context of a repository that contains a custom instructions file.
Custom instructions are enabled for {% data variables.copilot.copilot_code-review_short %} by default but you can disable, or re-enable, them in the repository settings on {% data variables.product.prodname_dotcom_the_website %}. This applies to {% data variables.product.prodname_copilot_short %}'s use of custom instructions for all code reviews it performs in this repository.

Your choice persists, for all repositories containing a custom instructions file, until you change it.

{% data reusables.copilot.custom-instructions-enabling-for-ccr %}
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.sidebar-settings %}
1. In the "Code & automation" section of the sidebar, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**, then **Code review**.
1. Toggle the “Use custom instructions when reviewing pull requests” option on or off.

## Further reading

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,8 +65,8 @@ You can also chat with {% data variables.product.prodname_copilot_short %} in {%
To use {% data variables.copilot.copilot_free_short %} in other IDEs, you'll need to activate it from your {% data variables.product.github %} account settings first.

{% data reusables.user-settings.copilot-settings %}
1. Click **Start using {% data variables.copilot.copilot_free_short %}** to activate {% data variables.copilot.copilot_free_short %} and open immersive mode.
1. To the right of "Install {% data variables.product.prodname_copilot_short %} in your favorite code editor", select the {% octicon "triangle-down" aria-label="More edit options" %} dropdown menu and click your preferred editor.
1. Click **Start using {% data variables.copilot.copilot_free_short %}** to activate {% data variables.copilot.copilot_free_short %} and open [https://github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text&ref_plan=free).
1. In the top right corner, next to **Download**, select the {% octicon "triangle-down" aria-label="More edit options" %} dropdown menu and click your preferred editor.

## Upgrading from {% data variables.copilot.copilot_free_short %}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ When you enter a query, {% data variables.product.prodname_copilot_short %} sear

## Asking {% data variables.copilot.copilot_chat_short %} questions about a knowledge base

{% data reusables.copilot.immersive-mode-instructions %}
{% data reusables.copilot.access-chat-instructions %}
1. To select a knowledge base for context, click **{% octicon "paperclip" aria-label="Add attachments" %} Attach** at the bottom of the chat panel, then click **Knowledge bases**.
1. In the "Select knowledge bases" dialog, type the name of the knowledge base you want to use as context, select the knowledge bases you want to use, and click **Save**.
1. In the prompt box, type a question and press <kbd>Enter</kbd>.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ Within {% data variables.copilot.copilot_chat_dotcom_short %}, the {% data varia

The {% data variables.product.github %} MCP server is automatically configured in {% data variables.copilot.copilot_chat_dotcom_short %}. You can start using it immediately without any additional setup.

{% data reusables.copilot.immersive-mode-instructions %}
{% data reusables.copilot.access-chat-instructions %}
1. In the prompt box, type a request related to the skill you want {% data variables.copilot.copilot_chat_short %} to perform, and press **Enter**.

Some examples of requests you can make are:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ If you experience authentication issues when you try to use {% data variables.co

If a chat response terminates unexpectedly, before the response is complete, try resubmitting the question.

In {% data variables.copilot.copilot_chat_short %}'s immersive view (the [github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text), you can resubmit your question by clicking the {% octicon "sync" aria-label="Retry" %} button under the chat response.
In {% data variables.copilot.copilot_chat_short %} ([github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text)), you can resubmit your question by clicking the {% octicon "sync" aria-label="Retry" %} button under the chat response.

## Further reading

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,6 @@ Changing the model used by {% data variables.copilot.copilot_chat_short %} does

{% webui %}

> [!NOTE]
> You can only use an alternative AI model in the immersive view of {% data variables.copilot.copilot_chat_short %} on {% data variables.product.prodname_dotcom_the_website %}. This is the full-page version of {% data variables.copilot.copilot_chat_short %} that's displayed at [https://github.com/copilot](https://github.com/copilot). The {% data variables.copilot.copilot_chat_short %} panel always uses the default model.

### Limitations of AI models for {% data variables.copilot.copilot_chat_short %}

Experimental pre-release versions of the models may not interact with all filters correctly, including the setting to block suggestions matching public code (see [AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-your-copilot-plan/managing-copilot-policies-as-an-individual-subscriber#enabling-or-disabling-suggestions-matching-public-code)).
Expand All @@ -48,7 +45,7 @@ These instructions are for {% data variables.product.prodname_copilot_short %} o

![Screenshot of the 'Copilot' button, highlighted with a dark orange outline.](/assets/images/help/copilot/copilot-icon-top-right.png)

1. At the bottom of the immersive view, select the **CURRENT-MODEL** {% octicon "chevron-down" aria-hidden="true" aria-label="chevron-down" %} dropdown menu, then click the AI model of your choice.
1. At the bottom of {% data variables.copilot.copilot_chat_short %}, select the **CURRENT-MODEL** {% octicon "chevron-down" aria-hidden="true" aria-label="chevron-down" %} dropdown menu, then click the AI model of your choice.

1. Optionally, after submitting a prompt, you can regenerate the same prompt using a different model by clicking the retry icon ({% octicon "sync" aria-label="The re-run icon" %}) below the response. The new response will use your selected model and maintain the full context of the conversation.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ If you have a {% data variables.copilot.copilot_free_short %}, {% data variables

You can enable access in two ways:

* The first time you use a model with {% data variables.copilot.copilot_chat_short %} in your editor or in the immersive view of {% data variables.copilot.copilot_chat_short %}, you will be prompted to allow access to the model.
* The first time you use a model with {% data variables.copilot.copilot_chat_short %} in your editor or in {% data variables.product.github %}, you will be prompted to allow access to the model.

Click **Allow** to enable the AI model and update the policy in your personal settings on {% data variables.product.github %}.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,9 +28,9 @@ You stay in control of the process. You can review and refine what {% data varia

## Creating an issue with {% data variables.product.prodname_copilot_short %}

You can create issues from {% data variables.copilot.copilot_chat_short %}'s immersive view.
You can create issues from {% data variables.copilot.copilot_chat_short %} in {% data variables.product.github %}.

1. Go to the immersive view of {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text).
1. Go to {% data variables.copilot.copilot_chat_short %} ([https://github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=engagement&ref_style=text).
1. In the prompt box, describe the issue you want to create.

If you contribute issues to multiple repositories, use the `repo-owner/repo-name` format to specify the target repository for this issue. If you don't specify a repository, {% data variables.product.prodname_copilot_short %} will infer the repository based on the repository you last created an issue in.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ These instructions will change how {% data variables.product.prodname_copilot %}

## Test it out

To quickly test out the difference that custom instructions can make, you can use personal custom instructions in {% data variables.copilot.copilot_chat_short %}'s immersive view.
To quickly test out the difference that custom instructions can make, you can use personal custom instructions in {% data variables.copilot.copilot_chat_short %}.

1. First, go to [github.com/copilot](https://github.com/copilot?ref_product=copilot&ref_type=trial&ref_style=text) and enter this prompt:

Expand Down
Loading