openai-docs

OpenAI Docs

Forneça orientação autorizada e atualizada da documentação de desenvolvedor da OpenAI usando o servidor MCP developers.openai.com. "Docs MCP" significa mcp__openaiDeveloperDocs__search_openai_docs e mcp__openaiDeveloperDocs__fetch_openai_doc; para perguntas sobre referência de API, esquemas, parâmetros ou campos obrigatórios, use também mcp__openaiDeveloperDocs__get_openapi_spec quando disponível. A pesquisa na web em domínios oficiais é um recurso alternativo somente após essas ferramentas estarem indisponíveis ou não forem úteis. Perguntas amplas sobre o Codex usam o helper do manual antes do Docs MCP. Esta skill também gerencia seleção de modelo, migração de API de modelo e orientação de atualização de prompt.

Configuração da Chave de API

Para solicitações de criação, execução, configuração, depuração ou implementação de um aplicativo, script, CLI, gerador ou ferramenta baseado em API, use openai-platform-api-key primeiro quando disponível. Após essa etapa de credencial ser resolvida, retorne aqui para obter a documentação atual conforme necessário.

Use esta skill diretamente para perguntas apenas de documentação, citações, orientação sobre modelo/API, explicações conceituais e exemplos que não exijam a criação ou execução de um artefato baseado em API.

Configuração do Fluxo de Trabalho

Prioridade de Fontes

• Para conhecimento próprio do Codex, use a rota de fonte do Codex abaixo; ela decide quando usar o helper do manual, o Docs MCP ou incerteza limitada.
• Para perguntas de documentação da OpenAI que não são sobre o Codex, use mcp__openaiDeveloperDocs__search_openai_docs para encontrar as páginas de documentação mais relevantes.
• Para perguntas de documentação da OpenAI que não são sobre o Codex, busque a página relevante com mcp__openaiDeveloperDocs__fetch_openai_doc antes de responder. Se a pesquisa for ruidosa, execute uma pesquisa Docs MCP mais restrita; quando qualquer URL plausível de documentação oficial da OpenAI for conhecida ou encontrada, tente buscar essa URL através do Docs MCP antes de depender do conteúdo da pesquisa na web.
• Para perguntas sobre referência de API, esquemas, parâmetros ou campos obrigatórios, use mcp__openaiDeveloperDocs__get_openapi_spec quando disponível para verificar a forma da API juntamente com o guia ou página de referência relevante.
• Use mcp__openaiDeveloperDocs__list_openai_docs apenas quando você precisar navegar ou descobrir páginas que não são do Codex sem uma consulta clara.
• Para perguntas sobre seleção de modelo, "último modelo" ou modelo padrão, busque https://developers.openai.com/api/docs/guides/latest-model.md primeiro. Se isso não estiver disponível, carregue references/latest-model.md.
• Para atualizações de modelo ou atualizações de prompt, execute node scripts/resolve-latest-model-info.js apenas quando o destino for o mais recente/atual/padrão ou não especificado; caso contrário, preserve o destino explicitamente solicitado.
• Preserve solicitações de destino explícitas: se o usuário nomear um modelo de destino como "migrar para GPT-5.4", mantenha esse destino solicitado mesmo que latest-model.md nomeie um modelo mais novo. Mencione orientação mais nova apenas como opcional.
• Se a orientação remota atual for necessária, busque as URLs dos guias de migração e prompt retornados diretamente. Se a busca direta falhar, use fallback MCP/pesquisa; se isso também falhar, use referências de fallback incluídas e divulgue o fallback.

Resumos de produtos OpenAI

