Skip to content

Commit 38f49a1

Browse files
hubwriterjc-clark
andauthored
Enterprise-level content exclusion for Copilot (#52496)
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
1 parent 0751848 commit 38f49a1

File tree

7 files changed

+61
-12
lines changed

7 files changed

+61
-12
lines changed

content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-changes-to-content-exclusions-for-github-copilot.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,4 +43,30 @@ redirect_from:
4343

4444
The "Audit log" page for the organization is displayed, showing the most recently logged occurrences of the `copilot.content_exclusion_changed` action.
4545

46+
Changes made at either the repository or organization level are listed.
47+
48+
{% data reusables.copilot.more-details-content-exclusion-logs %}
49+
50+
{% ifversion ghec%}
51+
52+
## Reviewing changes in your enterprise
53+
54+
{% data reusables.enterprise-accounts.access-enterprise %}
55+
{% data reusables.enterprise-accounts.policies-tab %}
56+
{% data reusables.enterprise-accounts.copilot-tab %}
57+
58+
1. On the {% data variables.product.prodname_copilot %} page, click the **Content exclusion** tab.
59+
60+
At the bottom of the page you'll see the name of the person who last changed the content exclusion settings, and information about when they made this change.
61+
62+
1. Click the time of the last change.
63+
64+
![Screenshot of the last edited information. The time of change link is highlighted with a dark orange outline.](/assets/images/help/copilot/content-exclusions-last-edited-by.png)
65+
66+
The "Audit log" page for the organization is displayed, showing the most recently logged occurrences of the `copilot.content_exclusion_changed` action.
67+
68+
Changes made at the repository, organization, and enterprise level are listed.
69+
4670
{% data reusables.copilot.more-details-content-exclusion-logs %}
71+
72+
{% endif %}

content/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/excluding-content-from-github-copilot.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Excluding content from GitHub Copilot
33
shortTitle: Exclude content from Copilot
44
intro: 'You can prevent {% data variables.product.prodname_copilot_short %} from accessing certain content.'
5-
permissions: '{% data reusables.copilot.content-exclusion-permissions %}'
5+
permissions: 'Repository administrators{% ifversion ghec%}, organization owners, and enterprise owners{% else %} and organization owners{% endif %} can manage content exclusion settings. People with the "Maintain" role for a repository can view, but not edit, content exclusion settings for that repository.'
66
product: '{% data reusables.gated-features.copilot-business-and-enterprise %}'
77
layout: inline
88
versions:
@@ -31,6 +31,10 @@ You can use content exclusions to configure {% data variables.product.prodname_c
3131
* The content in affected files will not inform code completion suggestions in other files.
3232
* The content in affected files will not inform {% data variables.product.prodname_copilot_chat %}'s responses.
3333

34+
### Who can configure content exclusion
35+
36+
Repository administrators{% ifversion ghec%}, organization owners, and enterprise owners{% else %} and organization owners{% endif %} can configure content exclusion.
37+
3438
{% data reusables.copilot.content-exclusions-scope %}
3539

3640
### Availability of content exclusions
@@ -171,6 +175,16 @@ git@gitlab.com:gitlab-org/gitlab-runner.git:
171175
- "**/security/**"
172176
```
173177
178+
{% ifversion ghec %}
179+
180+
## Configuring content exclusions for your enterprise
181+
182+
As an enterprise owner, you can use the enterprise settings to specify files that {% data variables.product.prodname_copilot %} should ignore. The files can be within a Git repository or anywhere on the file system that is not under Git control.
183+
184+
You apply rules in the same way as described in the previous section "[Configuring content exclusions for your organization](#configuring-content-exclusions-for-your-organization)" but from the settings for your enterprise. The key difference is that rules set at the enterprise level apply to all {% data variables.product.prodname_copilot_short %} users in the enterprise, whereas the rules set by organization owners only apply to users who are assigned a {% data variables.product.prodname_copilot_short %} seat by that organization.
185+
186+
{% endif %}
187+
174188
## Testing changes to content exclusions
175189
176190
You can use your IDE to confirm that your changes to content exclusions are working as expected.

content/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Managing policies for Copilot in your organization
33
intro: 'Learn how to manage policies for {% data variables.product.prodname_copilot %} in your organization.'
44
permissions: Organization owners
5-
product: '{% data reusables.gated-features.copilot-business-and-enterprise %}'
5+
product: 'Organizations with a subscription to {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}'
66
versions:
77
feature: copilot
88
redirect_from:

content/copilot/troubleshooting-github-copilot/troubleshooting-common-issues-with-github-copilot.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ When a file is affected by a content exclusion setting, {% data variables.produc
3333

3434
{% data reusables.copilot.content-exclusion-note %}
3535

36+
Content exclusion can be configured at the repository{% ifversion ghec%}, organization, and enterprise{% else %} and organization{% endif %} level. The scope of the exclusion is determined by the level at which the rule is set:
37+
3638
{% data reusables.copilot.content-exclusions-scope %}
3739

3840
{% data reusables.copilot.content-exclusions-delay %} For more information, see "[AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/testing-changes-to-content-exclusions-in-your-ide#propagating-content-exclusion-changes-to-your-ide)."

data/reusables/copilot/content-exclusion-permissions.md

Lines changed: 0 additions & 3 deletions
This file was deleted.
Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,21 @@
1-
{% ifversion fpt %}
1+
* **Repository administrators** can only exclude content for their own repositories. This affects {% data variables.product.prodname_copilot_short %} users working within those specific repositories.
2+
* **Organization owners** can exclude content for users assigned a {% data variables.product.prodname_copilot_short %} seat through their organization.
23

3-
Content exclusion settings only apply to members of the organization in which the content exclusion is configured, who have been granted a seat as part of a {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} subscription.
4+
{% ifversion ghec %}
45

5-
{% else %}
6+
<!-- expires 2024-11-08 -->
67

7-
You can only specify content exclusions in the settings for an organization or repository, not in the settings for an enterprise. Content exclusion settings defined in an organization or repository within an enterprise will apply to all members of the enterprise who have been granted a seat as part of a {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} subscription.
8+
> [!NOTE] In the current {% data variables.release-phases.public_preview %} release, organization-level settings for content exclusion typically apply to all {% data variables.product.prodname_copilot_short %} users in the enterprise. This will change with the general availability (GA) release of this feature on November 8th, 2024.
9+
>
10+
> **_Before November 8th:_**
11+
> * **If enterprise owners do not set rules**: Organization-level rules will continue to apply to all users across the enterprise, functioning as they do now, until November 8th.
12+
> * **If enterprise owners set a rule**: Once enterprise-level rules are applied, organization-level rules will only apply to users who are assigned a {% data variables.product.prodname_copilot_short %} seat from the organization where the rule is set.<br><br>
13+
>
14+
> **_After November 8th:_**
15+
> * Organization-level rules will no longer apply enterprise-wide. They will be limited to users who are assigned a {% data variables.product.prodname_copilot_short %} seat from the organization where the rule is set.
816
9-
{% endif %}
17+
<!-- end expires 2024-11-08 -->
18+
19+
* **Enterprise owners** can apply exclusion rules to all {% data variables.product.prodname_copilot_short %} users in the enterprise.
1020

11-
Anyone else who can access the specified files will still see code completion suggestions and {% data variables.product.prodname_copilot_chat %} responses referencing the specified files.
21+
{% endif %}
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Organizations with a subscription to {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}
1+
Organizations{% ifversion ghec%} and enterprises{% endif %} with a subscription to {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}.

0 commit comments

Comments
 (0)