使用 Genie Code

Genie Code 可帮助开发人员在Azure Databricks笔记本、SQL 编辑器、作业、AI/BI 仪表板和文件编辑器中生成、优化、解释和修复代码。

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

Genie Code 窗格导览

若要打开“Genie 代码”窗格,请单击页面右上角的 Sparkle Genie 代码图标

精灵代码侧面板,多个聊天窗口作为标签页打开。

在窗格底部的文本框中输入提示,然后按 Enter 或单击“发送”图标。 您可以:

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

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

将多个聊天作为标签页使用

精灵代码面板顶部的标签页显示你打开的聊天记录。 你可以同时运行多个任务,并在聊天间移动而不会丢失位置。

  • 切换聊天:点击标签页使聊天活跃。 切换标签页时,聊天会在后台持续运行,所以你可以在一个聊天中开始一个长任务,另一个聊天中继续工作。
  • 打开新聊天:点击 新聊天图标。新建聊天 ,在新标签页开始聊天。
  • 重新打开过去的聊天:点击历史图标。聊天记录,选择一个聊天窗口在标签页中打开。
  • 管理聊天:使用 烤肉菜单图标。 在活跃标签页上使用烤肉菜单来管理聊天,或点击 关闭 图标关闭标签页。

Genie Code 窗格控件

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

Control Description
新建聊天图标。 新建聊天 在新标签页开启新聊天。
历史偶像。 聊天历史 查看过去的聊天记录,并在标签页中重新打开一次。
Kebab 菜单图标。 更多 访问 齿轮图标。设置 和其他选项。 请参阅 Genie Code 设置
关闭图标。 关闭 折叠 Genie Code 窗格。

Genie Code 设置

若要打开 Genie Code 设置,请单击 Kebab 菜单图标。窗格标题中的“更多”菜单,然后单击“齿轮”图标。设置。 设置窗格包括以下内容:

设置 Description
Actions 设置 Genie Code 在使用工具之前请求审批的方式。 请参阅 “批准工具”操作
MCP 服务器 使用 MCP 服务器和 内置连接器连接到外部工具和数据源。
切换面板视图 选择以停靠窗格视图还是侧边窗格视图方式使用 Genie Code。
用户说明 添加用户说明,指导 Genie Code 如何回应你。
工作区说明 添加适用于工作区中所有人的 工作区说明
技能 添加可重用的代理技能,供 Genie Code 用于处理任务。
工作区技能 添加可用于工作区中每个人的 技能
无服务器使用策略 设置用于运行 Genie Code 在聊天输出中生成的代码的 无服务器使用策略

代理模式

Genie Code 在代理模式下运行,它自动执行多步骤工作流、计划解决方案、检索相关资产、运行代码、使用单元格输出来改进结果,并自动修复错误。 如果想要直接对话响应而不执行自治任务,请在提示中这样说,例如,“只需向我解释一下,就不要运行任何代码。

为了完成任务,Genie Code 会将提示和相关上下文发送到模型,包括表名和列名、说明、正在使用的代码、表中的数据示例和单元格输出。 发送到模型的所有数据都会遵循您在 Unity Catalog 中的权限设置。 有关详细信息,请参阅 发送到模型的数据

要求

若要使用 Genie Code 的代理功能,工作区需要以下各项:

如果禁用由合作伙伴提供支持的 AI 功能,Genie Code 仍然可用,但将使用 Databricks 托管的模型,且不具备其代理能力。

整页 Genie Code

Genie Code 拥有整页的命令中心体验,活跃的聊天内容会显眼显示,必要时会以标签页形式显示笔记本和文件等资源。 请参阅 完整页面 Genie Code

批准工具操作

当 Genie Code 需要使用工具(如运行代码、编辑笔记本或查询表)时,它会要求你批准,然后再继续。 你可以单独批准每个请求,或者设置一个批准模式,适用于当前聊天内容或所有未来的聊天。

批准单个请求

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

要更改Genie Code在当前聊天中处理未来审批请求的方式,请从同一提示中选择以下之一:

选项 Behavior
每次都询问 Genie Code 每次使用工具时都要求批准。 这是默认值。
允许当前聊天 Genie Code可以在当前聊天中使用请求的工具,无需征求请求。
始终允许 Genie Code可以在每次聊天中使用请求的工具,无需征求。
自动批准 Genie Code 会自动批准当前聊天中剩余时间的工具操作。 AI 分类器会检查每个操作并阻止有风险的操作。 (建议)。

设置默认审批模式

要对每个Genie Code聊天应用相同的批准模式,可以在Genie Code设置中设置默认值。 单击 “齿轮”图标。 在“Genie 代码”窗格标题中打开设置。

选择下列选项之一:

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

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

    重要

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

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

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

共享聊天

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

分享聊天内容:

  1. 在精灵代码面板中,点击历史图标。聊天记录打开聊天记录。

  2. 将鼠标悬停在你想分享的聊天内容上,点击 烤肉菜单图标。 烤肉菜单。

  3. 单击“ 共享”图标。共享

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

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

  6. (可选)要分享聊天的直接链接,请点击链接图标。复制分享对话框底部的链接

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

获取有关代码的帮助

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

Databricks 建议在运行 Genie Code 之前始终查看由 Genie Code 生成的任何代码,因为它有时可能会出错。

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

针对Azure Databricks环境优化的代码

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

Genie Code 通常使用 Databricks 资源(如 Databricks 文档网站或知识库)中的信息来更好地回答用户查询。 当用户问题与可从 Databricks 文档、Unity 目录和工作区中的用户代码中获取知识的问题相关的问题时,它将表现最佳。

获取来自文档的答案

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

Genie Code 响应,显示来源于文档的答案。

提供有关 Genie Code 答案的反馈

让 Databricks 知道 Genie Code 答案是否有用:

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

其他资源