Assistente de IA no editor de código do Earth Engine

O painel "Perguntar" no Earth Engine Code Editor usa o Gemini para ajudar você a escrever, entender, depurar e otimizar seus scripts. Ele funciona como um assistente de IA conversacional integrado diretamente ao Code Editor para simplificar sua análise geoespacial e o desenvolvimento de scripts.

Interface e ferramentas

O painel do assistente de IA está localizado no painel à direita do Earth Engine Code Editor. Para abrir, clique na guia Perguntar ao lado das guias Inspetor, Console e Tarefas.

O painel "Perguntar" inclui vários controles e ferramentas para ajudar você a gerenciar sua interação com a IA.

Botões e controles

  • Enviar / Parar: envia seu comando ao assistente. O botão alterna para um ícone de parada enquanto a geração está em andamento, o que permite cancelar a solicitação. Você também pode usar a tecla enter / return para enviar.
  • Nova conversa: limpa o histórico de conversas e inicia uma nova sessão.
  • Ajuda: abre uma caixa de diálogo com informações sobre o recurso, o faturamento e os termos.
  • Seleção de modelo: um menu suspenso que permite escolher qual modelo do Gemini usar. Alguns modelos podem não funcionar dependendo do nível da sua chave de API. Sua seleção será salva para a próxima sessão.
  • Alternância de ferramentas: um menu que permite ativar ou desativar ferramentas específicas para o assistente usar. Sua seleção será salva para a próxima sessão.
  • Copiar (blocos de código): copia o código gerado para a área de transferência.
  • Inserir (blocos de código): insere o código gerado no editor de scripts. Se o editor não estiver vazio, ele mostrará uma caixa de diálogo de diferença que destaca as mudanças para sua revisão.
  • Regenerar: um botão de repetição aparece na parte de baixo da última resposta para executar o comando novamente.
  • Contador de tokens: mostra o número de tokens usados na sessão de conversa atual. Use isso para monitorar o uso em relação aos limites da chave de API.

Opções da ferramenta

Você pode ativar as seguintes ferramentas para melhorar as respostas do assistente. A ativação de ferramentas adiciona contexto extra (como documentação ou resultados da pesquisa) às suas solicitações, o que pode resultar em maior uso de tokens.

  • Documentos: pesquisa na documentação pública do Earth Engine para fornecer código e explicações precisos.
  • Pesquisa de conjuntos de dados: pesquisa conjuntos de dados no Data Catalog do Earth Engine.
  • Pesquisa Google: embasa as respostas nos resultados da Pesquisa Google para fornecer informações atualizadas da Web. Observação: a ferramenta Pesquisa Google não pode ser usada simultaneamente com a ferramenta Documentos ou Pesquisa de Datasets. A ativação da Pesquisa Google vai desativar automaticamente as outras ferramentas na interface.

Pré-requisitos

Para fazer solicitações ao modelo, esse recurso usa sua própria chave da API Gemini.

Como conseguir uma chave da API Gemini

Você pode criar ou visualizar chaves da API Gemini no seu projeto do Cloud em Google AI Studio.

  1. Acesse as chaves da API do Google AI Studio.
  2. Clique em Criar chave de API e selecione uma opção para criar sua chave.

Para mais informações sobre as chaves da API Gemini, consulte a documentação da chave da API Gemini.

Configurar a chave de API no Code Editor

Depois de ter a chave de API, adicione-a ao Code Editor:

  1. No painel "Perguntar", clique no ícone de chave na caixa de entrada do chat.
  2. Cole a chave de API na caixa de diálogo que aparece.
  3. Opcionalmente, marque a caixa para salvar a chave para sessões futuras e clique em OK.

Contexto automático

Para fornecer assistência relevante, o recurso "Perguntar" inclui automaticamente o contexto a seguir em cada solicitação:

  • O texto completo do script atual no editor.
  • Todos os recursos e geometrias importados.
  • O histórico de chat da sessão atual.

Resolver erros do console

O assistente de IA é integrado diretamente ao console do Code Editor para ajudar você a resolver rapidamente erros de execução:

  1. Se o script encontrar um erro, procure o card de erro vermelho na guia Console.
  2. Clique no botão Resolver problemas no card de erro.
  3. Isso abre automaticamente o painel "Perguntar" e enfileira uma mensagem de comando gerada automaticamente que contém a mensagem de erro e o contexto relevante do script para você enviar.

Exemplos de comandos

Você pode pedir ajuda ao assistente com várias tarefas digitando diretamente na caixa de chat. Confira alguns exemplos do que você pode pedir, categorizados por tarefa:

Geração de código e fluxos de trabalho

  • "Escreva um script para carregar imagens do Sentinel-2 para o ano de 2023 no leste da África, filtre a cobertura de nuvens com menos de 10%, calcule o NDVI mediano e adicione-o ao mapa com uma paleta de visualização de branco para verde."
  • "Crie um composto do Landsat 9 sem nuvens para o verão de 2024 na Europa Central e exporte-o para meu bucket do Cloud Storage."

Apps do Earth Engine

  • "Escreva um código para criar um mapa de painel dividido do app Earth Engine para comparar imagens de 2020 e 2024 lado a lado."
  • "Adicione um painel à esquerda com um menu suspenso para selecionar um ano e um botão para atualizar o mapa."
  • "Adicione uma legenda personalizada ao mapa para a classificação de cobertura da terra exibida."

Depuração

  • "Estou recebendo um erro de 'Limite de memória do usuário excedido'. Como posso resolver isso?"
  • "Meu mapa mostra uma camada sem variação nos valores de pixel, não é o que eu esperava. O que está errado?"
  • "Por que estou recebendo o erro 'Image.select: Band 'NDVI' not found' ao executar esse cálculo?"

Explicação

  • "Explique o que ee.Reducer.mean().combine() está fazendo na linha 15 do meu script."
  • "Qual é a diferença entre ee.Image.clip() e ee.Image.mask()?"

Otimização

  • "Você pode otimizar essa operação de mapa de coleta de imagens para ser executada com mais eficiência?"
  • "Como posso reescrever essa operação reduceRegions em muitos polígonos e imagens para evitar o tempo limite?"

Faturamento e custos

O uso desse recurso exige sua própria chave da API Gemini. Os custos estão sujeitos aos preços da API Gemini e ao nível de cota da sua chave.

  • Nível sem custo financeiro: a API Gemini oferece um nível sem custo financeiro (com limites).
  • Nível pago: se você usar uma chave de API de nível pago, ela vai gerar cobranças independentemente do registro específico do projeto do Earth Engine.

Para mais detalhes, consulte Preços da API Gemini.

Monitorar o uso e controlar os custos

Você pode gerenciar chaves e visualizar o uso e os custos diretamente no AI Studio.

  • Confira o nível, o uso, os limites e os gastos da sua chave de API na interface do AI Studio.
  • Defina um limite de gastos mensais na guia "Gastos" do AI Studio.

Dados e privacidade

Seus dados são tratados de acordo com os Termos de Serviço da API Gemini. Consulte-os sobre o uso de comandos e conteúdo gerado.

Feedback

Ajude a melhorar nossos serviços. Compartilhe seu feedback a qualquer momento clicando no botão de feedback no canto superior direito do Code Editor. Use a opção Enviar feedback do Code Editor. Lemos esse feedback ativamente para melhorar o desempenho do modelo e priorizar recursos.