Skip to content

Commit 4e3bfac

Browse files
Restructure "Creating a github-private repo" vs "Prepare for custom agents" articles (#62337)
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
1 parent ce233b2 commit 4e3bfac

2 files changed

Lines changed: 26 additions & 9 deletions

File tree

‎content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/create-github-private-repo.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,10 @@ You can create a `.github-private` repository using a template or from scratch.
3838

3939
The "Configuration summary" on the settings page will display the settings taken from this repository.
4040

41+
## Protecting your governance repository
42+
43+
To control who can propose and merge changes to the governance settings stored here, you can create a repository ruleset that targets the branches and files in your `.github-private` repository. See [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository).
44+
4145
## Next steps
4246
* [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents)
4347
* [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-managed-settings)

‎content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md‎

Lines changed: 22 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,22 +11,35 @@ category:
1111
- Manage Copilot for a team
1212
---
1313

14-
Enterprise-level {% data variables.copilot.custom_agents_short %} are defined in a specific repository within an organization in your enterprise.
14+
Enterprise-level {% data variables.copilot.custom_agents_short %} are defined in a `.github-private` repository within an organization in your enterprise. Preparing your enterprise involves creating that repository, configuring it as your source of governance, protecting your agent files, and deciding who can manage {% data variables.copilot.custom_agents_short %}.
1515

16-
Before you can create and use {% data variables.copilot.custom_agents_short %}, you need to create this repository and configure the relevant enterprise settings.
16+
Work through the following steps to set up your enterprise.
1717

18-
## Creating a repository for your enterprise governance
18+
## Set up your governance repository
1919

20-
1. Create a `.github-private` repository for your enterprise governance. If you don't already have a `.github-private` repo, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/create-github-private-repo).
20+
1. **Create a `.github-private` repository** to house your enterprise's {% data variables.copilot.agent_profiles %}, client permissions, and plugin settings.
21+
1. **Select the repository as your source of governance** so that your enterprise reads its settings from the repository.
2122

22-
1. To automatically configure a ruleset that allows only enterprise owners to edit {% data variables.copilot.agent_profiles %}, in the "Protect agent files using rulesets" section, click **Create ruleset**.
23+
For both steps, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/create-github-private-repo).
2324

24-
> [!NOTE]
25-
> * Members of your enterprise with write access to the {% data variables.copilot.copilot_custom_agent_short %} repository can still create pull requests proposing changes to your {% data variables.copilot.agent_profiles %}. Enterprise members with bypass access to the ruleset can then merge those pull requests as they see fit.
26-
> * Creating this ruleset will also block organization owners in your enterprise from creating or editing organization-level {% data variables.copilot.custom_agents_short %}. To prevent this, you can edit the ruleset to target only the organization containing your enterprise-level {% data variables.copilot.custom_agents_short %}.
25+
## Protecting your agent files using rulesets
2726

28-
## Next steps
27+
To automatically configure a ruleset that allows only enterprise owners to edit {% data variables.copilot.agent_profiles %} across your enterprise:
28+
29+
{% data reusables.enterprise-accounts.access-enterprise %}
30+
{% data reusables.enterprise-accounts.ai-controls-tab %}
31+
1. On the "Agents" tab, in the "Protect agent files using rulesets" section, click **Create ruleset**.
32+
33+
> [!NOTE]
34+
> * Members of your enterprise with write access to the {% data variables.copilot.copilot_custom_agent_short %} repository can still create pull requests proposing changes to your {% data variables.copilot.agent_profiles %}. Enterprise members with bypass access to the ruleset can then merge those pull requests as they see fit.
35+
> * Creating this ruleset will also block organization owners in your enterprise from creating or editing organization-level {% data variables.copilot.custom_agents_short %}. To prevent this, you can edit the ruleset to target only the organization containing your enterprise-level {% data variables.copilot.custom_agents_short %}.
36+
37+
## Decide who manages your custom agents
2938

3039
To reduce your administrative burden and empower your SMEs, you can delegate the creation and management of {% data variables.copilot.custom_agents_short %} in your enterprise by creating a team of AI managers. See [AUTOTITLE](/copilot/tutorials/roll-out-at-scale/govern-at-scale/establish-ai-managers).
3140

3241
If you prefer to maintain full control over your enterprise's tooling to ensure security and compliance, you can create and manage {% data variables.copilot.custom_agents_short %} yourself. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/test-custom-agents).
42+
43+
## Next steps
44+
45+
To centrally control {% data variables.product.prodname_copilot_short %} client behavior across your enterprise, configure enterprise managed settings. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-managed-settings).

0 commit comments

Comments
 (0)