Merge branch 'main' into docs/clarify-dependency-graph-enabled

Author: hesreallyhim

.github/workflows/changelog-agent.yml

@@ -417,7 +417,7 @@ jobs:
       - name: Generate changelog draft via Copilot
         if: steps.check_parent.outputs.has_parent == 'true' && steps.check_existing.outputs.exists == 'false'
         id: generate_draft
-        uses: actions/ai-inference@17ff458cb182449bbb2e43701fcd98f6af8f6570 # v2.1.0
+        uses: actions/ai-inference@2c43c91ae16266ca159d311430343c67a5ffa222 # v3
         with:
           provider: copilot
           # No model is pinned: actions/ai-inference forwards --model to the

content/billing/reference/billing-roles.md

@@ -28,6 +28,11 @@ To add a billing manager, see:
 * [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization#inviting-a-billing-manager)
 * [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise)
 
+{% ifversion enterprise-billing-github-app %}
+
+Enterprise owners can also grant a {% data variables.product.prodname_github_app %} the enterprise billing permission, so that an app can access enterprise billing data through the REST API without using a token that belongs to an individual. For more information, see [AUTOTITLE](/billing/tutorials/automate-usage-reporting).
+{% endif %}
+
 ## Organization owners
 
 You have full administrative access to your organization. You can:

content/billing/tutorials/automate-usage-reporting.md

@@ -28,10 +28,34 @@ Before you begin this tutorial, make sure that:
   * Enterprise-level reports: enterprise administrator or billing manager
 
 * You’re familiar with making authenticated requests to the REST API. For an introduction, see [AUTOTITLE](/rest/using-the-rest-api).
-* You authenticate using a {% data variables.product.pat_v1 %}. The billing usage endpoints do not support {% data variables.product.pat_v2_plural %}.
+* You authenticate using a {% data variables.product.pat_v1 %}. The billing usage endpoints do not support {% data variables.product.pat_v2_plural %}.{% ifversion enterprise-billing-github-app %} For enterprise-level reporting, you can authenticate with a {% data variables.product.prodname_github_app %} instead. See [Authenticating with a {% data variables.product.prodname_github_app %}](#authenticating-with-a-github-app).{% endif %}
 
 Depending on your reporting needs, you may also want access to an internal system (such as a spreadsheet, database, or BI tool) where you can store and analyze the usage data retrieved from the API.
 
+{% ifversion enterprise-billing-github-app %}
+
+## Authenticating with a {% data variables.product.prodname_github_app %}
+
+For enterprise-level reporting, you can authenticate with a {% data variables.product.prodname_github_app %} instead of a {% data variables.product.pat_generic %}. Your automation then does not depend on a token that belongs to an individual enterprise owner or billing manager, so your reports keep running when someone changes role or leaves the enterprise.
+
+An enterprise owner can grant an app the enterprise billing permission at one of two levels of access:
+
+* **Read**: The app can retrieve usage reports, budgets, and cost centers. This is the access the reporting in this tutorial requires.
+* **Read and write**: The app can create, update, and delete budgets and cost centers, and add or remove resources from cost centers.
+
+To report on usage with an app:
+
+1. Register a {% data variables.product.prodname_github_app %} that requests the enterprise billing permission. See [AUTOTITLE](/apps/creating-github-apps/registering-a-github-app/registering-a-github-app).
+1. Ask an enterprise owner to install the app on your enterprise. See [AUTOTITLE](/apps/using-github-apps/installing-a-github-app-on-your-enterprise).
+1. Generate an installation access token for the enterprise installation. See [AUTOTITLE](/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app).
+1. Send the installation access token in the `Authorization` header of your requests, in place of a {% data variables.product.pat_generic %}.
+
+An installation access token expires after one hour, so your automation must generate a new token each time it runs or whenever the current token expires.
+
+For the endpoints an app can call with each permission, see [AUTOTITLE](/rest/authentication/permissions-required-for-github-apps).
+
+{% endif %}
+
 ## Step 1: Decide what level to report on
 
 Decide which account level you want to report on. This determines **which REST API endpoint you’ll call** and what your report will include.
@@ -76,7 +100,7 @@ curl -L \
   https://api.github.com/enterprises/ENTERPRISE/settings/billing/usage/summary
 ```
 
-Replace `ENTERPRISE` with the enterprise slug and set the `GITHUB_TOKEN` environment variable to a {% data variables.product.pat_generic %} with the required billing permissions.
+Replace `ENTERPRISE` with the enterprise slug and set the `GITHUB_TOKEN` environment variable to a {% data variables.product.pat_generic %} with the required billing permissions.{% ifversion enterprise-billing-github-app %} Alternatively, set `GITHUB_TOKEN` to an installation access token from a {% data variables.product.prodname_github_app %} with the enterprise billing permission.{% endif %}
 
 **Example using the {% data variables.product.prodname_cli %}**
 

content/copilot/reference/ai-models/supported-models.md

@@ -48,7 +48,7 @@ This table lists the AI models available in {% data variables.product.prodname_c
 
 ## Supported AI models in {% data variables.copilot.copilot_auto_model_selection_short_cap_a %}
 
-This table lists the supported AI models for {% data variables.copilot.copilot_auto_model_selection_short_cap_a %}. Available models may be limited by model policies. See [AUTOTITLE](/copilot/concepts/models/auto-model-selection).
+This table lists the supported AI models for {% data variables.copilot.copilot_auto_model_selection_short_cap_a %}. Available models may be limited by model policies. For example, as the long term support model, GPT-5.3-Codex will be used in the event no other models are available. See[AUTOTITLE](/copilot/concepts/models/fallback-and-lts-models) and [AUTOTITLE](/copilot/concepts/models/auto-model-selection).
 
 {% rowheaders %}