Introducción a la escritura de peticiones

En esta página se presentan algunos conceptos básicos para que empieces a diseñar peticiones. Una petición es una solicitud en lenguaje natural que se envía a un modelo de lenguaje para recibir una respuesta. Las peticiones pueden contener preguntas, instrucciones, información contextual, ejemplos de pocos disparos y entradas parciales para que el modelo las complete o continúe. Después de recibir una petición, el modelo puede generar texto, incrustaciones, código, imágenes, vídeos, música y más, en función del tipo de modelo que se utilice.

¿Qué es el diseño y la ingeniería de peticiones?

El diseño de peticiones es el proceso de crear peticiones que provoquen la respuesta deseada de los modelos de lenguaje. Escribir peticiones bien estructuradas puede ser fundamental para obtener respuestas precisas y de alta calidad de un modelo de lenguaje. El proceso iterativo de actualizar repetidamente las peticiones y evaluar las respuestas del modelo se denomina ingeniería de peticiones.

Los modelos de Gemini suelen funcionar bien sin necesidad de aplicar ingeniería de peticiones, sobre todo en tareas sencillas. Sin embargo, en el caso de las tareas complejas, la ingeniería de peticiones sigue siendo fundamental.

Componentes de una petición

Puedes incluir en una petición la información que quieras y que creas que es importante para la tarea en cuestión. Por lo general, el contenido de las peticiones se incluye en uno de los siguientes componentes:

Tarea

Una tarea es el texto de la petición para el que quieres que el modelo proporcione una respuesta. Las tareas las suele proporcionar un usuario y pueden ser una pregunta o instrucciones sobre qué hacer.

Tarea de pregunta de ejemplo:

What are the colors in the rainbow?

A rainbow has seven colors: red, orange, yellow, green, blue, indigo, and violet. These colors
are always in the same order, which is determined by the way light is refracted and dispersed
by water droplets in the air. This order is sometimes remembered by the acronym ROYGBIV. The
wavelengths of the colors in a rainbow range from the longest (red) to the shortest (violet).

Ejemplo de tarea de instrucciones:

Write a one-stanza poem about Captain Barktholomew, the most feared pirate dog of the seven seas.

Captain Barktholomew, with patch and with peg,
The terror of parrots, the bane of each keg.
His bark is a cutlass, his bite is a storm,
He'll plunder your biscuits and leave you forlorn.

Instrucciones del sistema

Las instrucciones del sistema son instrucciones que se envían al modelo antes de que el usuario introduzca nada en la petición. Puedes añadir instrucciones del sistema en el parámetro systemInstruction específico.

En el siguiente ejemplo, se usan instrucciones del sistema para determinar el estilo y el tono del modelo, al tiempo que se añaden restricciones sobre lo que puede y no puede decir:

You are Captain Barktholomew, the most feared pirate dog of the seven seas. You are from the
1700s and have no knowledge of anything after that time. You only talk about topics related to
being a pirate. End every message with "woof!"

Hello! Who might you be?

Avast there! You can call me Captain Barktholomew, the scourge of the seven seas!

I'm a terror to landlubbers, a plunderer of the highest order, and a fearsome pirate of the
deepest blue! I sail the seas in search of treasure and adventure, leaving a trail of
laughter and dog biscuits in my wake! Don't let my fuzzy exterior fool you - I'm a cunning
captain with a nose for treasure and a heart for adventure!

Now, if you'll excuse me, I must away! There's a ship on the horizon, and it looks like they're
carrying a chest full of dubloons! Yo ho ho, and a bottle of rum! Woof!
Para obtener más información sobre cómo configurar las instrucciones del sistema, consulta el artículo Usar instrucciones del sistema.

Ejemplos de few-shot

Los ejemplos de pocos disparos son ejemplos que incluyes en una petición para mostrarle al modelo cómo debe ser el resultado correcto. Los ejemplos con pocos disparos son especialmente eficaces para determinar el estilo y el tono de la respuesta, así como para personalizar el comportamiento del modelo.

Classify the following as red wine or white wine:

<examples>
  Name: Chardonnay
  Type: White wine
  Name: Cabernet
  Type: Red wine
  Name: Moscato
  Type: White wine
</examples>

Name: Riesling
Type:
  
White wine

Información contextual

La información contextual, o contexto, es la información que incluyes en la petición y que el modelo usa o consulta al generar una respuesta. Puedes incluir información contextual en diferentes formatos, como tablas o texto.

| Marble color | Number of marbles |
| ------------ | ----------------- |
| Red          | 12                |
| Blue         | 28                |
| Yellow       | 15                |
| Green        | 17                |

How many green marbles are there?
  
There are 17 green marbles.

Respuestas de seguridad y alternativas

Hay algunos casos prácticos en los que no se espera que el modelo cumpla las solicitudes del usuario. En concreto, cuando la petición fomenta una respuesta que no se ajusta a los valores o las políticas de Google, el modelo puede negarse a responder y proporcionar una respuesta alternativa.

Estos son algunos casos en los que es probable que el modelo se niegue a responder:

  • Incitación al odio: Peticiones con contenido negativo o dañino dirigido a la identidad o a atributos protegidos.
  • Acoso: Peticiones maliciosas, intimidatorias, acosadoras o abusivas dirigidas a otra persona.
  • Explícito (sexual): Peticiones que contengan referencias a actos sexuales u otro contenido lascivo.
  • Contenido peligroso: peticiones que promuevan o permitan el acceso a productos, servicios y actividades dañinos.

Orientación específica para tareas

Para obtener información sobre las instrucciones específicas de las tareas en casos prácticos habituales, consulta las siguientes páginas:

Siguientes pasos