Preparing to use custom agents in your enterprise

Enterprise-level custom agents are defined in a specific repository within an organization in your enterprise. Before you can create and use custom agents, you need to create this repository and configure the relevant enterprise settings.

Creating a repository for your custom agents

1. Choose an organization in your enterprise to own the repository containing your enterprise-level custom agents.
2. Using the custom agents template repository, create a new private repository in your chosen organization named .github-private.
3. Update the template README as needed. Consider including creation guidelines for custom agents or compliance considerations specific to your enterprise.

Enabling and protecting custom agents in your enterprise

1. In the top-right corner of GitHub, click your profile picture.

2. Depending on your environment, click Enterprise, or click Enterprises then click the enterprise you want to view.

3. At the top of the page, click AI controls.

4. In the "Custom agents" section, select the Select organization dropdown menu, then click the organization that contains your custom agent repository.

5. To automatically configure a ruleset that allows only enterprise owners to edit agent profiles, in the "Protect agent files using rulesets" section, click Create ruleset.

   Note

   • Members of your enterprise with write access to the custom agent repository can still create pull requests proposing changes to your agent profiles. Enterprise members with bypass access to the ruleset can then merge those pull requests as they see fit.
   • Creating this ruleset will also block organization owners in your enterprise from creating or editing organization-level custom agents. To prevent this, you can edit the ruleset to target only the organization containing your enterprise-level custom agents.

Next steps

To implement custom agents in your enterprise, see Creating custom agents.