Copilot Model Policy - Enterprise Controls [public preview] (#59482)

Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com>
Co-authored-by: Laura Coursen <lecoursen@github.com>
Co-authored-by: Melanie Yarbrough <11952755+myarb@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: 5 people

content/copilot/how-tos/administer-copilot/manage-for-enterprise/index.md

@@ -10,6 +10,7 @@ children:
   - /manage-enterprise-policies
   - /manage-agents
   - /manage-spark
+  - /manage-availability-of-default-models
   - /use-your-own-api-keys
   - /review-audit-logs
 redirect_from:

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-availability-of-default-models.md

@@ -0,0 +1,59 @@
+---
+title: Managing availability of default models
+shortTitle: Manage model availability
+intro: 'You can control which {% data variables.product.prodname_copilot_short %} models are available to specific organizations.'
+versions:
+  feature: copilot
+contentType: how-tos
+permissions: Enterprise owners
+product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}'
+allowTitleToDifferFromFilename: true
+---
+
+> [!NOTE]
+> Managing availability of default models for organizations is in public preview and subject to change.
+
+## About managing default model availability
+
+As an enterprise owner, you can manage which default {% data variables.product.prodname_copilot_short %} models are available to organizations within your enterprise. For each model, you can choose whether it is automatically enabled for all organizations or whether individual organizations can choose to enable it.
+
+## Choosing which models are available
+
+You can choose which default models from {% data variables.product.github %} are available to organizations in your enterprise.
+
+{% data reusables.enterprise-accounts.access-enterprise %}
+{% data reusables.enterprise-accounts.ai-controls-tab %}
+{% data reusables.enterprise-accounts.copilot-sidebar %}
+{% data reusables.enterprise-accounts.configure-allowed-models %}
+1. Above the list of models, click **Add models**.
+1. In the modal, select or deselect the checkboxes next to the models you want to make available or remove.
+1. Click **Save**.
+
+## Setting organization availability for a model
+
+You can control whether a model is automatically enabled for all organizations or whether organizations can choose to enable it themselves.
+
+{% data reusables.enterprise-accounts.access-enterprise %}
+{% data reusables.enterprise-accounts.ai-controls-tab %}
+{% data reusables.enterprise-accounts.copilot-sidebar %}
+{% data reusables.enterprise-accounts.configure-allowed-models %}
+1. In the "Default models" tab, next to a model, click the dropdown menu and select an availability option:
+   * **Enabled**: The model is enabled for all organizations in your enterprise.
+   * **Optional**: Organizations can choose whether to enable the model.
+
+## Creating targeted model rules
+
+Targeted model rules let you control exactly which models are available to specific organizations, giving you more granular control than the enterprise-wide availability settings.
+
+{% data reusables.enterprise-accounts.access-enterprise %}
+{% data reusables.enterprise-accounts.ai-controls-tab %}
+{% data reusables.enterprise-accounts.copilot-sidebar %}
+{% data reusables.enterprise-accounts.configure-allowed-models %}
+1. In the "Targeted model rules" section, click **Create access rule**.
+1. Next to "Target organizations", click **Add organizations**, then select the organizations you want the rule to apply to.
+1. Under "Allowed models", click **Add models**, then select the models you want to make available to the selected organizations and click **Save**.
+1. Click **Create rule**.
+
+## Further reading
+
+* [AUTOTITLE](/copilot/concepts/policies)

content/copilot/how-tos/administer-copilot/manage-for-organization/index.md

@@ -17,6 +17,7 @@ children:
   - /add-copilot-cloud-agent
   - /configure-runner-for-coding-agent
   - /prepare-for-custom-agents
+  - /manage-default-models
   - /review-activity
   - /use-your-own-api-keys
 contentType: how-tos

content/copilot/how-tos/administer-copilot/manage-for-organization/manage-default-models.md

@@ -0,0 +1,37 @@
+---
+title: Managing default models
+shortTitle: Manage default models
+intro: 'Configure which default {% data variables.product.prodname_copilot_short %} models are available to members of your organization.'
+permissions: Organization owners
+product: '{% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %}.'
+versions:
+  feature: copilot
+contentType: how-tos
+category:
+  - Manage Copilot for a team
+allowTitleToDifferFromFilename: true
+---
+
+> [!NOTE]
+> Managing default models at the organization level is in public preview and subject to change.
+
+## Which models can I configure?
+
+If your organization is part of an enterprise, the enterprise owner controls which {% data variables.product.prodname_copilot_short %} models are available and how they can be configured at the organization level.
+
+When viewing the model settings for your organization, you may see the following statuses:
+
+* **Enabled** or **Disabled** with a {% octicon "shield" aria-label="shield" %} icon: The enterprise owner has enforced this setting. You cannot change the availability of this model.
+* **Enabled**, **Disabled**, or **Unconfigured** in a dropdown menu: The enterprise owner has made this model optional. You can configure the availability for your organization.
+
+## Configuring model availability for your organization
+
+If the enterprise owner has set a model to **Optional**, you can enable or disable it for your organization.
+
+{% data reusables.profile.access_org %}
+{% data reusables.profile.org_settings %}
+1. In the sidebar, under "Code, planning, and automation", click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**.
+1. Click **Models**.
+1. Next to a model in the list, click the dropdown menu and select an option:
+   * **Enabled**: The model is available to members of your organization.
+   * **Disabled**: The model is not available to members of your organization.

content/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies.md

@@ -24,7 +24,7 @@ redirect_from:
   - /copilot/how-tos/administer/manage-for-organization/manage-policies
 shortTitle: Manage policies
 contentType: how-tos
-category: 
+category:
   - Manage Copilot for a team
 ---
 
@@ -70,6 +70,8 @@ If your organization has a {% data variables.copilot.copilot_business_short %} o
 
 ## Further reading
 
+* [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-default-models)
+* [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-availability-of-default-models)
 * [{% data variables.product.prodname_copilot %} Trust Center](https://copilot.github.trust.page)
 * [AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions)
 * [AUTOTITLE](/enterprise-cloud@latest/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise)

data/reusables/enterprise-accounts/configure-allowed-models.md

@@ -0,0 +1 @@
+1. Click **Configure allowed models**.

data/reusables/enterprise-accounts/copilot-sidebar.md

@@ -0,0 +1 @@
+1. In the sidebar, click {% octicon "copilot" aria-hidden="true" aria-label="copilot" %} **{% data variables.product.prodname_copilot_short %}**.