使用 Genie Code

Genie Code 可帮助开发人员在Azure Databricks笔记本、SQL 编辑器、作业、AI/BI 仪表板和文件编辑器中生成、优化、解释和修复代码。 使用聊天模式进行说明和快速代码生成，以及代理模式（默认值），让 Genie Code 自主规划和完成多步骤任务。

若要了解 Genie Code 如何帮助代码，请参阅 从 Genie Code 获取编码帮助。

Genie Code 窗格导览

若要打开“Genie 代码”窗格，请单击页面右上角的 。

在窗格底部的文本框中输入提示，然后按 Enter 或单击“ 您可以：

• 单击 加号图标，以连接到 MCP 服务器或附加文件。
• 单击或输入@，以选择供 Genie Code 参考的资源。
• 输入 / 以选择并运行 斜杠命令。

如果提示 Genie Code 帮助处理代码，则它会引导你完成运行、接受或拒绝建议的更改。

将多个线程用作选项卡

“Genie Code”窗格会将已打开的聊天会话以选项卡的形式显示在窗格顶部。 您可以同时运行多个任务，并在线程之间切换而不会丢失当前位置。

• 切换线程：单击选项卡使该线程处于活动状态。 切换选项卡时，线程在后台保持运行，因此可以在一个线程中启动长任务，并继续在另一个线程中工作。
• 打开新线程：单击“ 新聊天 以在新选项卡中启动线程。
• 重新打开过去的线程：单击 线程历史记录 并选择一个线程以在选项卡中打开它。
• 管理线程：使用活动标签页上的 汉堡菜单来管理线程，或点击 关闭标签页。

Genie Code 窗格控件

Genie Code 窗格的标题栏包含以下控件：

Control	Description
新建聊天	在新选项卡中启动新线程。
线程历史记录	查看过去的聊天线程，并在选项卡中重新打开一个。
更多	打开 设置和其他选项。 请参阅 Genie Code 设置。
关闭	折叠 Genie Code 窗格。

Genie Code 设置

若要打开 Genie Code 设置，请单击 窗格标题中的“更多”菜单，然后单击“设置 设置面板包括以下内容：

聊天和代理模式

Genie Code 有两种运行模式：Chat，用于快速提问和生成代码；Agent，用于自主执行多步骤工作流。 代理模式为默认值。

若要在模式之间切换，请使用 Genie Code 窗格底部的模式选择器：

下表总结了两种 Genie Code 模式：

Genie Code 根据模式将不同的数据发送到模型：

• 聊天模式 会发送提示和相关元数据，例如表名和列名、说明以及正在使用的代码。 它不会发送你表格中的数据。
• 代理模式 还可以从表读取数据示例并分析单元输出以完成多步骤任务。

发送到模型的所有数据都会遵循您在 Unity Catalog 中的权限设置。 有关每个模式发送的内容的详细信息，请参阅 隐私和安全常见问题解答。

完整页面 Genie Code （Beta）

Genie Code 提供完整的全页式命令中心体验，其中当前线程会被突出显示，并在需要时以标签页形式在其旁边展示笔记本和文件等资源。 请参阅 完整页面 Genie Code。

批准工具操作

当 Genie Code 需要使用工具（如运行代码、编辑笔记本或查询表）时，它会要求你批准，然后再继续。 可以单独批准每个请求，或设置适用于当前线程的其余部分或所有未来线程的审批模式。

批准单个请求

当 Genie Code 请求使用工具的权限时，单击“ 允许 ”批准该操作或 跳过 以拒绝它。

若要更改 Genie Code 处理当前线程中未来审批请求的方式，请从同一提示中选择以下项之一：

设置默认审批模式

若要将相同的审批模式应用于每个 Genie Code 线程，请设置 Genie Code 设置中的默认值。 单击 在“Genie 代码”窗格标题中打开设置。

选择下列选项之一：

• 先询问：在每个工具运行时进行批准。 按工具设置的覆盖规则仍然有效。

• 自动批准：AI 分类器会根据说明的意向评审每个建议的操作，并批准或阻止每个操作，同时最大程度地减少手动审批，同时阻止有风险的操作。

  重要

  自动批准是生产力功能，而不是安全边界。 该分类器是一种尽力而为的启发式方法，可能会出错。 它可以批准不安全的操作或阻止安全操作。 不要依赖它来强制实施安全、合规性或访问控制要求。 在处理生产数据、敏感工作区或共享资源时，请保持自动批准功能关闭，因为这些场景中错误批准的后果可能非常严重。 你仍负责查看 Genie Code 的结果。

当自动批准功能开启时，Genie Code 通常允许执行低风险操作，例如只读查询、编辑您自己的工作区文件和笔记本、向您拥有的表写入数据，以及运行您已引用的作业或管道。 它阻止可能会升级范围或影响共享资源的任何内容，例如破坏性操作、生产部署、权限和机密更改、对第三方的外部调用，以及强制推送等有风险的源代码管理操作。

当操作被阻止时，Genie Code 会接收原因并进行调整，例如，使用更窄的范围重试。

共享聊天线程

可以与其他用户、组或服务主体共享 Genie Code 聊天线程。

要分享聊天线程：

1. 在 Genie Code 窗格中，单击“线程历史记录”，打开聊天记录。

2. 将鼠标悬停在要共享的聊天线程上，然后单击

3. 单击“ 共享。

4. 在共享对话框中，添加要与之共享的用户、组或服务主体。 收件人获得对聊天线程的“可以查看”权限。 请参阅 Genie Code 聊天的 ACL。

5. （可选）检查 电子邮件新用户 以向新添加的用户发送电子邮件通知。

6. （可选）若要共享聊天线程的直接链接，请单击“共享对话框底部的复制链接。

7. 单击“ 添加” 以共享对话。

获取有关代码的帮助

直接在你的代码笔记本中从 Genie Code 获取编程帮助。 Genie Code 提供：

• 使用 Genie Code 进行数据科学 ，帮助你规划和自动执行多步骤数据科学工作流。
• 基于 AI 的自动完成。
• 使用自然语言提示筛选数据。
• 使用“诊断错误”进行代码调试。
• 快速修复，其中提供了修复可 接受和运行的代码错误的自动建议。
• 无服务器代码执行。

在运行 Genie Code 之前，用户应始终查看 Genie Code 生成的任何代码，因为它有时可能会出错。

有关 Genie Code 如何帮助代码的详细信息，请参阅 从 Genie Code 获取编码帮助。

针对Azure Databricks环境优化的代码

Genie Code 生成的代码旨在在 Databricks 计算环境中运行。 它经过优化，可在 Databricks 支持的编程语言、框架和方言中创建代码。 它不用作常规用途的编程助手。

Genie Code 通常使用 Databricks 资源（如 Databricks 文档网站或知识库）中的信息来更好地回答用户查询。 当用户问题与可用 Databricks 文档、Unity Catalog 和工作区内用户代码中的知识回答的问题相关时，该助手表现最佳。

获取来自文档的答案

Genie Code 搜索 Databricks 文档来回答你的问题。 引用文档时，在响应中可以看到一个文档搜索步骤。 可以要求 Genie Code 引用其来源，并提供指向相关文档页面的链接。

提供有关 Genie Code 答案的反馈

告诉我们 Genie Code 答案是否有用：

1. 将鼠标悬停在 Genie Code 答案下方。
2. 单击“有用” 或“没用” 按钮。

其他资源

• Genie Code
• 从 Genie Code 获取编码帮助
• 度量 Genie Code 影响
• 改进 Genie Code 响应的提示
• 使用 Genie Code 实现模型服务可观测性