{"meta":{"title":"Testing and releasing custom agents in your organization or enterprise","intro":"Ensure your custom agents are performant and compliant before releasing them to your company.","product":"GitHub Copilot","breadcrumbs":[{"href":"/en/copilot","title":"GitHub Copilot"},{"href":"/en/copilot/how-tos","title":"How-tos"},{"href":"/en/copilot/how-tos/copilot-on-github","title":"Copilot on GitHub"},{"href":"/en/copilot/how-tos/copilot-on-github/customize-copilot","title":"Customize Copilot"},{"href":"/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent","title":"Customize cloud agent"},{"href":"/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/test-custom-agents","title":"Test custom agents"}],"documentType":"article"},"body":"# Testing and releasing custom agents in your organization or enterprise\n\nEnsure your custom agents are performant and compliant before releasing them to your company.\n\n> \\[!NOTE]\n> Copilot custom agents are in public preview and subject to change.\n\n## Introduction\n\nBefore you release or update a custom agent 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 agent profile to make it available across your company.\n\n## Prerequisites\n\nBefore you can test a custom agent, you need to set up your organization or enterprise for custom agents. See [Preparing to use custom agents in your organization](/en/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents) or [Preparing to use custom agents in your enterprise](/en/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).\n\n## 1. Create your test custom agent\n\n1. 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.\n2. In your `.github/agents` directory, create the 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 agent profile, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents#configuring-an-agent-profile).\n3. Merge your test agent profile into the default branch of your repository.\n\n## 2. Test your custom agent\n\n1. Go to the agents tab at [https://github.com/copilot/agents](https://github.com/copilot/agents?ref_product=copilot\\&ref_type=engagement\\&ref_style=text).\n2. Using the dropdown menu in the prompt box, select your `.github-private` repository.\n3. Select , then click your test agent.\n4. To test your custom agent, send Copilot a prompt.\n5. In the \"Recent sessions\" section, click your session to see detailed information about your results.\n6. Continue making changes and testing your custom agent as needed until you are satisfied with its performance.\n\n## 3. Release your custom agent\n\n1. In your `.github-private` repository, move your agent profile from the `.github/agents` directory into the `agents` directory.\n2. Merge your changes into the default branch. Your custom agent is now available to all users in your organization or enterprise.\n\n## Next steps\n\nTo monitor the usage of custom agents in your organization, filter your organization's audit log by `actor:Copilot`. See [Reviewing the audit log for your organization](/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization).\n\nTo monitor the usage of custom agents in your enterprise, see [Monitoring agentic activity in your enterprise](/en/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity)."}