Chuleta de herramientas Gemini: app, Workspace, API y CLI

Gemini aparece como una aplicación de chat, un panel lateral dentro de Google Workspace, una API y un agente de terminal. Los nombres se superponen y los ids de modelo no. Esta chuleta lista solo características confirmadas en las propias páginas de Google en octubre de 2026, luego las llamadas que puedes pegar.

Aplicación de Gemini

Tienes que estar autenticado en gemini.google.com. Las páginas de ayuda dicen que una cuenta de trabajo o escuela también necesita que un administrador permita la característica que deseas.

Gems

Abre la barra lateral, abre Gems y elige New Gem. Si nunca has hecho uno, la página de ayuda te guía a través de Settings y ayuda, luego Gems, primero. Dale un nombre e instrucciones. En Knowledge, Add files puede cargar desde el dispositivo, desde Drive o desde un notebook de NotebookLM. Los archivos de Drive necesitan Keep Activity activado y Workspace conectado a Gemini Apps. Un archivo de Drive se lee desde su versión actual, por lo que una edición posterior se muestra en el Gem. Guarda. Un Gem que creas en la web también aparece en la aplicación móvil y en el panel lateral de Workspace.

Los Gems no se pueden usar con Gemini Live. El Gem de Learning coach no cubre aprendizaje de idiomas. A partir de noviembre de 2026, los Gems en cuentas personales de Google se mueven a habilidades. Deshabilitar citas de conocimiento desactiva las citas para los archivos del Gem y para los archivos cargados en ese chat.

Deep Research

En la computadora, abre gemini.google.com, usa Add Files, luego Deep Research. Puedes adjuntar archivos de la misma manera que un prompt normal. Sources es un control separado. Google Search se incluye a menos que lo desactives. Gmail, Drive y otros servicios de Google aparecen cuando la aplicación Workspace está conectada. Puedes agregar notebooks de NotebookLM. Escribe la pregunta, envía y Gemini escribe un plan. Edita el plan si el alcance es incorrecto, luego Start research. Abre el informe cuando esté listo.

Un informe generalmente toma alrededor de 5 a 10 minutos, más cuando la pregunta es más pesada. Puedes dejar el chat. La aplicación web marca el hilo cuando está listo. La aplicación móvil puede notificarte. Un plan de Google AI Ultra puede agregar gráficos, diagramas y simuladores. Esta chuleta no lista precios de Ultra.

Canvas

Add Files, luego Canvas, luego un prompt que nombre el formato (documento, diapositivas, aplicación o código). Puedes adjuntar un archivo o una imagen primero. Las ediciones se guardan automáticamente. Puedes convertir el resultado en una Audio Overview o un cuestionario. Code, Show console y Show recent changes se encuentran en la parte superior del panel. Select and ask destaca una región. Add Gemini features, para usuarios autenticados mayores de 18 años, pone generación de texto o imagen dentro de una aplicación Canvas.

Archivos, imágenes y código

Add files, luego Upload Files. Una carpeta de código está en More Uploads, Import Code, Upload folder. Un repositorio de GitHub es la misma ruta Import Code, usando la URL del repositorio o rama. Drive es Add from Drive, con las mismas reglas de actividad y conexión de Workspace que Gems. Los notebooks están bajo More Uploads.

Límites de esa página de ayuda, a partir de octubre de 2026:

Si el análisis falla, carga el archivo de nuevo. Los hábitos de prompting que se transfieren desde productos de chat están en la chuleta de prompting de ChatGPT. Una segunda herramienta de investigación es Perplexity para investigación técnica.

No había un menú de aplicación de Gemini llamado Extensions en las páginas de ayuda leídas en octubre de 2026. Canvas es el lugar documentado para crear una aplicación. Las extensiones de terminal están bajo CLI de Gemini a continuación.

Gemini en Google Workspace

