support using Azure OpenAI

Author: qiancai

scripts/release-notes-generator-readme.md

@@ -48,7 +48,7 @@ The generator does not create a complete formal release note. It does not genera
     export GITHUB_TOKEN=<your-github-token>
     ```
 
-- Install and log in to Codex CLI. The default `--ai-command` uses `codex exec`, so the installed Codex CLI must support `exec`, `--sandbox read-only`, `--ephemeral`, `--output-schema`, `--output-last-message`, and `-m <model>`.
+- Install and log in to Codex CLI. The default `--ai-command` uses `codex exec`, so the installed Codex CLI must support `exec`, `--sandbox read-only`, `--ephemeral`, `--output-schema`, `--output-last-message`, and `-m <model>`. If you use `--ai-provider azure` instead, Codex CLI is not required; set `AZURE_OPENAI_KEY` and `AZURE_OPENAI_BASE_URL` (or `OPENAI_BASE_URL`) environment variables.
 
 ## Typical usage
 
@@ -67,8 +67,9 @@ python3 scripts/release_notes_generate_ai.py \
 | `--excel <workbook-path>` | Yes | None | `--excel /path/to/release-note-excel.xlsx` | Path to the source release note Excel file. The source workbook is not overwritten. The processed workbook is written to `<original-name>_processed.xlsx`. |
 | `--releases-dir <releases-dir>` | Yes | None | `--releases-dir releases` | Path to the existing English release notes directory. The script scans this directory for historical release notes and writes the generated Markdown under this directory unless `--output-release-file` is specified. |
 | `--sheet <sheet-name>` | No | `pr_for_release_note` | `--sheet pr_for_release_note` | Workbook sheet to process. |
-| `--ai-command <command>` | No | `codex --ask-for-approval never exec --sandbox read-only --ephemeral` | `--ai-command "codex --ask-for-approval never exec --sandbox read-only --ephemeral"` | Command used to invoke the AI generator. The prompt is passed through standard input. When the command is `codex exec`, the script also passes `--output-schema` and `--output-last-message`. |
-| `--ai-model <model>` | No | `gpt-5.4` | `--ai-model gpt-5.4` | Model name passed to `codex exec` with `-m`. |
+| `--ai-provider <provider>` | No | `codex` | `--ai-provider azure` | AI provider to use. `codex` runs the Codex CLI as a subprocess. `azure` calls Azure OpenAI via the OpenAI Python SDK (requires `AZURE_OPENAI_KEY` and `AZURE_OPENAI_BASE_URL` or `OPENAI_BASE_URL` environment variables). |
+| `--ai-command <command>` | No | `codex --ask-for-approval never exec --sandbox read-only --ephemeral` | `--ai-command "codex --ask-for-approval never exec --sandbox read-only --ephemeral"` | Command used to invoke the AI generator (only used with `--ai-provider codex`). The prompt is passed through standard input. When the command is `codex exec`, the script also passes `--output-schema` and `--output-last-message`. |
+| `--ai-model <model>` | No | `gpt-5.4` | `--ai-model gpt-5.4` | Model name. Passed to `codex exec` with `-m`, or used as the model parameter for Azure OpenAI. |
 | `--involve-ai-generation <ON-or-OFF>` | No | `ON` | `--involve-ai-generation OFF` | Whether to generate non-duplicate release notes with AI. Use `ON` to invoke AI, or `OFF` to use the source `formated_release_note` values. |
 | `--output-release-file <markdown-file>` | No | Conditional | `--output-release-file /path/to/release-8.5.7.md` | Write the generated Markdown to a custom path. By default, the output under `--releases-dir` is `release-<version>-updated-by-ai.md` if `release-<version>.md` already exists, otherwise `release-<version>.md`. |
 | `--ai-timeout <seconds>` | No | `600` | `--ai-timeout 600` | Timeout in seconds for each AI command invocation. |

scripts/release_notes_ai/ai_client.py

@@ -21,10 +21,7 @@
 
 
 class AIClient:
-    def __init__(self, command: str, model: str | None, timeout: int):
-        self.command = shlex.split(command)
-        self.model = model
-        self.timeout = timeout
+    """Base AI client with shared generation and validation logic."""
 
     def generate(self, prompt: str, expected_links: list[str], contributors: list[str]) -> GeneratedNote:
         result, errors = self._run_and_validate(prompt, expected_links, contributors)
@@ -47,6 +44,18 @@ def _run_and_validate(
             return None, [str(exc)]
         return validate_ai_response(data, expected_links, contributors)
 
+    def _run(self, prompt: str) -> str:
+        raise NotImplementedError("Subclasses must implement _run")
+
+
+class CodexAIClient(AIClient):
+    """AI client that invokes the Codex CLI as a subprocess."""
+
+    def __init__(self, command: str, model: str | None, timeout: int):
+        self.command = shlex.split(command)
+        self.model = model
+        self.timeout = timeout
+
     def _run(self, prompt: str) -> str:
         command = list(self.command)
         if not command:
@@ -97,6 +106,44 @@ def _is_codex_exec(command: list[str]) -> bool:
         return executable == "codex" and "exec" in command[1:]
 
 
+class AzureOpenAIClient(AIClient):
+    """AI client that calls Azure OpenAI via the OpenAI Python SDK."""
+
+    DEFAULT_MODEL = "gpt-5.4"
+    MAX_OUTPUT_TOKENS = 16384
+    TEMPERATURE = 0.1
+
+    def __init__(self, model: str | None, timeout: int):
+        from openai import OpenAI
+
+        key = os.environ.get("AZURE_OPENAI_KEY", "")
+        base_url = (
+            os.environ.get("AZURE_OPENAI_BASE_URL")
+            or os.environ.get("OPENAI_BASE_URL", "")
+        )
+        if not key:
+            raise ValueError(
+                "AZURE_OPENAI_KEY environment variable is required "
+                "when using --ai-provider azure"
+            )
+        if not base_url:
+            raise ValueError(
+                "AZURE_OPENAI_BASE_URL or OPENAI_BASE_URL environment variable "
+                "is required when using --ai-provider azure"
+            )
+        self.client = OpenAI(api_key=key, base_url=base_url, timeout=timeout)
+        self.model = model or self.DEFAULT_MODEL
+
+    def _run(self, prompt: str) -> str:
+        response = self.client.responses.create(
+            model=self.model,
+            input=[{"role": "user", "content": prompt}],
+            temperature=self.TEMPERATURE,
+            max_output_tokens=self.MAX_OUTPUT_TOKENS,
+        )
+        return response.output_text.strip()
+
+
 def is_executable_available(executable: str) -> bool:
     if os.sep in executable or (os.altsep and os.altsep in executable):
         return Path(executable).exists()

scripts/release_notes_ai/cli.py

@@ -7,7 +7,7 @@
 
 import openpyxl
 
-from .ai_client import AIClient
+from .ai_client import AzureOpenAIClient, CodexAIClient
 from .excel_workbook import (
     clear_output_columns,
     generate_notes_without_ai,
@@ -36,15 +36,26 @@ def parse_args() -> argparse.Namespace:
         help="Path to the existing English release notes directory.",
     )
     parser.add_argument("--sheet", default="pr_for_release_note", help="Workbook sheet name.")
+    parser.add_argument(
+        "--ai-provider",
+        choices=["codex", "azure"],
+        default="codex",
+        help=(
+            "AI provider to use. 'codex' runs the Codex CLI as a subprocess "
+            "(requires codex to be installed). 'azure' calls Azure OpenAI via the "
+            "OpenAI Python SDK (requires AZURE_OPENAI_KEY and AZURE_OPENAI_BASE_URL "
+            "or OPENAI_BASE_URL environment variables). Default: codex."
+        ),
+    )
     parser.add_argument(
         "--ai-command",
         default="codex --ask-for-approval never exec --sandbox read-only --ephemeral",
-        help="Command-line AI command. The prompt is passed through stdin.",
+        help="Command-line AI command (only used with --ai-provider codex). The prompt is passed through stdin.",
     )
     parser.add_argument(
         "--ai-model",
         default="gpt-5.4",
-        help="Model name passed to codex exec with -m.",
+        help="Model name. Passed to codex exec with -m, or used as the model parameter for Azure OpenAI.",
     )
     parser.add_argument(
         "--involve-ai-generation",
@@ -142,7 +153,13 @@ def main() -> int:
         raise SystemExit(f"error: {exc}") from None
     github = GitHubClient(token)
     involve_ai_generation = args.involve_ai_generation == "ON"
-    ai = AIClient(args.ai_command, args.ai_model, args.ai_timeout) if involve_ai_generation else None
+    if involve_ai_generation:
+        if args.ai_provider == "azure":
+            ai = AzureOpenAIClient(args.ai_model, args.ai_timeout)
+        else:
+            ai = CodexAIClient(args.ai_command, args.ai_model, args.ai_timeout)
+    else:
+        ai = None
 
     output_file = (
         Path(args.output_release_file)

scripts/release_notes_ai/requirements.txt

@@ -1,3 +1,4 @@
 openpyxl>=3.1
+openai>=1.66
 requests>=2.31
 urllib3>=1.26