Skip to content

Commit 5e121d3

Browse files
[Improvement]: Update Context Passing with GitHub Copilot Extensions language (#53927)
Co-authored-by: Ben Ahmady <[email protected]>
1 parent 3ba9b01 commit 5e121d3

File tree

2 files changed

+11
-9
lines changed

2 files changed

+11
-9
lines changed

content/copilot/building-copilot-extensions/about-building-copilot-extensions.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -55,16 +55,18 @@ For more information about skillsets, see [AUTOTITLE](/copilot/building-copilot-
5555

5656
{% data reusables.copilot.copilot-extensions.context-passing-public-preview-note %}
5757

58-
You can allow your {% data variables.product.prodname_copilot_extension_short %} to receive context from the editor, such as the currently opened file, by enabling the **Read-only** access level for the "{% data variables.product.prodname_copilot_short %} Editor Context" permission in your {% data variables.product.prodname_github_app %} settings. See [AUTOTITLE](/copilot/building-copilot-extensions/creating-a-copilot-extension/creating-a-github-app-for-your-copilot-extension#creating-a-github-app).
58+
You can allow your {% data variables.product.prodname_copilot_extension_short %} to receive context from the editor, such as the currently opened file, by enabling the **Read-only** access level for the "{% data variables.product.prodname_copilot_short %} Editor Context" permission in your {% data variables.product.prodname_github_app %} settings. See step 10 of [Configuring your {% data variables.product.prodname_github_app %}](/copilot/building-copilot-extensions/creating-a-copilot-extension/configuring-your-github-app-for-your-copilot-extension#configuring-your-github-app).
5959

60-
The {% data variables.product.prodname_copilot_extensibility_platform %} automatically handles messaging when implicit and explicit context is unavailable or unauthorized. To enable context passing, you are required to request permissions from users. When requesting permissions, follow these best practices:
60+
The {% data variables.product.prodname_copilot_extensibility_platform %} automatically handles messaging when implicit and explicit context is unavailable or unauthorized. To enable context passing, you are required to request permissions from users. To enable context passing, you are required to:
6161

62-
* Clearly communicate what context you need and what you need it for.
63-
* Implement appropriate error handling for unavailable context that your own application logic and API calls.
64-
* In the event context is unavailable, provide value where possible without this data.
65-
* Request only the minimum required permissions for your extension.
62+
* Update your APIs to handle new reference types.
63+
* Request permissions from users. When requesting permissions, follow these best practices:
64+
* Clearly communicate what context you need and what you need it for.
65+
* Implement appropriate error handling for unavailable context that your own application logic and API calls.
66+
* If context is unavailable, provide value where possible without this data.
67+
* Request only the minimum required permissions for your extension.
6668

67-
Context passing respects content exclusions, `.env` files, and files listed in the content exclusion settings.
69+
Context passing respects content exclusions, which refers to any files listed in your context exclusion settings, including files that begin with `.`.
6870

6971
### Resources for building {% data variables.product.prodname_copilot_extensions %}
7072

content/copilot/using-github-copilot/using-extensions-to-integrate-external-tools-with-copilot-chat.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ You can interact with your custom-built or installed extension in a {% data vari
4646

4747
{% data variables.product.prodname_copilot_extensions %} can access certain contextual information depending on where you're using them. This context passing happens automatically when you interact with an extension, but requires your explicit authorization through {% data variables.product.prodname_github_app %} permissions for use in any organization-owned repositories.
4848

49-
Context passing helps extensions understand your current work environment to provide more relevant assistance, while maintaining security through permission controls. Context passing also respects content exclusions, `.env` files, and files listed in your content exclusion settings.
49+
Context passing helps extensions understand your current work environment to provide more relevant assistance, while maintaining security through permission controls. Context passing respects content exclusions, which refers to any files listed in your context exclusion settings, including files that begin with `.`.
5050

5151
The following table shows the contexts that are passed to {% data variables.product.prodname_copilot_extensions %} based on the client or IDE you are using.
5252

@@ -58,7 +58,7 @@ The following table shows the contexts that are passed to {% data variables.prod
5858
| {% data variables.product.prodname_vs %} | Yes | Yes | Yes | No | Repository owner and branch |
5959
| {% data variables.product.prodname_dotcom_the_website %} | No | No | Yes | Yes | Repository information and other {% data variables.product.github %} resources |
6060
| {% data variables.product.prodname_mobile %} | No | No | No | Yes | Not applicable |
61-
| JetBrains IDEs | No | No | No | Yes | Not applicable |
61+
| JetBrains IDEs | No | No | No | No | Not applicable |
6262

6363
{% endrowheaders %}
6464

0 commit comments

Comments
 (0)