docs/content/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents.md

title, intro, versions, topics, shortTitle, contentType

title	intro	versions	topics	shortTitle	contentType
Testing and releasing {% data variables.copilot.custom_agents_short %} in your organization or enterprise	Ensure your {% data variables.copilot.custom_agents_short %} are performant and compliant before releasing them to your company.	feature copilot	Copilot	Test custom agents	how-tos

{% data reusables.copilot.custom-agents-preview-note %}

Introduction

Before you release or update a {% data variables.copilot.copilot_custom_agent_short %} in your organization or enterprise, you can test the agent privately to ensure it meets your standards. Once you are satisfied, you can then easily change the location of your {% data variables.copilot.agent_profile %} to make it available across your company.

Prerequisites

Before you can test a {% data variables.copilot.copilot_custom_agent_short %}, you need to set up your organization or enterprise for {% data variables.copilot.custom_agents_short %}. See AUTOTITLE or AUTOTITLE.

1. Create your test {% data variables.copilot.copilot_custom_agent_short %}

1. In your organization or enterprise's .github-private repository, create a new directory called .github/agents. Agents stored in this directory are only available to members of your organization or enterprise who have access to the .github-private repository, and can only be used when they start a task within that repository.
2. In your .github/agents directory, create the {% data variables.copilot.agent_profile %} for your test agent. You can create a net-new profile or duplicate an existing profile to test potential updates. For information on configuring an {% data variables.copilot.agent_profile %}, see AUTOTITLE.
3. Merge your test {% data variables.copilot.agent_profile %} into the default branch of your repository.

2. Test your {% data variables.copilot.copilot_custom_agent_short %}

1. Navigate to the agents tab at https://github.com/copilot/agents.
2. Using the dropdown menu in the prompt box, select your .github-private repository.
3. Select {% octicon "copilot" aria-label="Select a custom agent" %}, then click your test agent.
4. To test your {% data variables.copilot.copilot_custom_agent_short %}, send {% data variables.product.prodname_copilot_short %} a prompt.
5. In the "Recent sessions" section, click your session to see detailed information about your results.
6. Continue making changes and testing your {% data variables.copilot.copilot_custom_agent_short %} as needed until you are satisfied with its performance.

3. Release your {% data variables.copilot.copilot_custom_agent_short %}

1. In your .github-private repository, move your {% data variables.copilot.agent_profile %} from the .github/agents directory into the agents directory.
2. Merge your changes into the default branch. Your {% data variables.copilot.copilot_custom_agent_short %} is now available to all users in your organization or enterprise.

Next steps

To monitor the usage of {% data variables.copilot.custom_agents_short %} in your organization, filter your organization's audit log by actor:Copilot. See AUTOTITLE.

To monitor the usage of {% data variables.copilot.custom_agents_short %} in your enterprise, see AUTOTITLE.