O painel "Perguntar" no editor de código do Earth Engine usa o Gemini para ajudar você a escrever, entender, depurar e otimizar seus scripts. Ele funciona como um assistente de IA de conversação integrado diretamente ao Editor de Código para simplificar sua análise geoespacial e o desenvolvimento de scripts.
Interface e ferramentas
O painel do assistente de IA fica no painel direito do editor de código do Earth Engine. 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 o comando para o assistente. O botão se transforma em 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/returnpara 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âncias 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): adiciona o código gerado ao editor de scripts. Se o editor não estiver vazio, ele vai mostrar uma caixa de diálogo de diferença que destaca as mudanças para sua análise.
- Gerar novamente: um botão de nova tentativa aparece na parte de baixo da última resposta para executar o comando de novo.
- 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 ferramentas a seguir para melhorar as respostas do assistente. Ativar as ferramentas adiciona mais contexto (como documentação ou resultados da pesquisa) às suas solicitações, o que pode resultar em um maior uso de tokens.
- Documentos: pesquisa na documentação pública do Earth Engine para fornecer códigos e explicações precisos.
- Pesquisa de Datasets: 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. A ferramenta Pesquisa Google não pode ser usada simultaneamente com as ferramentas de pesquisa de documentos ou de conjuntos de dados. Ativar a 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 de API Gemini.
Como conseguir uma chave de API Gemini
É possível criar ou visualizar as chaves da API Gemini no seu projeto do Cloud no Google AI Studio.
- Acesse as chaves de API do Google AI Studio.
- Clique em Criar chave de API e selecione uma opção para criar sua chave.
Para mais informações sobre as chaves de API Gemini, consulte a documentação de chaves de API Gemini.
Configurar sua chave de API no Editor de Código
Depois de receber sua chave de API, adicione-a ao Editor de Código:
- No painel Perguntar, clique no ícone de chave na caixa de entrada da conversa.
- Cole a chave de API na caixa de diálogo que aparece.
- Se quiser, marque a caixa para salvar a chave para sessões futuras e clique em OK.
Contexto automático
Para oferecer assistência relevante, o recurso Perguntar inclui automaticamente o seguinte contexto 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 Editor de Código para ajudar você a resolver rapidamente erros de execução:
- Se o script encontrar um erro, procure o card de erro vermelho na guia Console.
- Clique no botão Resolver problemas no card de erro.
- Isso abre automaticamente o painel "Perguntar" e coloca em fila uma mensagem de comando gerada automaticamente com a mensagem de erro e o contexto relevante do seu script para você enviar.
Exemplos de comandos
Você pode pedir ajuda ao assistente para várias tarefas digitando diretamente na caixa de chat. Confira alguns exemplos do que você pode perguntar, categorizados por tarefa:
Geração de código e fluxos de trabalho
- "Escreva um script para carregar imagens do Sentinel-2 do ano de 2023 no leste da África, filtrar a cobertura de nuvens em menos de 10%, calcular o NDVI mediano e adicioná-lo ao mapa com uma paleta de visualização de branco para verde."
- "Crie uma composição do Landsat 9 sem nuvens para o verão de 2024 na Europa Central e exporte-a 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 do solo exibida."
Depuração
- "Estou recebendo o erro 'Limite de memória do usuário excedido'. Como solucionar isso?"
- Meu My Maps mostra uma camada sem variação nos valores de pixel. Não era isso que eu esperava. O que está acontecendo?
- "Por que recebo o erro 'Image.select: Band 'NDVI' not found' ao executar este 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()eee.Image.mask()?"
Otimização
- "Você pode otimizar esta operação de mapa de coleção de imagens para que ela seja executada de forma mais eficiente?"
- "Como posso reescrever essa operação
reduceRegionsem muitos polígonos e imagens para evitar o tempo limite?"
Faturamento e custos
Para usar esse recurso, você precisa da sua própria chave de 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, haverá 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 conferir o uso e os custos diretamente no AI Studio.
- Verifique o nível, o uso, os limites e os gastos da sua chave de API na interface do AI Studio.
- Defina um gasto máximo mensal na guia "Gastos" do AI Studio.
Dados e privacidade
Seus dados são processados de acordo com os Termos de Serviço da API Gemini. Revise-os sobre o uso de comandos e conteúdo gerado.
Feedback
Ajude a melhorar nossos serviços. Envie feedback quando quiser clicando no botão de feedback no canto superior direito do Editor de Código. Use a opção Enviar feedback do Editor de código. Lemos esse feedback para melhorar o desempenho do modelo e priorizar recursos.