Abre Ask Gemini, generalmente en la esquina superior derecha. En Docs, alterna entre el panel lateral y la barra inferior. Elige un prompt sugerido o escribe uno. En Gmail, el mismo control redacta o revisa correos. La ayuda de Docs dice que necesitas un Workspace elegible o un plan de Google AI, y el soporte de idiomas varía. Una actualización o cierre del documento borra el historial del panel lateral de Docs. Inserta el texto que necesitas mantener.

La lista de características de Workspace coloca ese panel lateral en Gmail, Docs, Sheets, Slides, Drive y Chat, y también nombra Help me write y Meet notes. Tu edición puede no incluir cada fila. Si Ask Gemini in Chat está activado, la página de aprendizaje dice que se elimina el panel lateral. Los Gems de la aplicación de Gemini aparecen en el panel lateral de Workspace.

Inicio rápido de la API de Gemini

Los docs de la API dicen que la API de Interactions ha sido la predeterminada desde junio de 2026. generateContent aún funciona y está marcada como heredada. Usa Interactions para un nuevo script. El SDK oficial es google-genai (Disponibilidad general a partir de mayo de 2025). El paquete anterior google-generativeai no se mantiene. La página de librerías dice que las librerías heredadas fueron deprecadas a partir del 30 de noviembre de 2025.

Crea una clave en Google AI Studio. Los nuevos usuarios obtienen un proyecto y una clave. De lo contrario, usa Create API key en la página de claves de API. La guía de inicio te dice que la exportes:

pip install -U google-genai
export GEMINI_API_KEY="YOUR_API_KEY"

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="List three checks before you restart a production Deployment. Keep each check to one sentence.",
)
print(interaction.output_text)

Client() sin argumentos lee GEMINI_API_KEY. La muestra de inicio usa gemini-3.8-flash. La muestra de la página de inicio de la API usa gemini-4-argon para una explicación breve. Ambos ids están en la página de modelos. El paquete de JavaScript es @google/genai.

La guía de inicio dice que un nivel pagado aumenta los límites de velocidad y necesita Cloud Billing. A partir de esa página en octubre de 2026, el mínimo pagado que nombra es $5, o la misma cantidad en tu moneda. El uso está bajo Dashboard, luego Usage, en AI Studio. Esta chuleta no copia el resto de la lista de precios.

Los agentes, la llamada de herramientas y un agente administrado son superficies de API separadas en el mismo sitio de docs. Cómo un agente difiere de una llamada de interactions.create está en qué es IA agentiva. El cableado de herramientas sobre el Model Context Protocol está en servidores MCP explicados. Un agente de codificación de terminal de otro proveedor es la chuleta de Claude Code.

Alineación de modelos a partir de octubre de 2026

La página de modelos fue actualizada por última vez el 22 de octubre de 2026. Los ids estables son los que debes fijar. Una vista previa se puede facturar y se puede deprecar con al menos dos semanas de aviso. Un alias latest puede cambiar debajo de ti. Un id experimental no es un predeterminado de producción.

También en esa página, y vale la pena fijar desde la página misma la semana que envíes: gemini-3.6-flash, gemini-3.1-flash-lite, modelos de imagen Nano Banana 2.1 (gemini-nano-banana-2.1), Nano Banana 2 (gemini-3.1-flash-image), Nano Banana 2 Lite (gemini-3.1-flash-lite-image), Nano Banana Pro (gemini-3-pro-image) y modelo de video Gemini Omni Flash (gemini-omni-1.1-flash). Gemini 2.5 Pro, Flash y Flash-Lite (gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite) permanecen activos para cuentas que ya los usaron. No están deprecados. Los nuevos proyectos deben usar 3.5 Flash-Lite o 3.8 Flash. Varios ids 2.0 están marcados como cerrados. No los revivas de un gist antiguo.

CLI de Gemini

El README en google-gemini/gemini-cli aún lo llama un agente de terminal de código abierto. También dice, en una nota en la parte superior, que el 18 de junio de 2026, CLI de Gemini fue reemplazada por CLI de Antigravity para usuarios de nivel gratuito y Google One, y que CLI de Gemini no ha sido optimizada para Gemini 4 Argon. Instálalo solo si esa nota coincide con tu cuenta.

