Asistente de IA en el Editor de código de Earth Engine

El panel Preguntar del editor de código de Earth Engine usa Gemini para ayudarte a escribir, comprender, depurar y optimizar tus secuencias de comandos. Actúa como un asistente de IA conversacional integrado directamente en el editor de código para optimizar tu análisis geoespacial y el desarrollo de secuencias de comandos.

Interfaz y herramientas

El panel del asistente de IA se encuentra en el panel de la derecha del editor de código de Earth Engine. Para abrirlo, haz clic en la pestaña Preguntar junto a las pestañas Inspector, Consola y Tareas.

El panel Preguntar incluye varios controles y herramientas para ayudarte a administrar tu interacción con la IA.

Botones y controles

  • Enviar / Detener: Envía tu instrucción al asistente. El botón cambia a un ícono de detener mientras se realiza la generación, lo que te permite cancelar la solicitud. También puedes usar la tecla enter / return para enviar.
  • Nuevo chat: Borra el historial de conversaciones y comienza una sesión nueva.
  • Ayuda: Abre un diálogo con información sobre la función, la facturación y las condiciones.
  • Selección de modelo: Un menú desplegable que te permite elegir qué modelo de Gemini usar. Es posible que algunos modelos no funcionen según el nivel de tu clave de API. Tu selección se guardará para la próxima sesión.
  • Interruptores de herramientas: Un menú que te permite habilitar o inhabilitar herramientas específicas para que las use el asistente. Tu selección se guardará para la próxima sesión.
  • Copiar (bloques de código): Copia el código generado en el portapapeles.
  • Insertar (bloques de código): Inserta el código generado en el editor de secuencias de comandos. Si el editor no está vacío, se muestra un diálogo de diferencias que destaca los cambios para que los revises.
  • Volver a generar: Aparece un botón de reintento en la parte inferior de la última respuesta para volver a ejecutar la instrucción.
  • Contador de tokens: Muestra la cantidad de tokens que se usaron en la sesión de conversación actual. Úsalo para supervisar tu uso en relación con los límites de tu clave de API.

Opciones de la herramienta

Puedes habilitar las siguientes herramientas para mejorar las respuestas del asistente. Ten en cuenta que habilitar herramientas agrega contexto adicional (como documentación o resultados de la búsqueda) a tus solicitudes, lo que puede generar un mayor uso de tokens.

  • Documentos: Realiza búsquedas en la documentación pública de Earth Engine para proporcionar código y explicaciones precisos.
  • Búsqueda de conjuntos de datos: Busca conjuntos de datos en el catálogo de datos de Earth Engine.
  • Búsqueda de Google: Fundamenta las respuestas en los resultados de la Búsqueda de Google para proporcionar información actualizada de la Web. Ten en cuenta que la herramienta de Búsqueda de Google no se puede usar de forma simultánea con las herramientas de búsqueda de Documentos o de conjuntos de datos. Si habilitas la Búsqueda de Google, las demás herramientas dejarán de estar disponibles automáticamente en la IU.

Requisitos previos

Para realizar solicitudes al modelo, esta función usa tu propia clave de la API de Gemini.

Cómo obtener una clave de la API de Gemini

Puedes crear o ver claves de la API de Gemini en tu proyecto de Cloud en Google AI Studio.

  1. Ve a Claves de API de Google AI Studio.
  2. Haz clic en Crear clave de API y selecciona una opción para crear tu clave.

Para obtener más información sobre las claves de la API de Gemini, consulta la documentación de las claves de la API de Gemini.

Configura tu clave de API en el editor de código

Una vez que tengas tu clave de API, debes agregarla al Editor de código:

  1. En el panel Preguntar, haz clic en el ícono de llave que se encuentra en la casilla de entrada del chat.
  2. Pega tu clave de API en el diálogo que aparece.
  3. De manera opcional, marca la casilla para guardar la clave para sesiones futuras y haz clic en Aceptar.

Contexto automático