1. Apps SDK: Crie aplicativos ChatGPT fornecendo um componente de interface web e um servidor MCP que expõe as ferramentas do seu aplicativo ao ChatGPT.
2. Responses API: Um endpoint unificado projetado para interações multimodais, com estado e que usam ferramentas em fluxos de trabalho de agente.
3. Chat Completions API: Gere uma resposta de modelo a partir de uma lista de mensagens que compõem uma conversa.
4. Codex: O agente de codificação da OpenAI para desenvolvimento de software que pode escrever, entender, revisar e depurar código.
5. gpt-oss: Modelos de raciocínio de peso aberto da OpenAI (gpt-oss-120b e gpt-oss-20b) lançados sob a licença Apache 2.0.
6. Realtime API: Crie experiências multimodais de baixa latência, incluindo conversas naturais de fala para fala.
7. Agents SDK: Um kit de ferramentas para construir aplicativos de agente onde um modelo pode usar ferramentas e contexto, passar para outros agentes, transmitir resultados parciais e manter um rastreamento completo.

Autoconhecimento do Codex

Use este caminho para perguntas sobre o próprio Codex: configurar, estender, operar, solucionar problemas, estado local, superfícies de produto ou onde o comportamento do Codex deve residir. Um código-fonte que apenas menciona um plugin, skill, hook, servidor MCP, navegador ou automação não é suficiente. Para tarefas de software genéricas, responda à tarefa de software diretamente; se for perguntado se o autoconhecimento do Codex se aplica, responda a essa pergunta meta brevemente e continue o artefato solicitado.

Rota de Fonte

O manual do Codex é a primeira fonte para síntese ampla do Codex. Trate o manual e o Docs MCP como faixas diferentes, não fontes oficiais de documentação intercambiáveis. Para respostas de produto Codex publicadas ao usuário, a rota de fonte é completa: o manual, Docs MCP quando esta rota exigir, fallback oficial da web da OpenAI e capacidades acessíveis reveladas na sessão atual quando a pergunta é sobre essa capacidade. Bases de conhecimento fora de developers.openai.com estão fora desta rota para respostas de produto público.

Para perguntas amplas sobre comportamento, configuração, personalização, skills, plugins, MCP, hooks, AGENTS.md, automações, superfícies, estado local ou mapa do sistema do Codex:

1. Reutilize um caminho de manual e esboço da mesma thread quando ainda estiver recente.
2. Caso contrário, execute o helper local da skill primeiro em sessões normais graváveis. Pule sem tentar apenas quando a sessão for explicitamente somente leitura, a execução de shell estiver indisponível ou a política visível não mostrar nenhum cache temporário permitido.
3. Por padrão, o helper escolhe o primeiro diretório de cache temporário utilizável nesta ordem: $TMPDIR/openai-docs-cache, %TEMP%\openai-docs-cache, %TMP%\openai-docs-cache, /private/tmp/openai-docs-cache, depois /tmp/openai-docs-cache. Acesso de gravação apenas no espaço de trabalho não é suficiente para este cache temporário.
4. Execute o helper diretamente, a menos que você precise substituir o diretório de cache. O helper usa curl como fallback quando fetch nativo não está disponível ou quando variáveis de ambiente de proxy estão presentes, portanto nenhum prefixo de proxy específico de shell é necessário. Resolva <skill-dir> para o diretório real desta skill; em diretórios de trabalho de avaliação local copiados, geralmente é .codex/skills/openai-docs:

node <skill-dir>/scripts/fetch-codex-manual.mjs

Se você precisar substituir o diretório de cache, passe --cache-dir <cache-dir>. No Windows, o helper verifica %TEMP% e %TMP% automaticamente; no PowerShell, $env:TEMP\openai-docs-cache é uma substituição explícita típica.

Trate a disponibilidade do helper como estabelecida por política explícita de somente leitura/sem shell ou um resultado de comando real. Um sandbox adivinhado ou falha adivinhada do helper não é suficiente para mudar para Docs MCP ou pesquisa na web; após uma falha real do comando do helper, continue para a próxima fonte oficial mais restrita abaixo.

O helper verifica a atualidade, grava codex-manual.md e emite codex-manual.outline.md. O esboço mapeia páginas de origem e cabeçalhos para intervalos de linhas; use-o para escolher a seção relevante do manual, depois leia ou pesquise seções direcionadas do manual para fatos do produto Codex. Use o diretório da skill para localizar e executar o helper; após o helper ter sucesso, use os caminhos do manual e do esboço retornados como o escopo de pesquisa para fatos do produto Codex e verificações de cobertura de termos.

