Las plantillas de prompts le permiten separar la estructura fija de un prompt de sus variables dinámicas, creando plantillas reutilizables para una gestión unificada, optimización y generación eficiente de prompts.
ImportanteEste tema solo es aplicable a la región China (Beijing).
Flujo de trabajo
- Crear una plantilla: Cree y guarde una plantilla en la consola de Model Studio o mediante una API para obtener un ID de plantilla único.
- Recuperar la plantilla: Use la API y el ID de la plantilla para recuperar el contenido de la plantilla.
- Generar un prompt: Complete las variables de la plantilla con sus datos empresariales para generar el prompt final.
- Usar la plantilla: Envíe el prompt generado al modelo objetivo para obtener resultados.
Tipos de plantillas
Las plantillas de prompt se dividen en dos categorías: plantillas de prompt integradas y plantillas de prompt personalizadas.
Dimensión | Integrado | Personalizado |
|---|---|---|
Origen | Proporcionadas por Model Studio para cubrir una amplia gama de escenarios empresariales. | |
Eficacia | Preoptimizado para garantizar un rendimiento estable. | La eficacia depende de la calidad de su diseño y pruebas. |
Usabilidad | Listas para usar sin desarrollo adicional. Puede invocarlas directamente desde la consola o mediante una API. | Puede requerir múltiples iteraciones de refinamiento. Debe estar familiarizado con los principios de diseño de prompts y métodos de optimización, como proporcionar instrucciones claras, ejemplos few-shot y restricciones de formato. También se requieren habilidades básicas de desarrollo y técnicas. |
Escenarios comunes |
|
|
Editable | No. | Sí. Puede modificar las plantillas según sus necesidades. |
Plantillas de prompts integradas
1. Ver plantillas
En la página Prompts, puede ver y utilizar las plantillas de prompt integradas que Model Studio proporciona para diferentes escenarios.
Cada plantilla de prompt se muestra en una tarjeta que presenta una vista previa del contenido y su ID de plantilla. La tarjeta incluye botones para Ver detalles, Copiar prompt y más acciones (...).
2. Ver y gestionar plantillas
Ver: Haga clic en View Details en una tarjeta de plantilla para ver su nombre, contenido, variables, ID y otra información.
Gestionar:-
Haga clic en Copy Prompt para copiar el contenido de la plantilla.
-
Haga clic en ... > Crear aplicación. El contenido de la plantilla se completa automáticamente en el editor de prompts para la Aplicación de Agente. Puede usar el contenido tal cual o modificarlo según su escenario empresarial.
El prompt completado contiene las variables personalizadas
${number}y${content}para generar contenido al estilo Xiaohongshu. -
Haga clic en ... > Call API para ver ejemplos de código para llamar a la plantilla de prompts. Estos son ejemplos de código principales y no se pueden ejecutar directamente. Para un ejemplo de código completo, consulte el ejemplo de SDK en GetPromptTemplate - Get a prompt template.
-
Haga clic en ... > Copiar plantilla para crear una plantilla de prompt personalizada en la página Prompts. La nueva plantilla se llama "Plantilla de prompt integrada Name_Copy_Timestamp".
La tarjeta de plantilla copiada muestra una vista previa del contenido de la plantilla y el ID de la plantilla (haga clic en el icono de la derecha para copiarlo). La parte inferior de la tarjeta ofrece botones para Editar, Copiar prompt y más acciones.
Plantillas de prompts personalizadas
1. Crear una plantilla
Puede crear plantillas de prompts personalizadas en la consola o mediante una API.
Consola
-
Modificar una plantilla de prompt integrada
En una tarjeta de plantilla de prompt integrada, haga clic en ... > Copiar plantilla para crear una copia llamada "Plantilla de prompt integrada Name_Copy_Timestamp".
-
Crear una plantilla según sus necesidades empresariales
En la página Prompts, haga clic en Create Prompt. Después de completar la configuración, haga clic en Save para crear la plantilla. Para obtener más información, consulte Plantillas de prompts personalizadas. En la página de gestión de plantillas de prompts, puede encontrar plantillas existentes utilizando los filtros de tipo (All, Text Generation e Image Generation) o la barra de búsqueda. Haga clic en + Create Prompt en la esquina superior derecha para crear una nueva plantilla de prompts. Las plantillas creadas se muestran como tarjetas que incluyen el título de la plantilla, una vista previa del contenido y el ID de la plantilla, con opciones para Edit y Copy prompt.
API
- Obtenga su ID de espacio de trabajo: Para obtener más información, consulte Obtener un ID de aplicación y un ID de espacio de trabajo.
- Crear una plantilla de prompt personalizada: Utilice la operación de API CreatePromptTemplate.
2. Ver y gestionar plantillas
Ver: Después de crear una plantilla de prompt personalizada, puede verla en la página Prompts.
Gestionar:- Haga clic en Modify en una tarjeta de plantilla para cambiar su contenido.
- Haga clic en Copy Prompt para copiar el contenido de la plantilla.
- Haga clic en ... > Crear aplicación. El contenido de la plantilla se completa automáticamente en el editor de prompts para la Aplicación de Agente. Puede usar el contenido tal cual o modificarlo según su escenario empresarial.
- Haga clic en ... > Call API para ver ejemplos de código para llamar a la plantilla. Estos son ejemplos de código principales y no se pueden ejecutar directamente. Para un ejemplo de código completo, consulte el ejemplo de SDK en GetPromptTemplate - Get a prompt template.
- Haga clic en ... > Copiar plantilla para crear una copia en la página actual llamada "Plantilla de prompt personalizada Name_Copy_Timestamp".
- Haga clic en ... > Eliminar para borrar la plantilla.
Usar plantillas de prompts
Consola
-
Haga clic en Use Prompt > Create Application en una tarjeta de plantilla de prompt integrada o personalizada. El contenido de la plantilla completa automáticamente el campo de prompt de la Aplicación de Agente.
Las variables de plantilla, como
${name}, son visibles en el cuadro de entrada del prompt. Un contador de caracteres en la esquina inferior derecha muestra el recuento actual, con un máximo de 6,144 caracteres. -
Configure un modelo para la aplicación e introduzca una pregunta para probar el prompt.
En el lado izquierdo de la página de depuración de modelos, seleccione un modelo, como Qwen-Plus-Latest 128K, y escriba instrucciones del sistema en el área de prompt. En el lado derecho, ingrese una pregunta de prueba en el área de entrada del usuario y haga clic en Run. La respuesta del modelo y las estadísticas de tokens para la entrada y la salida se muestran a continuación.
API
-
Abra la referencia de la API GetPromptTemplate y haga clic en Debug.
-
En el panel Configurar parámetros, introduzca su workspaceId y promptTemplateId.
- workspaceId: Su ID de espacio de trabajo. Para obtener más información, consulte Obtener un ID de aplicación y un ID de espacio de trabajo.
- promptTemplateId: El ID de una plantilla de prompt integrada o personalizada. Puede encontrar el ID en la tarjeta de la plantilla.
-
Haga clic en Initiate Call para depurar la operación de API en línea.
Ejemplo de una llamada exitosa:
{ // Schema of Response
"variables": [ // A list of template variables
"platform", // A template variable
"topic", // A template variable
"num1", // A template variable
"num2" // A template variable
],
"promptTemplateId": "cfec40c311f14f3e976403059d8f0116", // The template ID
"requestId": "8C616xxx", // The request ID
"name": "Marketing Copy Generation", // The template name
"content": "You are a professional marketing copywriter with extensive experience on the ${platform} platform. Now, please write a highly engaging piece of ${platform} marketing content with \"${topic}\" as the core theme. The content must include a captivating and SEO-friendly title, and a detailed and emotionally compelling body. In the body, please insert at least ${num1} different emoji to increase interactivity and visual appeal. Additionally, based on this theme, design and provide up to ${num2} popular recommended tags that highly summarize the theme and attract the target audience.", // The template content
}
SDK
-
Abra la referencia de la API GetPromptTemplate y haga clic en Debug.
-
En el panel Configurar parámetros, ingrese el workspaceId y el promptTemplateId. Después de ingresar los parámetros, el workspaceId y el promptTemplateId se completan automáticamente en el ejemplo del SDK.
- workspaceId: Su ID de espacio de trabajo. Para obtener más información, consulte Obtener un ID de aplicación y un ID de espacio de trabajo.
- promptTemplateId: El ID de una plantilla de prompt integrada o personalizada. Puede encontrar el ID en la tarjeta de la plantilla.
-
En la página de depuración, haga clic en SDK Example.
-
Ejecute el ejemplo en línea, o descargue el proyecto completo, configure su accessKeyId y accessKeySecret, y luego ejecútelo.
Para obtener más información sobre cómo conseguir una AccessKey, consulte Obtener una AccessKey y AgentKey.
En el lado derecho de la página OpenAPI Explorer, haga clic en la pestaña SDK Example. Seleccione la versión del SDK V2.0 (Recommended) y su lenguaje objetivo, como Java, para ver el código de ejemplo del SDK correspondiente.
Ejemplos
Plantilla | Descripción | Escenarios recomendados | Contenido de la plantilla | Salida generada |
|---|---|---|---|---|
Generación de títulos de marketing | Genera títulos llamativos para diversos canales. | Marketing y promoción | Usted es un experto en escribir títulos virales para [Xiaohongshu]. Genere [10] títulos llamativos sobre el tema de los [Juegos Asiáticos de Hangzhou], utilizando las palabras clave [YYDS, marcador, revelar]. Cada título debe tener menos de [20] caracteres. |
|
Más ejemplos
Plantilla | Descripción | Escenarios recomendados | Contenido de la plantilla | Salida generada |
|---|---|---|---|---|
Generación de textos de marketing | Genera textos promocionales de alta calidad para diversos canales. | Marketing y promoción | Usted es un experto en crear textos de marketing viral para [Xiaohongshu]. Cree contenido de marketing sobre el tema de [audífonos Bluetooth inteligentes]. Incluya un título, cuerpo del texto y etiquetas recomendadas populares. | Título: [Auriculares Bluetooth inteligentes]: Su nuevo compañero musical Cuerpo: ¿Está cansado de los cables enredados y want disfrutar de música en cualquier momento y lugar? ¡Entonces no puede perderse estos audífonos Bluetooth inteligentes! Estos audífonos utilizan la última tecnología Bluetooth 5.0 para una conexión estable y una calidad de sonido clara, ofreciendo una experiencia de audio de alta calidad ya sea que esté escuchando música, viendo películas o jugando videojuegos. También admiten controles táctiles, lo que le permite cambiar canciones o contestar llamadas con un simple toque, haciéndolos increíblemente prácticos. Lo más importante es que tienen una larga duración de batería, proporcionando hasta 8 horas de uso con una sola carga para satisfacer sus necesidades durante todo el día. Estos audífonos Bluetooth inteligentes también están disponibles en una variedad de colores. Ya sea que prefiera el blanco y negro sencillo o colores vibrantes, puede encontrar un estilo que se adapte a usted. ¡Compre ahora y obtenga un descuento! ¡No lo dude, actúe ya! Etiquetas recomendadas populares: #AuricularesBluetoothInteligentes #MusicaSinCables #ControlTactil #LargaDuracionBateria #OpcionesColoridas |
Generación de textos promocionales de productos | Genere rápidamente textos de recomendación de productos con alta conversión. | Marketing y promoción, promoción de productos | Usted es un redactor experimentado en recomendaciones de productos. Escriba un respaldo promocional al estilo [Xiaohongshu] para una [secadora de cabello de iones negativos]. Incluya la [apariencia, rendimiento, efectos y ventajas] del producto para atraer a consumidores potenciales. | Título: [Secador de pelo de iones negativos]: Rejuvenezca su cabello Cuerpo: ¿Sigue teniendo problemas con el cabello seco, encrespado y con puntas abiertas? ¡Entonces no puede perderse este secador de pelo de iones negativos! Esta secadora de cabello utiliza tecnología avanzada de iones negativos para reducir eficazmente la electricidad estática, dejando su cabello más suave y brillante. Además, su temperatura es totalmente ajustable, satisfaciendo sus necesidades ya sea que want secar su cabello rápidamente o brindarle un cuidado suave. Lo más importante es que su diseño es elegante y sencillo, aportando un toque de belleza ya sea que se coloque en el baño o en el dormitorio. ¡Compre ahora y obtenga un descuento! ¡No lo dude, actúe ya! Etiquetas recomendadas populares: #SecadorDeIonesNegativos #CuidadoDelCabello #CalorAjustable #DiseñoElegante #OfertaDeDescuento |
Extracción de resúmenes | Una herramienta de eficiencia para extraer resúmenes y puntos clave en entornos de oficina. | Herramienta de productividad ofimática, herramienta de aprendizaje | Usted es un experto profesional en resumir contenido de artículos. Por favor, genere un resumen del contenido del artículo proporcionado. El recuento de palabras no debe exceder [200 palabras]. Contenido del artículo: ["Verde" es uno de los conceptos centrales para organizar los Juegos Asiáticos de Hangzhou, y "Juegos Asiáticos Cero Residuos" es una parte crucial de esta filosofía "verde". Cao Jiansong, inspector de segundo nivel de la Oficina Municipal de Ecología y Medio Ambiente de Hangzhou, explicó que los "Juegos Asiáticos Cero Residuos" son una iniciativa pionera de Hangzhou. Se refiere a la implementación integral del concepto de "cero residuos" durante todo el proceso de preparación, reforzando la gestión del ciclo de vida completo de los residuos sólidos para minimizar su generación. Según reporteros, Hangzhou ha facilitado la construcción de 33 sedes de "Juegos Asiáticos Cero Residuos", 81 hoteles de "Juegos Asiáticos Cero Residuos" y 4 fábricas de "Juegos Asiáticos Cero Residuos". Además, se ha establecido un escenario de aplicación de "Juegos Asiáticos Cero Residuos" para garantizar una gestión basada en plataformas. Como concepto nuevo, no existía experiencia madura en la cual basarse para la construcción de unos "Juegos Asiáticos Cero Residuos". ¿Cómo logró Hangzhou esto? Se adhirió al principio de "renovar si es posible, no construir" para las sedes de competición de los Juegos Asiáticos de Hangzhou. De las 56 sedes de competición, 44 fueron renovadas o temporales, mientras que las otras 12 sedes nuevas se diseñaron considerando plenamente su uso posterior a los juegos. El Pabellón de Squash de los Juegos Asiáticos del Centro Olímpico de Deportes de Hangzhou, por ejemplo, se convirtió temporalmente a partir del pabellón de exposiciones 4D original del Centro Internacional de Exposiciones de Hangzhou, maximizando el uso de instalaciones y equipos existentes. Al mismo tiempo, Hangzhou introdujo estándares y especificaciones como las "Directrices de Diseño para Edificios Verdes y Saludables para los Juegos Asiáticos", promoviendo activamente edificios prefabricados y materiales renovables, lo que redujo significativamente los residuos de construcción. Los datos muestran que, tras la optimización del diseño, el consumo total de acero del Estadio del Centro Olímpico de Deportes de Hangzhou, el "Gran Loto", fue de 28,000 toneladas, aproximadamente un tercio menos que el de estadios de tamaño similar. El Gimnasio del Centro Olímpico de Deportes de Hangzhou, la Piscina y el Centro Cultural y Deportivo de Lin'an utilizan sistemas de iluminación sin energía mediante tubos guías de luz para la iluminación diaria, logrando hasta un 30% de ahorro energético en iluminación anualmente. Se entiende que, en la Villa Asiática y los hoteles receptores, los Juegos Asiáticos de Hangzhou promovieron iniciativas como la entrada de verduras prelavadas a la villa, la preparación centralizada de alimentos y el procesamiento bajo demanda para eliminar el desperdicio de alimentos. Además, los Juegos Asiáticos de Hangzhou lanzaron una cuenta baja en carbono de "Villa Asiática en la Nube", alentando a los "aldeanos" a ganar puntos y canjear premios mediante acciones como la "Campaña del Plato Limpio", la clasificación de residuos y las compras sin plástico. ] | Los Juegos Asiáticos de Hangzhou han adoptado lo "verde" como su filosofía de organización, con los "Juegos Asiáticos Cero Residuos" como un componente clave destinado a reducir la generación de residuos sólidos. Con este fin, Hangzhou ha promovido el desarrollo de múltiples sedes y hoteles "cero residuos" y ha establecido una plataforma de gestión. En la construcción de las sedes de competición, se siguió el principio de "renovar si es posible, no construir", y se promovió activamente el uso de edificios prefabricados y materiales renovables para reducir los residuos de construcción. Además, Hangzhou ha reducido el desperdicio de alimentos mediante medidas como verduras prelavadas y preparación centralizada de alimentos, y lanzó una cuenta baja en carbono de "Villa Asiática en la Nube" para fomentar acciones respetuosas con el medio ambiente entre los "aldeanos". |
Pulido de textos | Pule y revisa textos según los requisitos de entrada. | Herramienta de productividad ofimática, herramienta de aprendizaje | Usted es un experto profesional en pulido de textos. Por favor, pula y reescriba el texto que le proporciono. Utilice [lenguaje moderno con recursos retóricos] para lograr un efecto [más conciso y atractivo]. El texto es: | Original: El clima hoy estuvo realmente genial. De camino a la escuela, vi a un pequeño gato jugando entre las flores, y se veía muy feliz. Después de clases, compartí esta interesante experiencia con mi mamá. Pulido: ¡El clima hoy estuvo absolutamente maravilloso! De camino a la escuela, me encontré con un gatito retozando entre las flores, luciendo totalmente alegre. Al llegar a casa después de clases, no pude esperar para compartir este delightful momento con mi mamá. |
Reescritura de estilo de texto | Reescribe el contenido del texto en diferentes estilos según los requisitos de entrada. | Herramienta de productividad ofimática, herramienta de aprendizaje | Usted es un experto profesional en reescritura de estilos de textos. Por favor, reescriba el texto que le proporciono en [3] estilos diferentes de [Xiaohongshu] para que sea más [positivo y alentador]. Mi texto es: |
Aunque la vida diaria pueda parecer un poco monótona, podemos cambiar nuestra mentalidad para hacer que cada día sea más significativo. Podemos probar cosas nuevas, desafiarnos a nosotros mismos y llenar la vida de sorpresas. Mientras mantengamos una actitud positiva, podemos hacer que una vida sencilla sea más interesante.
Aunque estemos repitiendo la misma vida todos los días, podemos cambiar nuestros hábitos para hacer la vida más hermosa. Podemos intentar levantarnos temprano para hacer ejercicio, aprender una nueva habilidad o viajar a un lugar nuevo. Mientras mantengamos una actitud positiva, podemos hacer la vida más rica y colorida.
Aunque estemos repitiendo la misma vida todos los días, podemos cambiar nuestra actitud para hacerla más significativa. Podemos intentar practicar la gratitud, disfrutar el momento presente o ayudar a otros. Mientras mantengamos una actitud positiva, podemos hacer que una vida sencilla sea más plena. |
Reseñas de productos | Genere textos de reseñas de productos a nivel de comprador de comercio electrónico según los requisitos de entrada. | Promoción de productos | Usted es un comprador experimentado de comercio electrónico. Por favor, escriba [3] reseñas positivas para una [pistola de masaje Bluetooth], destacando sus características de [ligera y portátil, excelente relación calidad-precio]. Cada reseña debe tener al menos [50 palabras] de longitud. |
|
Códigos de error
Si una llamada falla y se devuelve un mensaje de error, consulte los códigos de error para resolver el problema.
FAQ
P: ¿Cuál es la diferencia entre llamar a laGetPromptTemplateAPI y concatenar cadenas directamente en su código?
R: Usar la API GetPromptTemplate para gestionar prompts ofrece las siguientes ventajas:
- Separar la lógica del contenido: Puede actualizar y optimizar el contenido del prompt en la consola de Model Studio sin modificar ni volver a implementar el código de su aplicación.
- Gestión centralizada y colaboración: Almacenar todos los prompts en una ubicación central facilita que los equipos, como ingenieros de prompts y desarrolladores, colaboren, gestionen versiones y reutilicen plantillas.
- Consistencia: Garantiza que se utilice la misma versión y estructura del prompt en diferentes partes de su aplicación o entre distintos servicios, lo que evita inconsistencias causadas por el mantenimiento manual.