Skip to content

Commit a227287

Browse files
isaacmbrownCopilot
andauthored
Document model access for agent apps (#63011)
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
1 parent bacc017 commit a227287

4 files changed

Lines changed: 25 additions & 2 deletions

File tree

‎content/copilot/concepts/agents/agent-apps.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@ contentType: concepts
1717

1818
For example, an {% data variables.copilot.agent_app %} could analyze your product analytics, scan your application for security vulnerabilities, or add feature flags to a pull request, then connect back to the partner's systems to complete the task.
1919

20+
You can view available apps on [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&category=agent-apps).
21+
2022
## Where you can use {% data variables.copilot.agent_apps %}
2123

2224
{% data reusables.copilot.agent-apps-entrypoints %}
@@ -38,6 +40,8 @@ To use an {% data variables.copilot.agent_app %}, the {% data variables.product.
3840
* When you install an {% data variables.copilot.agent_app %}, {% data variables.product.github %} highlights that the app includes agent features and asks you if you want to enable them. For more information, see [AUTOTITLE](/apps/using-github-apps/about-using-github-apps).
3941
* If the app is installed in an organization owned by an enterprise, an administrator must also enable the "{% data variables.copilot.agent_apps %}" {% data variables.product.prodname_copilot_short %} policy before the agent features become available. For more information, see the "Next steps" section.
4042

43+
{% data reusables.copilot.model-access-agent-apps %} See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-availability-of-default-models).
44+
4145
## Billing
4246

4347
{% data reusables.copilot.agent-apps-billing %}

‎content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-availability-of-default-models.md‎

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,10 +29,12 @@ This sets a baseline that you can add to with more granular controls. For models
2929
{% data reusables.enterprise-accounts.configure-allowed-models %}
3030
1. Select a status for each model in the list:
3131

32-
* **Enabled** for everyone.
33-
* **Disabled** for everyone.
32+
* **Enabled** for every user and {% data variables.copilot.agent_app %}.
33+
* **Disabled** for every user and {% data variables.copilot.agent_app %}.
3434
* **Delegate** the decision to organizations or enterprise teams and apps.
3535

36+
{% data reusables.copilot.model-access-agent-apps %}
37+
3638
### Checking for unconfigured models
3739

3840
{% data reusables.copilot.model-autoenablement %}
@@ -96,6 +98,17 @@ To grant access to an enterprise team:
9698
1. Click the **Default models** tab.
9799
1. For each model that the team should receive access to beyond the enterprise baseline, set the dropdown to **Enabled**.
98100

101+
### Granting access to {% data variables.copilot.agent_apps %}
102+
103+
{% data reusables.copilot.agent-apps-intro %} See [AUTOTITLE](/copilot/concepts/agents/agent-apps).
104+
105+
Ensure models you want to enable specifically for apps are set to **Delegate to Enterprise Teams/Apps** in your enterprise's model policies.
106+
107+
{% data reusables.enterprise-accounts.ai-controls-tab %}
108+
{% data reusables.enterprise-accounts.copilot-sidebar %}
109+
1. Under **Models**, click **Configure app models**.
110+
1. For each available model you want to enable, change the dropdown from **Optional** to **Enabled**.
111+
99112
## Further reading
100113

101114
* [AUTOTITLE](/copilot/reference/supported-surfaces-for-policies)

‎content/copilot/how-tos/use-copilot-agents/cloud-agent/use-agent-apps.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,11 @@ category:
1818

1919
Before you can use an {% data variables.copilot.agent_app %}, the {% data variables.product.prodname_github_app %} must be installed on the account or organization that owns the repository, and agent features must be enabled for the app. If the repository is owned by an organization that belongs to an enterprise, the "{% data variables.copilot.agent_apps_caps %}" {% data variables.product.prodname_copilot_short %} policy must also be enabled in your enterprise settings.
2020

21+
## Installing an agent app
22+
23+
1. View available apps on [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?type=apps&category=agent-apps).
24+
1. On the app page, click **Add**, then install the app on your personal account or organization.
25+
2126
## Authorizing an agent app
2227

2328
The first time you use an {% data variables.copilot.agent_app %}, {% data variables.product.github %} prompts you to authorize the app through an OAuth flow. Follow the prompts to authorize the app before the agent runs. For more information, see [AUTOTITLE](/apps/using-github-apps/authorizing-github-apps).
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
By default, {% data variables.copilot.agent_apps %} have access to the models that are enabled in the organization or personal account where the app is installed. However, in the enterprise teams mode for model access, available models for {% data variables.copilot.agent_apps_short %} are controlled at the enterprise level.

0 commit comments

Comments
 (0)