Reutilize os caminhos do manual e do esboço da mesma thread para perguntas de acompanhamento sobre o Codex. Atualize primeiro quando o manual foi buscado há mais de cerca de um dia, o caminho está inutilizável, o caminho veio de outra thread ou proveniência incerta, ou informações provavelmente atuais estão faltando e a desatualização é plausível.

Para perguntas sobre se o manual está atualizado o suficiente para confiar agora, execute o helper quando o cache temporário for permitido e baseie a resposta em seu status retornado, caminho do manual e caminho do esboço.

Se o manual resolver uma afirmação do Codex, responda a partir dele e pare de expandir fontes para essa afirmação; continue a tarefa mais ampla do usuário se a consulta à documentação foi apenas uma dependência. Páginas de origem do manual e âncoras conhecidas são suporte de citação suficiente para material coberto pelo manual.

Se o helper for ignorado porque a sessão é somente leitura, não tem execução de shell ou não tem cache temporário permitido, a próxima fonte é Docs MCP: chame mcp__openaiDeveloperDocs__search_openai_docs, depois mcp__openaiDeveloperDocs__fetch_openai_doc para um resultado relevante antes de qualquer fallback na web.

Se um usuário nomear um termo ou modo do Codex que um manual recente não usa, pesquise no manual conceitos adjacentes óbvios e responda que o termo exato não está documentado e use a terminologia documentada mais próxima. Se o prompt perguntar como esse termo se mapeia para o comportamento do Codex, resolva o mapeamento a partir de seções adjacentes do manual. Se o termo exato permanecer material ou provavelmente atual após essa passagem do manual, use uma pesquisa/busca restrita do Docs MCP antes de incerteza limitada; caso contrário, a consulta de fonte para essa terminologia ou afirmação de mapeamento está completa.

Use a próxima fonte oficial mais restrita apenas quando o manual não estiver disponível, o helper falhar, o cache temporário não for permitido, outra afirmação material estiver faltando ou provavelmente desatualizada, ou o usuário precisar explicitamente de uma citação de página específica. Prefira uma pesquisa Docs MCP específica e, se ela retornar uma página claramente relevante, uma busca; para nomes de capacidade do Codex não resolvidos, acrônimos, termos de agendamento ou texto de erro exato, esta etapa do Docs MCP é a próxima fonte antes da pesquisa na web. Após o manual mais qualquer preenchimento de lacuna permitido do Docs MCP, resolva as lacunas restantes como incerteza limitada. Use fallback na web de domínio oficial apenas depois que esse caminho Docs MCP estiver indisponível ou não for útil. Se a afirmação ainda não estiver estabelecida, pare com incerteza limitada. Se a documentação oficial/manual entrar em conflito com uma capacidade acessível já revelada na sessão atual, declare o conflito e prefira o comportamento verificado da sessão atual para esse ambiente.

Para slugs de modelo não documentados ou de aparência privada, rótulos de modo de produto, rótulos de direito, caminhos de acesso de conta ou nomes de lançamento, responda a partir da documentação pública atual e incerteza limitada. Esses rótulos não são motivo para sair da rota de fonte pública.

Para diagnósticos de suporte, prefira uma resposta camada por camada do manual em vez de pesquisas na web específicas do provedor: plugin instalado/habilitado, autorização de aplicativo ou conector incluído, configuração MCP, reinicialização ou expectativas de nova thread, suporte ou feedback se ainda não resolvido.

Se a rota de fonte ainda não estabelecer uma afirmação, retorne incerteza limitada ou encaminhe para suporte, um administrador ou feedback do produto em vez de ampliar a investigação.

Para terminologia de produto não resolvida, responda a partir do manual mais a próxima fonte oficial permitida. Se essas fontes não estabelecerem o termo, responda com incerteza limitada a partir dessas fontes.

Mapa de Superfície

Quando substantivos do Codex ou superfícies de instrução duráveis se sobrepõem, recomende a menor superfície que corresponda ao escopo:

