可以通过添加自定义指令来自定义 Genie Code 的响应方式。 Genie Code 在生成新响应时会考虑这些说明。
例如,说明可以包括:
- 有关首选项的信息,例如编写代码时首选使用的库。
- 有关你身份的上下文,例如你的姓名和角色。
- 要遵循的编码约定。
- 要遵循的准则。
- 关于 Genie Code 应如何响应的说明,例如使用随意的语气。
除了快速修复和自动完成之外,Genie Code 还对生成的每个响应应用说明,包括内联助手、常规聊天、建议修复、编辑模式和代理模式。
Genie Code 支持两种类型的说明:用户说明和工作区说明。 除非另有说明,否则 Genie Code 通常将工作区指示优先于用户指示。
添加用户说明
用户说明允许向 Genie Code 提供系统级说明。 它们是共享上下文、首选项或首选创作方法的持久方法。 这些说明特定于你,仅适用于与 Genie Code 的交互。
添加用户说明:
单击工作区右上角的
打开 Genie Code 窗格。
在“Genie 代码”窗格中,单击“
打开 Genie Code 设置。
在 “用户说明”下,单击“ 添加说明文件”。 这会在默认用户工作区目录 (
.assistant_instructions.md) 中创建一个/Users/<your-username-or-email>文件,并在新文件选项卡中打开该文件。如果已创建说明文件,请单击 “打开说明文件 ”以打开该文件。
编辑
.assistant_instructions.md文件以添加自定义说明。 Databricks 建议使用纯英文文本添加说明,将每个指令分隔为新的项目符号或段落。 请参阅 Genie Code 指南的最佳实践。
Genie Code 会在下次与之交互时自动获取指令。
** 还可以使用 Genie Code 为你添加指令。 在 Genie Code 面板中,要求 Genie Code 记住某些内容。
添加和查看工作区说明
注释
只有工作区管理员可以添加或编辑工作区说明。
工作区说明由工作区管理员配置,并为 Genie Code 提供更多上下文,以帮助其遵循指南并在工作区中更高效地运行。
如果工作区尚未提供工作区说明,则工作区管理员可按照以下步骤创建说明文件:
- 在工作区
Workspace/的目录中,创建名为.assistant_workspace_instructions.md的文件。 - 编辑文件以添加适用于工作区范围的 Genie Code 的指令。 Databricks 建议使用纯英语文本添加说明,将每个指令分隔为自己的项目符号点或段落。 请参阅 Genie Code 指南的最佳做法。
Genie Code 会在用户下次与其交互时自动获取新的工作区指令。
查看或编辑工作区说明:
单击工作区右上角的
打开 Genie Code 窗格。
在“Genie 代码”窗格中,单击“
打开 Genie Code 设置。
在 工作区说明下,单击“ 查看文件”。 这会在新
.assistant_workspace_instructions.md选项卡中打开该文件。如果你是工作区管理员,则可以编辑该文件,并添加适用于 Genie Code 在整个工作区中行为的说明。 有关添加说明的详细信息,请参阅 Genie Code 说明的最佳做法 。
如果你不是管理员,你仍然可以查看该文件,了解 Genie Code 除了可能提供的任何用户说明之外,还遵循了哪些说明。
Genie Code 说明的最佳做法
提供说明时,请务必考虑 Genie Code 的潜在限制。 下面是一些常规指南和提示,用于编写说明以优化体验并充分利用此功能。
- 写清楚具体说明: 编写说明时,应明确且清晰。
- 将说明保持在 20,000 个字符以下: 指令文件限制为 20,000 个字符。 Genie Code 不会使用超过此限制的指令。 简明扼要,并优先处理重要指令。
- 对结构使用标题和分隔符: 说明位于 Markdown 文件中。 在说明中使用 Markdown 格式来提供结构。 使用项目符号点作为分隔符来分隔不同的指令。 使用标题将一组指令组合在一起。 例如,你可能会有一个名为“Python 代码约定”的标题,其中包括一份带有项目符号的列表,列出了 Genie Code 在处理 Python 代码时应遵循的特定准则。
- 范围: 在使用内联 Genie Code、常规聊天、建议修复、编辑模式等与 Genie Code 互动时,它会对生成的每个响应应用相应的指令。然而,在快速修复和自动完成时,Genie Code 不会考虑这些指令。 保留与不同 Genie Code 函数相关的说明,以避免意外行为。
- 提供上下文和引用: 虽然 Genie Code 使用笔记本代码和表元数据等周边上下文,但它尚未根据说明主动提取其他信息。 若要确保有用的响应,请直接在说明中包含任何关键详细信息,例如何时使用特定表或函数。