Skip to main content

Preparing to use custom agents in your enterprise

Set up your enterprise for custom agents by configuring their source organization and repository, availability, and management permissions.

¿Quién puede utilizar esta característica?

Enterprise owners

Nota:

The AI Controls view is in public preview and subject to change.

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. En la esquina superior derecha de GitHub, haz clic en la fotografía de perfil.

  2. En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.

  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.

    Nota:

    • 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.