• Contexto de prompt ou thread -> restrições de tarefa pontuais.
• AGENTS.md -> convenções de repositório duráveis, comandos, etapas de verificação e expectativas de revisão; arquivos aninhados mais próximos se aplicam sob sua subárvore.
• Projeto .codex/config.toml -> configurações do Codex de repositório confiável, como sandbox, MCP, hooks, modelo ou padrões de raciocínio.
• Configuração global ou orientação global -> padrões pessoais entre repositórios.
• Skill -> fluxo de trabalho de tarefa reutilizável com referências ou scripts.
• Plugin -> pacote instalável com habilidades mais comandos, ferramentas, configuração MCP, hooks, ativos, aplicativos ou metadados de marketplace.
• Servidor MCP ou conector de aplicativo -> dados/ações externos ao vivo ou dados de aplicativo/espaço de trabalho privado autorizado. Use conectores para Google Docs privados, Calendário, Slack, GitHub, Notion e dados semelhantes em vez de pesquisa na web ou memória do modelo.
• Automação -> verificações agendadas, lembretes, monitores ou trabalho de acompanhamento; use um batimento cardíaco de thread quando a continuidade em uma thread existente for importante.
• Hook -> imposição de ciclo de vida em torno de chamadas de ferramenta, comandos ou edições de arquivo.

Divida solicitações de escopo misto em vez de forçar uma resposta. Exemplo: "sempre faça X, mas apenas para este PR" padroniza para contexto de prompt/thread para a execução atual; use AGENTS.md ou configuração do projeto apenas se deve persistir, hooks apenas para imposição mecânica e automações apenas para trabalho agendado ou de acompanhamento.

Use este mapa rápido de produto quando necessário: CLI é trabalho local de repositório centrado no terminal; extensão IDE é codificação anexada ao editor; aplicativo Codex é planejamento, revisão e trabalho interativo na área de trabalho; cloud/web é trabalho paralelo/descarregado hospedado; Uso do Navegador/navegador no aplicativo é teste web controlado pelo Codex; extensão Chrome usa o perfil Chrome do usuário; Uso do Computador controla aplicativos da área de trabalho e interface do sistema operacional. Mantenha os padrões config.toml, as restrições requirements.toml e a política gerenciada/admin separadas.

Limites e Saída

• Autenticação de chave de API não implica acesso a ChatGPT, tarefa em nuvem ou conector. Para falhas de plugin/aplicativo/auth, verifique a disponibilidade do pacote, estado do plugin instalado/habilitado, autorização do conector/aplicativo, configuração MCP, expectativas de reinicialização/atualização, política do espaço de trabalho e disponibilidade por superfície antes de responder.
• Negativas de sandbox ou rede precisam de escalonamento com escopo com uma justificativa clara. Comandos destrutivos, gravações fora do espaço de trabalho ou alterações amplas de acesso exigem aprovação explícita.
• A memória pode fornecer preferência ou contexto do usuário, mas instruções explícitas do prompt vencem e a memória não é uma fonte para fatos externos atuais.
• Para respostas afirmativas de seleção de superfície, use esta forma: recomendação, por quê, o que evitar e a evidência do manual/fonte usada.
• Quando citações específicas de página do Codex são realmente necessárias, essas âncoras geralmente se encaixam: concepts/customization#agents-guidance para AGENTS.md, concepts/customization#skills para skills, plugins/build#plugin-structure para plugins, concepts/customization#mcp para MCP, config-advanced#hooks para hooks, app/automations#thread-automations para automações de thread e config-reference#configtoml para config.

Se o servidor MCP estiver faltando

Se as ferramentas MCP falharem ou nenhum recurso de documentação da OpenAI estiver disponível:

1. Execute você mesmo o comando de instalação: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
2. Se falhar devido a permissões/sandbox, tente imediatamente o mesmo comando com permissões elevadas e inclua uma justificativa de 1 frase para aprovação.
3. Peça ao usuário para executar o comando de instalação apenas se a tentativa elevada falhar.
4. Peça ao usuário para reiniciar o Codex.
5. Reexecute a consulta de documentação depois que o servidor MCP for adicionado e o Codex for reiniciado.