From b4b71ea5882d147202c462f8394578984ac17c94 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 18 Jul 2026 00:08:58 +0000 Subject: [PATCH] docs: add per-engine auth table to how-they-work AI Engines section Closes #46004 Co-Authored-By: Claude --- docs/src/content/docs/introduction/how-they-work.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/src/content/docs/introduction/how-they-work.mdx b/docs/src/content/docs/introduction/how-they-work.mdx index 4fc9aeea2b6..c6965b0ef89 100644 --- a/docs/src/content/docs/introduction/how-they-work.mdx +++ b/docs/src/content/docs/introduction/how-they-work.mdx @@ -25,6 +25,17 @@ Analyze this issue and provide helpful triage comments... Workflows support **GitHub Copilot** (default), **Claude by Anthropic**, **Codex**, and **Gemini by Google**. Each [engine](/gh-aw/reference/engines/) (AI model/provider) interprets natural language instructions and executes them using configured tools and permissions. +Each engine authenticates with its own secret or permission: + +| Engine | Frontmatter `engine:` | Secret or permission required | +|---|---|---| +| Copilot (default) | `copilot` | [`copilot-requests: write`](/gh-aw/reference/auth/#copilot-requests-write-permission) permission or [`COPILOT_GITHUB_TOKEN`](/gh-aw/reference/auth/#copilot_github_token) | +| Claude | `claude` | [`ANTHROPIC_API_KEY`](/gh-aw/reference/auth/#anthropic_api_key) | +| Codex | `codex` | [`OPENAI_API_KEY`](/gh-aw/reference/auth/#openai_api_key) (or `CODEX_API_KEY`) | +| Gemini | `gemini` | [`GEMINI_API_KEY`](/gh-aw/reference/auth/#gemini_api_key) | + +See [Authentication](/gh-aw/reference/auth/) for the full setup instructions for each engine. + ## Tools and Model Context Protocol (MCP) Workflows use [tools](/gh-aw/reference/tools/) through the **[Model Context Protocol](/gh-aw/reference/glossary/#mcp-model-context-protocol)** (MCP, a standardized protocol for connecting AI agents to external tools and services) for GitHub operations, external APIs, file operations, and custom integrations.