Pensamiento de Gemini

Los modelos de la serie Gemini 2.5 usan un “proceso de pensamiento” interno durante la generación de respuestas. Este proceso contribuye a mejorar sus capacidades de razonamiento y los ayuda a usar la planificación de varios pasos para resolver tareas complejas. Esto hace que estos modelos sean especialmente buenos para la codificación, las matemáticas avanzadas, el análisis de datos y otras tareas que requieren planificación o pensamiento.

En esta guía, se muestra cómo trabajar con las capacidades de pensamiento de Gemini con la API de Gemini.

Usa modelos de pensamiento

Los modelos con capacidades de pensamiento están disponibles en Google AI Studio y a través de la API de Gemini. El pensamiento está activado de forma predeterminada en la API y en AI Studio, ya que los modelos de la serie 2.5 tienen la capacidad de decidir automáticamente cuándo y cuánto pensar en función de la instrucción. Para la mayoría de los casos de uso, es conveniente dejar de pensar. Sin embargo, si quieres apagar el pensamiento, puedes hacerlo configurando el parámetro thinkingBudget en 0.

Cómo enviar una solicitud básica

from google import genai

client = genai.Client(api_key="GOOGLE_API_KEY")
prompt = "Explain the concept of Occam's Razor and provide a simple, everyday example."
response = client.models.generate_content(
    model="gemini-2.5-flash-preview-04-17",
    contents=prompt
)

print(response.text)
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "GOOGLE_API_KEY" });

async function main() {
  const prompt = "Explain the concept of Occam's Razor and provide a simple, everyday example.";

  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash-preview-04-17",
    contents: prompt,
  });

  console.log(response.text);
}

main();
// import packages here

func main() {
  ctx := context.Background()
  client, err := genai.NewClient(ctx, option.WithAPIKey(os.Getenv("GOOGLE_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }
  defer client.Close()

  model := client.GenerativeModel("gemini-2.5-flash-preview-04-17")
  resp, err := model.GenerateContent(ctx, genai.Text("Explain the concept of Occam's Razor and provide a simple, everyday example."))
  if err != nil {
    log.Fatal(err)
  }
  fmt.Println(resp.Text())
}
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-preview-04-17:generateContent?key=$GOOGLE_API_KEY" \
 -H 'Content-Type: application/json' \
 -X POST \
 -d '{
   "contents": [
     {
       "parts": [
         {
           "text": "Explain the concept of Occam\''s Razor and provide a simple, everyday example."
         }
       ]
     }
   ]
 }'
 ```

Define un presupuesto en modelos de pensamiento

El parámetro thinkingBudget le indica al modelo la cantidad de tokens de pensamiento que puede usar cuando genera una respuesta. Por lo general, una mayor cantidad de tokens se asocia con un razonamiento más detallado, lo cual es necesario para resolver tareas más complejas. thinkingBudget debe ser un número entero entre 0 y 24,576. Establecer el presupuesto de pensamiento en 0 inhabilita el pensamiento.

Según la instrucción, el modelo puede desbordar o desbordar el presupuesto del token.

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash-preview-04-17",
    contents="Explain the Occam's Razor concept and provide everyday examples of it",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(thinking_budget=1024)
    ),
)

print(response.text)
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "GOOGLE_API_KEY" });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash-preview-04-17",
    contents: "Explain the Occam's Razor concept and provide everyday examples of it",
    config: {
      thinkingConfig: {
        thinkingBudget: 1024,
      },
    },
  });

  console.log(response.text);
}

main();
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash-preview-04-17:generateContent?key=$GOOGLE_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain the Occam\''s Razor concept and provide everyday examples of it"
        }
      ]
    }
  ],
  "generationConfig": {
    "thinkingConfig": {
          "thinkingBudget": 1024
    }
  }
}'

Usa herramientas con modelos de pensamiento

Puedes combinar el uso de los modelos de pensamiento con cualquiera de las herramientas y capacidades de Gemini para realizar acciones más allá de generar texto. Esto les permite interactuar con sistemas externos, ejecutar código o acceder a información en tiempo real, e incorporar los resultados en su razonamiento y respuesta final.

  • La herramienta de búsqueda permite que el modelo consulte los motores de búsqueda externos para encontrar información actualizada o información más allá de sus datos de entrenamiento. Esto es útil para preguntas sobre eventos recientes o temas muy específicos.

  • La herramienta de ejecución de código permite que el modelo genere y ejecute código de Python para realizar cálculos, manipular datos o resolver problemas que se manejan mejor con algoritmos. El modelo recibe el resultado del código y puede usarlo en su respuesta.

  • Con el resultado estructurado, puedes restringir Gemini para que responda con JSON, un formato de resultado estructurado adecuado para el procesamiento automatizado. Esto es muy útil para integrar la salida del modelo en las aplicaciones.

  • Las llamadas a funciones conectan el modelo de pensamiento con herramientas y APIs externas para que pueda razonar cuándo llamar a la función correcta y qué parámetros proporcionar.

Prácticas recomendadas

En esta sección, se incluye orientación para usar modelos de pensamiento de forma eficiente. Como siempre, sigue nuestra orientación sobre instrucciones y prácticas recomendadas para obtener los mejores resultados.

Depuración y control

  • Revisar el razonamiento: Cuando no obtienes la respuesta esperada de los modelos de pensamiento, puede ayudarte a analizar cuidadosamente el proceso de razonamiento de Gemini. Puedes ver cómo se desglosó la tarea y llegar a su conclusión, y usar esa información para corregir los resultados correctos.

  • Proporciona orientación en el razonamiento: Si esperas obtener un resultado particularmente extenso, es posible que desees brindar orientación en tu instrucción para limitar la cantidad de pensamiento que usa el modelo. Esto te permite reservar más salida del token para tu respuesta.

Complejidad de la tarea

  • Tareas fáciles (el pensamiento puede estar desactivado): Para las solicitudes directas, no se requiere un razonamiento complejo, como la recuperación o clasificación de hechos directos, no se requiere el pensamiento. Estos son algunos ejemplos:
    • "¿Dónde se fundó DeepMind?".
    • "¿Este correo electrónico solicita una reunión o solo proporciona información?"
  • Tareas intermedias (opción predeterminada o algo de pensamiento): Muchas solicitudes comunes se benefician de un grado de procesamiento paso a paso o de una comprensión más profunda. Gemini puede usar de forma flexible la capacidad de pensar para tareas como las siguientes:
    • Haz una analogía entre la fotosíntesis y el crecimiento.
    • Compara y contrasta los autos eléctricos y los híbridos.
  • Tareas difíciles (máxima capacidad de pensamiento): Para desafíos realmente complejos, la IA debe activar todas sus capacidades de razonamiento y planificación, lo que a menudo implica muchos pasos internos antes de proporcionar una respuesta. Estos son algunos ejemplos:
    • Resuelve el problema 1 del AIME 2025: calcula la suma de todas las bases de números enteros b > 9, cuya cantidad 17b es el divisor de 97b.
    • Escribir código de Python para una aplicación web que visualice datos del mercado de valores en tiempo real, incluida la autenticación de usuarios Haz que sea lo más eficiente posible.

Próximos pasos