Earth Engine 代码编辑器中的“提问”面板使用 Gemini 帮助您编写、理解、调试和优化脚本。它是一款对话式 AI 助理，直接集成到代码编辑器中，可简化地理空间分析和脚本开发。
界面和工具
AI 助理面板位于 Earth Engine 代码编辑器的右侧窗格中。如需打开该标签页，请点击检查器、控制台和任务标签页旁边的提问标签页。
“提问”窗格包含多个控件和工具，可帮助您管理与 AI 的互动。
按钮和控制
- 发送 / 停止：将提示发送给助理。生成过程中，该按钮会切换为停止图标，以便您取消请求。您也可以使用
enter/return键发送消息。 - 新对话：清除对话历史记录并开始新的会话。
- 帮助：打开一个对话框，其中包含有关该功能、结算和条款的信息。
- 模型选择：一个下拉菜单，可用于选择要使用的 Gemini 模型。某些模型可能无法使用，具体取决于您的 API 密钥的层级。系统会保存您的选择，以供您在下次会话中使用。
- 工具切换开关：一个菜单，可用于启用或停用供助理使用的特定工具。系统会保存您的选择，以供您在下次会话中使用。
- 复制（代码块）：将生成的代码复制到剪贴板。
- 插入（代码块）：将生成的代码插入到脚本编辑器中。如果编辑器不为空，则会显示一个差异对话框，其中突出显示了更改以供您查看。
- 重新生成：在最后一条回答的底部显示重试按钮，用于重新运行提示。
- 令牌计数器：显示当前对话会话中使用的令牌数量。您可以使用此功能来监控您的使用情况是否超出 API 密钥限额。
工具选项
您可以启用以下工具来改进助理的回答。请注意，启用工具会为您的请求添加额外的上下文（例如文档或搜索结果），这可能会导致令牌用量增加。
- 文档：搜索 Earth Engine 公共文档，以提供准确的代码和说明。
- 数据集搜索：在 Earth Engine Data Catalog 中搜索数据集。
- Google 搜索：根据 Google 搜索结果生成回答，提供来自网络的最新信息。请注意，Google 搜索工具无法与 Google 文档或数据集搜索工具同时使用。启用 Google 搜索后，界面中的其他工具会自动变为不可用。
前提条件
为了向模型发出请求，此功能会使用您自己的 Gemini API 密钥。
如何获取 Gemini API 密钥
您可以在 Google AI Studio 中创建或查看 Cloud 项目下的 Gemini API 密钥。
- 前往 Google AI Studio API 密钥。
- 点击创建 API 密钥，然后选择一个选项来创建密钥。
如需详细了解 Gemini API 密钥，请参阅 Gemini API 密钥文档。
在代码编辑器中配置 API 密钥
获得 API 密钥后，您必须将其添加到代码编辑器中：
- 在“向 Gemini 提问”面板中，点击聊天输入框中的钥匙图标。
- 将您的 API 密钥粘贴到随即显示的对话框中。
- 您可以选择勾选相应复选框，以保存密钥供日后会话使用，然后点击确定。
自动使用上下文
为了提供相关帮助，“向我提问”功能会在每次请求中自动包含以下上下文：
- 编辑器中当前脚本的全文。
- 所有导入的资产和几何图形。
- 当前会话的聊天记录。
排查控制台错误
AI 助理直接与代码编辑器的控制台集成，可帮助您快速解决运行时错误：
- 如果脚本遇到错误，请在控制台标签页中查找红色错误卡片。
- 点击错误卡片上的问题排查按钮。
- 系统会自动打开“提问”面板，并排队显示一条自动生成的提示消息，其中包含脚本中的错误消息和相关上下文，供您发送。
示例提示
您可以直接在聊天框中输入内容，让助理帮您完成各种任务。以下是一些您可以提出的问题示例，按任务类型分类：
代码生成和工作流
- “编写一个脚本，用于加载 2023 年东非的 Sentinel-2 影像，过滤云覆盖率低于 10% 的影像，计算 NDVI 中位数，并使用从白色到绿色的可视化调色板将其添加到地图中。”
- “Create a cloud-free Landsat 9 composite for summer 2024 in Central Europe and export it to my cloud storage bucket.”
Earth Engine 应用
- “编写代码以创建 Earth Engine 应用分屏地图，用于并排比较 2020 年和 2024 年的影像。”
- “在左侧添加一个面板，其中包含一个用于选择年份的下拉菜单和一个用于刷新地图的按钮。”
- “为显示的土地覆盖分类向地图添加自定义图例。”
调试
- “我收到‘用户内存限制超出’错误。如何解决此问题？"
- “我的地图显示了一个像素值没有差异的图层，这与我的预期不符，这是怎么回事？”
- “为什么我在运行此计算时会收到‘Image.select: Band 'NDVI' not found’错误？”
说明
- “解释一下
ee.Reducer.mean().combine()在我的脚本的第 15 行中执行的操作。” - “
ee.Image.clip()和ee.Image.mask()有什么区别？”
优化
- “您能否优化此图片集映射操作，使其运行得更高效？”
- “如何重写针对多个多边形和图片的
reduceRegions操作，以避免超时？”
结算和费用
使用此功能需要您自己的 Gemini API 密钥。费用取决于 Gemini API 价格和密钥的配额层级。
- 免费层级：Gemini API 提供免费层级（有使用限制）。
- 付费层级：如果您使用的是付费层级 API 密钥，无论您的具体 Earth Engine 项目注册情况如何，都会产生费用。
如需了解详情，请参阅 Gemini API 价格。
监控用量和控制费用
您可以直接在 AI Studio 中管理密钥，并查看用量和费用。
- 在 AI Studio 界面中查看 API 密钥的层级、用量、限额和支出。
- 在 AI Studio 的“支出”标签页中设置每月支出上限。
数据和隐私
我们会按照 Gemini API 服务条款处理您的数据。请务必查看这些政策，了解有关使用提示和生成内容的规定。
反馈
帮助我们改进吧！您可以随时点击代码编辑器右上角的“反馈”按钮来分享您的反馈。使用发送代码编辑器反馈选项。我们会积极阅读这些反馈，以改进模型性能并确定功能优先级。