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 密钥。
- 前往 Google AI Studio API 密钥。
- 点击创建 API 密钥,然后选择一个选项来创建密钥。
如需详细了解 Gemini API 密钥,请参阅 Gemini API 密钥文档。
在代码编辑器中配置 API 密钥
获得 API 密钥后,您必须将其添加到代码编辑器中:
- 在“Ask”面板中,点击对话输入框中的钥匙图标。
- 将 API 密钥粘贴到显示的对话框中。
- (可选)选中相应复选框以保存密钥,以便在日后的会话中使用,然后点击确定。
自动使用上下文
为了提供相关帮助,“询问”功能会自动在每个请求中包含以下上下文:
- 编辑器中当前脚本的全文。
- 任何导入的资产和几何图形。
- 当前会话的聊天记录。
排查控制台错误
AI 助理直接与代码编辑器的控制台集成,可帮助您快速解决运行时错误:
- 如果脚本遇到错误,请在控制台标签页中查找红色错误卡片。
- 点击错误卡片上的问题排查按钮。
- 这会自动打开“提问”面板,并排队显示一条自动生成的提示消息,其中包含出错提示和脚本中的相关上下文,供您发送。
示例提示
您可以直接在聊天框中输入内容,让助理帮助您完成各种任务。以下是一些您可以提出的问题示例,按任务分类:
代码生成和工作流
- “编写一个脚本,加载 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 服务条款》处理您的数据。请务必查看这些条款,了解如何使用提示和生成的内容。
反馈
帮助我们改进吧!您可以随时点击代码编辑器右上角的反馈按钮,分享您的反馈。使用发送代码编辑器反馈选项。我们会积极阅读这些反馈,以提高模型性能并确定功能的优先级。