Para brindar asistencia pertinente, la función Pregúntale incluye automáticamente el siguiente contexto con cada solicitud:

  • Es el texto completo de tu secuencia de comandos actual en el editor.
  • Todos los recursos y las geometrías importados
  • Historial de chat de la sesión actual.

Soluciona problemas de errores de la consola

El asistente de IA se integra directamente en la consola del editor de código para ayudarte a resolver rápidamente los errores de tiempo de ejecución:

  1. Si tu secuencia de comandos encuentra un error, busca la tarjeta de error roja en la pestaña Consola.
  2. Haz clic en el botón Solucionar problemas en la tarjeta de error.
  3. Esto abre automáticamente el panel Preguntar y pone en cola un mensaje de instrucción generado automáticamente que contiene el mensaje de error y el contexto pertinente de tu secuencia de comandos para que lo envíes.

Ejemplos de instrucciones

Puedes pedirle al asistente que te ayude con una variedad de tareas escribiendo directamente en el cuadro de chat. Estos son algunos ejemplos de lo que puedes preguntar, categorizados por tarea:

Generación y flujos de trabajo de código

  • "Escribe un script para cargar imágenes de Sentinel-2 del año 2023 sobre África Oriental, filtra la cobertura de nubes inferior al 10%, calcula el NDVI medio y agrégalo al mapa con una paleta de visualización de blanco a verde".
  • "Crea un composite de Landsat 9 sin nubes para el verano de 2024 en Europa Central y expórtalo a mi bucket de Cloud Storage".

Apps de Earth Engine

  • "Escribe código para crear un mapa de panel dividido de la app de Earth Engine y comparar imágenes de 2020 y 2024 una al lado de la otra".
  • "Agrega un panel a la izquierda con un menú desplegable para seleccionar un año y un botón para actualizar el mapa".
  • "Agrega una leyenda personalizada al mapa para la clasificación de la cobertura del suelo que se muestra".

Depuración

  • “Aparece el error ‘Se excedió el límite de memoria del usuario’. ¿Cómo puedo resolver este problema?"
  • "Mi mapa muestra una capa sin variaciones en los valores de píxeles. Esto no es lo que esperaba. ¿Qué está sucediendo?"
  • "¿Por qué recibo el error "Image.select: Band 'NDVI' not found" cuando ejecuto este cálculo?"

Explicación

  • "Explica qué hace ee.Reducer.mean().combine() en la línea 15 de mi secuencia de comandos".
  • "¿Cuál es la diferencia entre ee.Image.clip() y ee.Image.mask()?"

Optimización

  • "¿Puedes optimizar esta operación de mapa de recopilación de imágenes para que se ejecute de manera más eficiente?".
  • "¿Cómo puedo reescribir esta operación reduceRegions para que se ejecute en muchos polígonos e imágenes sin que se agote el tiempo de espera?"

Facturación y costos

Para usar esta función, necesitas tu propia clave de la API de Gemini. Los costos están sujetos a los precios de la API de Gemini y al nivel de cuota de tu clave.

  • Nivel gratuito: La API de Gemini ofrece un nivel gratuito (con límites).
  • Nivel pagado: Si usas una clave de API de nivel pagado, se generarán cargos independientemente del registro específico de tu proyecto de Earth Engine.

Para obtener más detalles, consulta Precios de la API de Gemini.

Supervisa el uso y controla los costos

Puedes administrar las claves y ver el uso y los costos directamente en AI Studio.

  • Verifica el nivel, el uso, los límites y la inversión de tu clave de API en la interfaz de AI Studio.
  • Establece un límite de inversión mensual en la pestaña Inversión de AI Studio.

Datos y privacidad

Tus datos se manejan de conformidad con las Condiciones del Servicio de la API de Gemini. Asegúrate de revisar las políticas sobre el uso de instrucciones y el contenido generado.

Comentarios

Ayúdanos a mejorar. Para compartir tus comentarios en cualquier momento, haz clic en el botón de comentarios que se encuentra en la esquina superior derecha del editor de código. Usa la opción Enviar comentarios sobre el editor de código. Leemos activamente estos comentarios para mejorar el rendimiento del modelo y priorizar las funciones.