intermedio
Prompting para Gemini: Gemini 4 Argon y la familia 3.x
Cubre: Gemini 4 Argon, Gemini 3.1 Pro y Gemini 3.8 Flash
Respuesta rápida:
Gemini acepta una instrucción con cuatro formas distintas, y cuánto piensa antes de contestar lo decide un parámetro de la petición, no una frase del prompt. A la vez, tres de los mandos que solías tocar se ignoran y rellenar el turno del modelo devuelve un error.
Di qué forma tiene la entrada: pregunta, tarea, entidad o continuación
La documentación de Google arranca el diseño con cuatro formas de entrada —pregunta, tarea, entidad y continuación— y nombrar la tuya es la primera palanca: la entrada ya declara la pregunta y la forma de lo que quieres de vuelta.
text
¿Qué nombres le pondrías a una floristería especializada en ramos de flor seca?
Devuelve una lista de 5 opciones, solo los nombres, sin explicación.
La taxonomía data de la generación 2.5 y sus ejemplos siguen etiquetados (gemini-2.5-flash); nada dice cómo se comportan en gemini-4-argon.
La longitud sí ha cambiado, y aquí Google se contradice: la página mantiene un ejemplo 2.5 que pide exhaustividad por defecto, y sus principios de Gemini 3 dicen que contesta directo y eficiente salvo que pidas detalle. Las dos frases siguen vivas y sin reconciliar; la longitud se pide.
El nivel de pensamiento decide cuánto piensa, no una frase del prompt
El razonamiento ocurre antes de la respuesta visible y lo gobierna thinking_level: low, medium y high en casi toda la línea, minimal donde lo soportan, y un defecto que cambia por modelo. gemini-4-argon, gemini-3.8-flash y gemini-3.6-flash arrancan en medium, gemini-3.5-flash-lite en minimal, y gemini-3.1-pro-preview y gemini-3-flash-preview en high. El nombre anterior de ese control era thinking_budget.
La segunda contradicción está en el razonamiento: la plantilla de mejores prácticas termina con <final_instruction>Remember to think step-by-step before answering.</final_instruction>, y la sección de razonamiento de la misma página dice que no hace falta que el modelo detalle los pasos. Google publica las dos sin reconciliarlas. El reparto es claro: la profundidad va en el parámetro.
Ambas direcciones tienen su frase corta:
text
Antes de responder, piensa a fondo el problema. No escribas el razonamiento:
devuelve la conclusión y las dos frases que la sostienen.
Los parámetros de muestreo se aceptan y se ignoran
temperature, top_p y top_k están deprecados: la API los acepta y los ignora, y devolverá error en generaciones futuras. candidate_count no está soportado desde Gemini 3.
Una búsqueda en rejilla sobre esos valores no mide lo que crees: la diferencia entre dos ejecuciones viene de otro sitio, y el remedio de la página para una respuesta de seguridad —subir la temperature— ya no hace nada. Para el determinismo, define una instrucción de sistema con reglas explícitas:
text
system_instruction:
Devuelve siempre tres bullets y en este orden: qué ha pasado, qué implica,
qué hacer después. Máximo 20 palabras por bullet. Si falta un dato, escribe
"sin datos" en el bullet que corresponda en vez de rellenarlo.
Un turno de modelo rellenado devuelve 400
Si el último turno no vacío de la petición es un turno model, la API devuelve un 400. El caso típico era abrir la respuesta con los primeros caracteres para quitar el preámbulo o forzar JSON.
Los sustitutos son system_instruction para una regla de formato y structured outputs para un esquema. El prefijo como texto sigue vivo en el turno de usuario, con la estrategia de completado:
text
Redacta el informe con esta estructura y empieza por el primer apartado,
sin ninguna frase de introducción:
1. Resumen
Contexto primero, instrucciones al final
Con entradas grandes se entrega todo el contexto primero y la instrucción o la pregunta al final. Es uno de los tres principios que la documentación etiqueta como Gemini 3, escrito como requisito.
Con la ventana unificada de 1.048.576 tokens de gemini-4-argon, intercalar instrucciones y pruebas a lo largo de esa distancia trabaja contra la regla. Entre el material y la pregunta va una frase de transición —«Basándote en la información anterior…»— que separa la evidencia de la petición.
text
<contexto>
[pega aquí el contrato, el informe o los ficheros]
</contexto>
Basándote en la información anterior, dime en cinco bullets qué obligaciones
acepta el proveedor y cuáles no aparecen en el documento.
Cuando falta un dato o una cuenta, la herramienta es parte del prompt
Grounding con Google Search conecta el modelo con contenido web en tiempo real y se activa cuando el dato puede ser reciente o poco conocido. La ejecución de código le deja ejecutar Python y se activa con aritmética, conteo o cálculo. Son interruptores de la petición, no comportamientos que se pidan por escrito: un prompt que pide buscar o sumar sin la herramienta enciende el fallo que la herramienta evita.
Para el corte de conocimiento la página publica una cláusula literal, Your knowledge cutoff date is January 2025., en la última actualización de la página (2026-10-13), para modelos publicados en 2026. Se reproduce como está publicada; contrástala con la ficha del modelo.
text
system_instruction:
Cuando una consulta del usuario sea sensible al tiempo y necesite información
actualizada, usa obligatoriamente la hora actual que se te ha dado (fecha y
año) al formular las búsquedas de las llamadas a herramientas. Recuerda que
este año es 2026.
Cuando se comporta mal
La respuesta sale telegráfica cuando querías detalle. Es el defecto de la línea, y la instrucción que pide exhaustividad viene de la era 2.5. Pide la longitud.
La respuesta se corta o vuelve vacía. max_output_tokens cuenta también los tokens de pensamiento y el modelo se para razonando con estado incomplete. Sube el techo o baja thinking_level.
Cambiar temperature no cambia nada. Se ignora. Escribe la regla en la instrucción de sistema.
Todas las llamadas devuelven 400. El último turno no vacío es model. Mueve el arranque al turno de usuario, o usa system_instruction y structured outputs.
Se inventa un dato de este año o se equivoca al sumar. No hay herramienta encendida. Activa grounding con Google Search o ejecución de código.
Qué cambió y cuándo
- 21 de julio de 2026. Se anuncia la deprecación de
temperature,top_pytop_k: se aceptan y se ignoran. - 8 de octubre de 2026.
gemini-3.7-flashse enruta agemini-3.8-flashygemini-3.5-flashagemini-3.6-flash: el endpoint antiguo lo contesta el sucesor. - 13 de octubre de 2026. Gemini 4 Argon pasa a disponibilidad general. Es el único modelo de la generación 4: no hay Gemini 4 Pro ni Gemini 4 Flash.
Si vienes de la generación 2.5: quita los tres parámetros de muestreo, sustituye el turno de modelo rellenado por system_instruction o structured outputs, mueve el contexto delante de las instrucciones y enciende la herramienta que falte.
Resumen
En la línea actual el razonamiento se gobierna con un parámetro y no con una frase, `temperature`, `top_p` y `top_k` se aceptan y se ignoran, y un turno de modelo rellenado devuelve HTTP 400. Del lado del prompt quedan las cuatro formas de entrada, el orden contexto-primero y las herramientas de grounding.
Artículos relacionados
¿Listo para crear mejores prompts?
SystemPrompt Master aplica el método de estas guías para escribir el prompt del modelo que elijas y guarda cada versión.