npx @google/gemini-cli
npm install -g @google/gemini-cli
brew install gemini-cli

Canal estable: npm install -g @google/gemini-cli@latest. Vista previa: @preview. Nightly: @nightly.

Opciones de autenticación que el README lista:

gemini
gemini -m gemini-2.5-flash
gemini -p "Summarize the failing test in this repo" --output-format json
gemini --include-directories ../lib,../docs

El propio ejemplo de -m del README es gemini-2.5-flash. Prefiere gemini-3.8-flash cuando CLI lo acepta. --output-format json es para scripts. --output-format stream-json es eventos delimitados por saltos de línea. Los servidores MCP van en ~/.gemini/settings.json. gemini extensions install toma una URL de GitHub o una ruta local. Las cuotas de nivel gratuito no se copian aquí. El README envió usuarios no pagados a Antigravity en lugar de listar un número.

Patrones que reutilizarás

• Nueva aplicación de Python: google-genai, Interactions, gemini-3.8-flash o gemini-4-argon, solo clave en el entorno.
• Prompt de equipo repetible: un Gem con instrucciones y un archivo de Drive, hasta el movimiento de habilidades de noviembre de 2026 en cuentas personales.
• «Lee todo y escribe un informe»: Deep Research, luego edita el plan antes de Start research.
• Una herramienta de un archivo o un documento corto: Canvas, luego exporta o copia el resultado del panel para que una actualización no pueda comerse el historial del panel lateral de Docs.
• Borrador de Workspace: Ask Gemini en Gmail o Docs, luego inserta el texto. No dejes la única copia en el panel lateral.
• Investigación que debes citar: Deep Research o Perplexity, luego abre los enlaces.
• Bucle de terminal en un repositorio: CLI de Gemini o CLI de Antigravity, dependiendo de la nota del 18 de junio de 2026 en el README. Las herramientas de MCP son el punto de extensión. Ve servidores MCP explicados.
• Fijación de producción: un id de modelo estable de la tabla anterior, no gemini-flash-latest.

Preguntas frecuentes

¿Cómo llamo a la API de Gemini desde Python en un nuevo proyecto?

Instala google-genai, crea una clave API en Google AI Studio y expórtala como GEMINI_API_KEY. La guía de inicio usa la API de interacciones: genai.Client() luego client.interactions.create con un id de modelo y una cadena de entrada. A partir de junio de 2026, esa guía llama a Interactions la predeterminada. generateContent es la superficie heredada.

¿Qué modelo de Gemini debe usar una nueva app?

La página de modelos, actualizada por última vez el 22 de octubre de 2026, apunta el nuevo trabajo a modelos actuales como gemini-3.8-flash o gemini-4-argon. Dice que los modelos Gemini 2.5 permanecen disponibles para las personas que ya los usaron, e indica a nuevos proyectos que usen 3.5 Flash-Lite o 3.8 Flash en su lugar. Fija un id estable. No envíes en un alias latest a menos que aceptes intercambios de modelo silenciosos.

¿Cuál es la diferencia entre un Gem y Deep Research?

Un Gem es un nombre guardado, instrucciones y archivos de conocimiento opcionales que reutilizas desde la lista de Gems. Deep Research construye un plan, luego un informe de fuentes que seleccionas, incluyendo Google Search de forma predeterminada. La página de ayuda de Gems dice que a partir de noviembre de 2026, los Gems en cuentas personales de Google se mueven a habilidades.

¿Sigue siendo CLI de Gemini la herramienta de terminal para instalar?

El README de CLI de Gemini aún documenta npm install -g @google/gemini-cli y una GEMINI_API_KEY de AI Studio. El mismo README dice que el 18 de junio de 2026, CLI de Gemini fue reemplazada por CLI de Antigravity para usuarios de nivel gratuito y Google One, y que CLI de Gemini no está optimizada para Gemini 4 Argon. Lee esa nota antes de estandarizarla.