Update the openai-docs skill for GPT-6.2 (#62447)

## Why

The existing GPT-6 migration guidance points to the earlier Astra
quickstart. Explicit GPT-6.2 Astra and Sol requests need guidance for
the selected model and its endpoint requirements.

## What changed

Direct both GPT-6.2 targets to the shared migration quickstart and
document that both support Responses and Chat Completions, with tool
calling requiring Responses. Refresh the fallback model guidance and
point onboarding examples to the model selection guide. Specify model
choices for legacy Chat Completions examples, Codex CLI
examples, and configuration shared with the IDE extension.

GitOrigin-RevId: 14000eedac4f2a4169bb76212cb74d8342b5752e
This commit is contained in:
Konstantine Kahadze
2026-11-19 06:34:53 +00:00
committed by copyberry
parent 739f934a15
commit b9559ff737
4 changed files with 15 additions and 7 deletions
@@ -15,6 +15,8 @@ For other questions about product behavior, look up the current Codex guide at d
For a recent change, or when a source explains only the underlying mechanism, find the feature by name in the [ChatGPT and Codex changelog](https://learn.chatgpt.com/docs/changelog). Use the entry for the relevant surface and version. For Codex client behavior, follow the linked change or tests to verify what the client actually does. Cite what establishes the answer and say which details remain uncertain.
For model choices in onboarding examples, follow [model selection](references/model-selection.md).
For a first OpenAI API integration, start with the [developer quickstart](https://developers.openai.com/api/docs/quickstart) and follow the guide for the user’s task. Suggest the OpenAI Developers plugin for deeper implementation help.
When the user explicitly invokes `$openai-docs` for an OpenAI API model migration, use the official migration guide for the requested target. For GPT-6 models, start with the [migration quickstart](https://developers.openai.com/api/docs/guides/latest-model#migration-quickstart). Inspect the existing request and prompt, verify compatibility for changed parameters, and preserve supported behavior and the user's chosen target model.
When the user explicitly invokes `$openai-docs` for an OpenAI API model migration, use the official migration guide for the requested target. For GPT-6.2 Astra or GPT-6.2 Sol, use the [GPT-6.2 migration quickstart](https://developers.openai.com/api/docs/guides/latest-model?model=gpt-6.2-astra#gpt-6.2-astra-migration-quickstart), which covers both models. For example, `$openai-docs migrate this project to GPT-6.2 Astra` targets `gpt-6.2-astra`. For other GPT-6 models, start with the [migration quickstart](https://developers.openai.com/api/docs/guides/latest-model#migration-quickstart). Inspect the existing request and prompt, verify compatibility for changed parameters, and preserve supported behavior and the user's chosen target model.
@@ -6,10 +6,13 @@ This is a compact, non-authoritative fallback, not a source for current availabi
| Model ID | Official source description |
| --- | --- |
| `gpt-6-astra` | For the most demanding reasoning, coding, and professional work. |
| `gpt-6.1-sol` | Near-Astra performance for complex work at a lower cost. |
| `gpt-6-luna` | Strong performance for focused, high-volume tasks. |
| `gpt-6.2-astra` | Demanding reasoning and coding tasks. |
| `gpt-6.2-sol` | Everyday coding and agent workflows. |
| `gpt-6.1-terra` | Mini model for latency-sensitive API examples. |
| `gpt-6-luna` | Nano model for focused, high-volume tasks. |
Use `https://developers.openai.com/api/docs/guides/latest-model/gpt-6-astra.md#migration-quickstart` for an actual GPT-6 migration and `https://developers.openai.com/api/docs/guides/latest-model/gpt-6-astra.md#prompting-best-practices` for requested GPT-6 prompting. Open and read the relevant page before recommending a request shape, reasoning setting, endpoint, tool behavior, or migration.
Legacy Chat Completions function-tool examples use `gpt-5.6-terra`. For an explicit GPT-6.2 Astra or Sol target, use the [GPT-6.2 migration quickstart](https://developers.openai.com/api/docs/guides/latest-model?model=gpt-6.2-astra#gpt-6.2-astra-migration-quickstart). Both models support Responses and Chat Completions. Tool calling requires Responses.
Codex CLI examples use `gpt-6.2-sol` when the account has access. Configuration examples shared with the IDE extension use `gpt-6.1-sol`. Check [Codex availability by plan](https://developers.openai.com/codex/pricing#feature-availability) for the user's surface.
Verify GPT-6 Pro against current official Responses and model documentation before describing model IDs, reasoning modes, request parameters, or account availability; do not invent a separate `gpt-6-pro` model slug.
@@ -32,7 +32,8 @@ Treat returned guide URLs as opaque: fetch those exact URLs without deriving, su
- Fetch `migrationGuideUrl` for a requested migration or upgrade plan.
- Fetch `promptingGuideUrl` only when the user asks for prompting guidance or the migration requires a prompt change. Extract only `## Prompting best practices` through the next H2 heading.
- For explicitly named-model prompting, fetch that model's official prompting guidance and extract only `## Prompting best practices` through the next H2 heading. Do not load a migration reference or run the resolver.
- For an actual GPT-6 migration or implementation plan, fetch `https://developers.openai.com/api/docs/guides/latest-model/gpt-6-astra.md#migration-quickstart`. For specifically requested GPT-6 prompting, fetch `https://developers.openai.com/api/docs/guides/latest-model/gpt-6-astra.md#prompting-best-practices`. Read `references/upgrading-to-gpt-6-astra.md` only when fetched official guidance does not resolve needed compatibility gates, scoped code changes, tier-aware routing, validation, or other migration-specific judgment. Never load it for documentation-only questions about model tiers, the family alias, Pro mode, reasoning effort, or current guidance when the fetched official documentation already answers them.
- For an explicit GPT-6.2 Astra or Sol target, use the [GPT-6.2 migration quickstart](https://developers.openai.com/api/docs/guides/latest-model?model=gpt-6.2-astra#gpt-6.2-astra-migration-quickstart). Both models support Responses and Chat Completions. Tool calling requires Responses.
- For a migration or implementation plan covered by the earlier GPT-6 Astra guide, fetch `https://developers.openai.com/api/docs/guides/latest-model/gpt-6-astra.md#migration-quickstart`. For specifically requested GPT-6 prompting, fetch `https://developers.openai.com/api/docs/guides/latest-model/gpt-6-astra.md#prompting-best-practices`. Read `references/upgrading-to-gpt-6-astra.md` only when fetched official guidance does not resolve needed compatibility gates, scoped code changes, tier-aware routing, validation, or other migration-specific judgment. Never load it for documentation-only questions about model tiers, the family alias, Pro mode, reasoning effort, or current guidance when the fetched official documentation already answers them.
- Verify current official guidance and account availability before recommending or selecting a model. Preserve the selected model and apply its own compatibility rules; do not copy a sibling's reasoning defaults, tool support, or regional availability. A newer family member does not change the model returned by the latest-model resolver. For an explicitly requested model whose public guidance is not yet available, keep the requested target and state the unresolved compatibility facts instead of silently substituting another model.
- Read `references/prompting-guide.md` only when prompting guidance or prompt changes are actually needed and current official guidance is unavailable.
- Read `references/upgrade-guide.md` only when current official migration guidance is unavailable. Disclose when a bundled fallback was used.
@@ -9,7 +9,9 @@ For latest, current, default, or unspecified-model upgrades:
3. Treat the live guides as canonical.
4. If remote retrieval fails, disclose that bundled fallback guidance is being used.
For an explicitly requested GPT-6 model:
For an explicit GPT-6.2 Astra or Sol target, use the [GPT-6.2 migration quickstart](https://developers.openai.com/api/docs/guides/latest-model?model=gpt-6.2-astra#gpt-6.2-astra-migration-quickstart). Both models support Responses and Chat Completions. Tool calling requires Responses.
For another explicitly requested GPT-6 model with guidance in the GPT-6 Astra guide:
1. Preserve the user's explicit target; do not run the latest-model resolver.
2. Fetch the live GPT-6 model guidance: