Cómo escribirle a GPT-6 Astra (la guía de OpenAI en español)

A GPT-6 Astra no se le escribe como a GPT-5. Si le pegas el prompt de siempre, obtienes justo lo que OpenAI te dice que corrijas en su guía oficial: te pregunta más, se enrolla, se pasa probando. Aquí tienes esa guía traducida y resumida en el orden en que la vas a necesitar: qué cambia, qué le escribes ahora y qué tocas en la API. Todo se pega y funciona en un minuto.

Lo que cambia en Astra

Cinco comportamientos nuevos. Ninguno es un fallo: son la consecuencia de que el modelo hace más caso a lo que le escribes, y por eso el prompt de antes ya no encaja.

Pregunta más. Cuando le falta información que cambiaría el resultado, te para y te pregunta, donde el anterior daba algo por supuesto y seguía. Bien cuando la duda es real; un incordio cuando esperabas que tirase.
Hace mucho más caso a las instrucciones de skills y AGENTS.md. Una línea ambigua o contradictoria en un skill puede hacer que se pare o bloquee el trabajo antes de tiempo. OpenAI recomienda revisar lo que cargas y dejar explícito quién manda.
Se enrolla. Tiende a respuestas largas, con listas, tablas y markdown por todas partes, y repite muletillas de una sesión a otra. Si no le dices el estilo, elige el suyo.
Delega menos. Si tu sistema tiene subagentes para trabajar en paralelo, los usa menos de lo que te gustaría hasta que le dices cuándo y cuánto.
En código se pasa probando. Quiere agotar los tests antes de dar nada por terminado. En un cambio pequeño, eso es más pruebas de las que el cambio pide.

Lo que le escribes ahora: las frases para pegar

Una por regla, en español y en inglés. Usa la del idioma en que tengas el resto de tus instrucciones. Van en el prompt de sistema, en tu AGENTS.md o al principio de la petición. Están redactadas a partir de las recomendaciones de la guía oficial: no son citas, son instrucciones listas para pegar.

1. Iniciativa: que tire hasta terminar

Para cuando se para a proponerte un plan, a pedirte permiso o te entrega medio trabajo.

Infiere mi intención y el alcance de la tarea a partir de las instrucciones y del contexto de la conversación. Tira hacia la acción y lleva la tarea hasta el final. Cuando te pida algo ("¿puedes...?", "quiero...", "ayúdame a..."), trátalo como una orden de hacerlo: no te pares a confirmar que puedes, a proponer un plan ni a ofrecerte a continuar. No aceptes una solución parcial o "suficiente" para ahorrar tiempo o tokens. Si la tarea requiere trabajo sostenido, complétala entera.

Infer my intent and the task scope from the instructions and prior conversation context. Bias towards action and carry the task to completion. When I ask for something ("can you...", "I want to...", "help me..."), treat it as an instruction to do the work: do not stop at acknowledging you can, proposing a plan, or offering to continue. Do not settle for a partial or "good enough" solution to save time or tokens. If the task requires sustained work, complete all of it.

2. Precedencia: tus instrucciones mandan sobre las de un skill

Para cuando un skill le hace pedir permiso, pararse o desviarse de lo que le pediste. Además de fijar la prioridad, le obligas a decirte qué archivo le ha frenado.

Mis instrucciones tienen prioridad sobre las de cualquier skill. Si una instrucción mía explícita choca con la de un skill, sigue la mía. Si un skill te hace pedir permiso o confirmación, pararte, dejar trabajo sin terminar o desviarte de lo que te he pedido, nombra y enlaza el archivo SKILL.md exacto que has leído, cita la instrucción concreta y explica en una línea cómo aplica. Distingue lo que el skill exige de lo que tú interpretas.

My instructions take precedence over any skill's guidelines. If an explicit instruction of mine conflicts with a skill's instructions, follow mine. If a skill causes you to ask for permission or confirmation, pause, leave requested work unfinished, or diverge from what I asked, name and link the exact SKILL.md file you read, quote the relevant instruction, and briefly explain how it applies. Distinguish explicit skill requirements from your own interpretation.

3. Estilo: párrafos, no listas

Para cuando cada respuesta es un informe con viñetas. Fíjate en la última muletilla prohibida: el marco “no es X, es Y” es la favorita de los modelos y OpenAI la veta en su propia guía.

Escribe en párrafos claros y cortos, cada uno con una idea. Usa listas solo cuando la información sea realmente paralela, secuencial o más fácil de comparar, y nada de listas anidadas si se puede decir en prosa. Lenguaje llano: palabras corrientes, ejemplos concretos, verbos precisos. Voz activa y frases directas. Prohibido "Bottom line:", "leverage", "importantly" y el marco "no es X, es Y".

Default to clear, concise paragraphs, each developing one main idea. Use lists only when the information is genuinely parallel, sequential, or easier to compare, and avoid nested lists unless the hierarchy cannot be expressed in prose. Use plain language: familiar words, concrete examples, precise verbs. Prefer active voice and direct statements. Do not use "Bottom line:", "leverage", "importantly", or the "This isn't about X. It's about Y." framing.

4. Delegación: si puede paralelizar, que delegue

Solo tiene sentido si tu sistema tiene subagentes. Si trabajas con un único agente, sáltate esta.

Si en cualquier momento puedes paralelizar el trabajo delegando tareas en otro agente (da igual si eres el agente raíz o un subagente), hazlo siempre que ahorre tiempo o mejore el resultado.

If at any point you can parallelize work by delegating tasks to another agent (whether you are the root agent or a subagent), do so if it could save time or improve quality.

5. Tests: sin tests para cambios pequeños

Para cuando corrige una errata y te monta una suite. Le marcas cuánto probar y, sobre todo, cuándo parar.

No escribas tests para cambios reversibles y de bajo impacto que solo repiten la implementación. Si decides verificar con tests, que sean necesarios y tengan sentido. Ejecuta los tests que tocan para el cambio y las comprobaciones obligatorias; cuando pasen, no amplíes ni repitas las pruebas salvo que haya cambios nuevos, fallos o dudas sin resolver. Si no, sigue hasta terminar la tarea.

Do not write tests for reversible, low-impact changes that mirror the implementation. If you do verify with tests, make sure they are meaningful and necessary. Run the tests appropriate to the change and complete required checks; once those pass, broaden or repeat testing only when new changes, failures, or unresolved concerns justify it. Otherwise, continue toward completing the task.

Los ajustes de la API: antes → después

Si llamas a Astra por API, esto es lo que cambias en la petición. Cinco líneas y una nota.

Qué	Antes (GPT-5)	Ahora (GPT-6 Astra)
Modelo	el GPT-5 que usaras	`gpt-6-astra`
Esfuerzo de razonamiento	`reasoning: none` o `minimal`	`reasoning: low` (Astra no soporta `none`; si ya usabas otro nivel, déjalo)
`temperature`, `top_p`, `top_logprobs`	los ponías	bórralos: ya no se admiten
Tool calling	Chat Completions	Responses API
Caché de prompt	`prompt_cache_retention`	`prompt_cache_options.ttl: "30m"`
Modo rápido	—	no disponible con residencia de datos en la UE

El esqueleto de una petición a la Responses API con esos cambios ya aplicados:

{
  "model": "gpt-6-astra",
  "reasoning": { "effort": "low" },
  "prompt_cache_options": { "ttl": "30m" },
  "input": "..."
}

Sin temperature, sin top_p, sin top_logprobs. El resto de tu petición sigue igual.

Fuente

Todo lo de arriba sale de la guía oficial de OpenAI para GPT-6 Astra: developers.openai.com/api/docs/guides/latest-model?model=gpt-6-astra. Traducción, resumen y frases listas para pegar: Pablo. Si algo de aquí choca con lo que diga la guía cuando la leas, manda la guía: OpenAI la actualiza.

Regla de oro

Cuanto más caso te hace el modelo, más pesa cada línea de tu prompt. Escríbele lo que quieres, no lo que le escribías al anterior.

Sígueme para más trucos con Claude Code e IA → @pabloinpublic

Más recursos → pabloinpublic.com/recursos