Earth Engine 代码编辑器中的 AI 助理

Earth Engine 代码编辑器中的“提问”面板使用 Gemini 帮助您编写、理解、调试和优化脚本。它作为对话式 AI 助理直接集成到代码编辑器中,可简化您的地理空间分析和脚本开发。

界面和工具

AI 助理面板位于 Earth Engine 代码编辑器的右侧窗格中。如需打开该标签页,请点击检查器、控制台和任务标签页旁边的提问标签页。

“提问”窗格包含多个控件和工具,可帮助您管理与 AI 的互动。

按钮和控件

  • 发送/停止:将提示发送给助理。在生成过程中,该按钮会切换为停止图标,以便您取消请求。您也可以使用 enter / return 键发送。
  • 新对话:清除对话记录并开始新会话。
  • 帮助:打开一个对话框,其中包含有关功能、结算和条款的信息。
  • 模型选择:一个下拉菜单,可让您选择要使用的 Gemini 模型。某些模型可能无法运行,具体取决于您的 API 密钥层级。系统会保存您的选择,并在您下次访问时保持该设置。
  • 工具切换开关:一个菜单,可让您启用或停用特定工具,供助理使用。系统会保存您的选择,并在您下次访问时保持该设置。
  • 复制(代码块):将生成的代码复制到剪贴板。
  • 插入(代码块):将生成的代码插入到脚本编辑器中。如果编辑器不为空,则会显示一个差异对话框,其中会突出显示更改内容供您审核。
  • 重新生成:最后一个回答的底部会显示一个重试按钮,用于重新运行提示。
  • Token 计数器:显示当前对话会话中使用的 token 数量。使用此功能可根据 API 密钥限制监控您的用量。

工具选项

您可以启用以下工具来改进助理的回答。请注意,启用工具会为您的请求添加额外的上下文(例如文档或搜索结果),这可能会导致更多的 token 使用量。

  • 文档:搜索 Earth Engine 公共文档,以提供准确的代码和说明。
  • 数据集搜索:在 Earth Engine Data Catalog 中搜索数据集。
  • Google 搜索:在 Google 搜索结果中接地回答,以提供来自网络的最新信息。请注意,Google 搜索工具无法与 Google 文档或数据集搜索工具同时使用。启用 Google 搜索后,界面中的其他工具将自动变为不可用。

前提条件

此功能会使用您自己的 Gemini API 密钥向模型发出请求。

如何获取 Gemini API 密钥

您可以在 Google AI Studio 中的云项目下创建或查看 Gemini API 密钥。

  1. 前往 Google AI Studio API 密钥。
  2. 点击创建 API 密钥,然后选择一个选项来创建密钥。

如需详细了解 Gemini API 密钥,请参阅 Gemini API 密钥文档。

在代码编辑器中配置 API 密钥

获得 API 密钥后,您必须将其添加到代码编辑器中:

  1. 在“Ask”面板中,点击对话输入框中的钥匙图标。
  2. 将 API 密钥粘贴到显示的对话框中。
  3. (可选)选中相应复选框以保存密钥,以便在日后的会话中使用,然后点击确定。

自动使用上下文

为了提供相关帮助,“询问”功能会自动在每个请求中包含以下上下文:

  • 编辑器中当前脚本的全文。
  • 任何导入的资产和几何图形。
  • 当前会话的聊天记录。

排查控制台错误

AI 助理直接与代码编辑器的控制台集成,可帮助您快速解决运行时错误:

  1. 如果脚本遇到错误,请在控制台标签页中查找红色错误卡片。
  2. 点击错误卡片上的问题排查按钮。
  3. 这会自动打开“提问”面板,并排队显示一条自动生成的提示消息,其中包含出错提示和脚本中的相关上下文,供您发送。

示例提示

您可以直接在聊天框中输入内容,让助理帮助您完成各种任务。以下是一些您可以提出的问题示例,按任务分类:

代码生成和工作流

  • “编写一个脚本,加载 2023 年东非地区的 Sentinel-2 图像,过滤云量低于 10% 的图像,计算 NDVI 中位数,并使用从白色到绿色的可视化调色板将其添加到地图中。”
  • “为 2024 年夏季的中欧地区创建无云 Landsat 9 复合影像,并将其导出到我的 Cloud Storage 存储桶。”

Earth Engine 应用

  • “编写代码以创建 Earth Engine 应用分屏地图,并排比较 2020 年和 2024 年的影像。”
  • “在左侧添加一个面板,其中包含用于选择年份的下拉菜单和用于刷新地图的按钮。”
  • “为地图添加自定义图例,以显示土地覆盖分类。”

调试

  • “我收到了‘已超出用户记忆功能上限’错误。如何解决此问题?”
  • “我的地图显示了一个像素值没有变化的图层,这与我的预期不符,哪里出了问题?”
  • “Why am I getting the error 'Image.select: Band 'NDVI' not found' when running this calculation?”

说明

  • “解释一下 ee.Reducer.mean().combine() 在我的脚本第 15 行中执行的操作。”
  • “ee.Image.clip()和ee.Image.mask()有什么区别?”

优化

  • “Can you optimize this image collection map operation to run more efficiently?”
  • “如何重写此 reduceRegions 操作,使其在多个多边形和图片上运行,以避免超时?”

结算和费用

使用此功能需要您拥有自己的 Gemini API 密钥。费用取决于 Gemini API 价格和密钥的配额层级。

  • 免费层级:Gemini API 提供免费层级(有限制)。
  • 付费层级:如果您使用付费层级 API 密钥,无论您的具体 Earth Engine 项目注册情况如何,都会产生费用。

如需了解详情,请参阅 Gemini API 价格。

监控用量和控制费用

您可以直接在 AI Studio 中管理密钥并查看用量和费用。

  • 在 AI Studio 界面中查看 API 密钥的层级、用量、限额和支出。
  • 在 AI Studio 的“支出”标签页中设置每月支出上限。

数据和隐私

我们会按照《Gemini API 服务条款》处理您的数据。请务必查看这些条款,了解如何使用提示和生成的内容。

反馈

帮助我们改进吧!您可以随时点击代码编辑器右上角的反馈按钮,分享您的反馈。使用发送代码编辑器反馈选项。我们会积极阅读这些反馈,以提高模型性能并确定功能的优先级。