Guía de prompts para Qwen: el esquema de seis partes de Alibaba, delimitadores y modo JSON

Cómo escribir prompts para Qwen3.8 Max, Qwen3.7 Plus y Qwen3.8 Flash siguiendo la guía de prompts y la documentación de la API de Alibaba Cloud Model Studio.

Última actualización: · Versión en markdown

Qué recomienda Alibaba

  • Armá el prompt con seis partes: contexto, objetivo, estilo, tono, audiencia y respuesta. Cada una responde algo que el modelo tendría que adivinar; dejá afuera las que la tarea no necesita.
  • Respuesta es la forma exacta de la salida: una lista, una tabla, JSON con campos con nombre, un límite de palabras.
  • Separá los bloques de material con marcadores bien distintos como ### o ===, para que los límites no se confundan.
  • Dá ejemplos cuando importa el formato: permiten que el modelo imite el formato, los términos y el tono, y hacen las respuestas más consistentes. Para salida estructurada, combiná una plantilla de formato con datos de ejemplo.

Ajustes que cambian el prompt

  • El razonamiento viene activado en Qwen3.8 Max, Qwen3.7 Plus y Qwen3.8 Flash. Apagalo con enable_thinking para respuestas rápidas, o limitalo con thinking_budget.
  • Modo JSON: con response_format json_object, la palabra 'JSON' tiene que aparecer en el prompt o el pedido falla. json_schema con strict obliga a respetar un esquema.
  • La búsqueda web es un parámetro (enable_search), no algo que se pide en el texto. En Qwen3.8 Max está disponible en las regiones de Pekín y Singapur.
  • Los tres aceptan texto, imagen y video con un contexto de 1M de tokens, así que entran documentos largos, pero decí qué parte importa.

Plantillas

Brief en seis partes

### Contexto
[lo que el modelo necesita saber]
### Objetivo
[la única tarea a completar]
### Estilo
[ej.: respuesta de un agente de soporte]
### Tono
[ej.: cálido, conciso]
### Audiencia
[quién lo lee y qué sabe ya]
### Respuesta
[formato exacto, ej. 3 párrafos cortos, máximo 120 palabras]
Se abre en el analizador con el prompt precargado.

Clasificación con ejemplos

Clasificá cada ticket de soporte como "billing", "bug" o "how-to". Devolvé JSON: [{"id": number, "label": string}].

Ejemplos:
"Me cobraron dos veces" -> billing
"El botón de exportar no hace nada" -> bug
"¿Cómo agrego a un compañero?" -> how-to

### Tickets
[pegá los tickets con su id]
###
Se abre en el analizador con el prompt precargado.

Preguntas frecuentes

¿Por qué falla mi pedido en modo JSON?
Con json_object, Model Studio exige que la palabra 'JSON' esté en el prompt. Agregala (por ejemplo, 'Devolvé JSON con estos campos…') o pasá a json_schema.
¿Hay un modelo de Qwen para código?
La documentación de Alibaba ahora recomienda el modelo general más reciente para código, así que usá Qwen3.8 Max o Qwen3.7 Plus con criterios de aceptación claros.