Microsoft Fabric 笔记本中的 Chat-magics 概述（预览版）
重要
此功能目前为预览版。
Chat-magics Python 库可增强 Microsoft Fabric 笔记本中的数据科学和工程工作流。 它与 Fabric 环境无缝集成，并允许在笔记本单元中执行专用 IPython magic 命令，以提供实时输出。 此处提供了 IPython magic 命令和更多有关用法的背景信息：https://ipython.readthedocs.io/en/stable/interactive/magics.html#。
注意
- 在开始使用 Copilot 之前，管理员需要启用租户切换。 有关详细信息，请参阅 Copilot 租户设置 一文。
- F64 或 P1 容量需要位于 Fabric 区域可用性中列出的其中一个区域。
- 如果租户或容量存在于美国或法国以外的区域，那么除非 Fabric 租户管理员在 Fabric 管理门户中启用了可以在租户的地理区域、合规性边界或国家/地区云实例之外处理发送到 Azure OpenAI 的数据租户设置，否则将默认禁用 Copilot。
- Microsoft Fabric 中的 Copilot 在试用 SKU 上不受支持。 仅支持付费 SKU（F64 或更高版本或 P1 或更高版本）。
- fabric 中的 Copilot 目前正在公共预览版中推出，预计在 2024 年 3 月底之前可供所有客户使用。
- 请参阅 Fabric 和 Power BI 中的 Copilot 概述一文获取更多信息。
Chat-magics 的功能
即时查询和代码生成
使用 %%chat 命令可以询问有关笔记本状态的问题。 %%code 可用于生成代码，以实现数据操作或可视化效果。
数据框描述
%describe 命令提供已加载数据帧的摘要和说明。 这简化了数据探索阶段。
注释和调试
%%add_comments 和 %%fix_errors 命令有助于向代码添加注释并分别修复错误。 这有助于使笔记本更具可读性和无错误性。
隐私控制
聊天魔术还提供精细的隐私设置，可用于控制与 Azure OpenAI 服务共享的数据。 例如，%set_sharing_level 和 %configure_privacy_settings 命令提供此功能。
聊天魔术如何帮助你？
聊天魔术可提高Microsoft Fabric 笔记本中的工作效率和工作流，从而加速数据浏览、简化笔记本导航并提高代码质量。 它适应多语言代码环境，并优先考虑数据隐私和安全性。 通过认知负载减少，可以更紧密地专注于解决问题。 无论你是数据科学家、数据工程师还是业务分析师，聊天魔术都无缝地将可靠的企业级 Azure OpenAI 功能集成到笔记本中。 这使得它成为高效简化的数据科学和工程任务不可或缺的工具。
Chat-magics 入门
- 打开新的或现有的Microsoft Fabric 笔记本。
- 选择笔记本功能区上的 Copilot 按钮，将 Chat-magic 初始化代码输出到新的笔记本单元格中。
- 当代码单元添加到笔记本顶部后，运行该代码单元。
验证 Chat-magics 安装
- 在笔记本中创建新单元格，并运行
%chat_magics命令以显示帮助消息。 此步骤验证是否正确安装Chat-magics。
基本命令简介：%%chat 和 %%code
使用 %%chat（代码单元 Magic）
- 在笔记本中创建新的单元格。
- 在代码单元顶部键入
%%chat。 - 在
%%chat命令下面输入问题或说明 - 例如，当前定义了哪些变量？ - 执行代码单元以查看 Chat-magics 响应。
使用 %%code（单元格 Magic）
- 在笔记本中创建新的单元格。
- 在代码单元顶部键入
%%code。 - 在此下方，指定所需的代码操作-例如，将 my_data.csv 加载到 pandas 数据帧中。
- 执行单元格，并查看生成的代码片段。
自定义输出和语言设置
- 使用 %set_output 命令更改 magic 命令提供输出的默认方式。 可以通过运行 %set_output 来查看这些选项？
- 从类似选项中选择放置生成的代码的位置
- 当前代码单元
- 新单元格
- 单元格输出
- 变量
用于数据操作的高级命令
%describe、%%add_comments 和 %%fix_errors
- 在新单元格中使用 %describe DataFrameName 来获取特定数据帧的概述。
- 若要向代码单元格添加注释以提高可读性，请将 %%add_comments 键入要批注的单元格顶部，然后执行。 请务必验证代码是否正确
- 若要修复代码错误，请在包含错误的代码单元顶部键入 %%fix_errors，然后执行该命令。
隐私和安全设置
- 默认情况下，您的隐私配置会共享以前发送到语言学习模型（LLM）以及从语言学习模型发送的消息。 但是，它不会共享来自数据源的单元格内容、输出或任何架构或示例数据。
- 使用新单元格中的
%set_sharing_level调整与 AI 处理器共享的数据。 - 如需更详细的隐私设置，请使用
%configure_privacy_settings。
上下文和焦点命令
使用 %pin、%new_task 和其他上下文命令
- 使用
%pin DataFrameName帮助 AI 专注于特定数据帧。 - 若要清除 AI 以专注于笔记本中的新任务，请键入 %new_task，后跟要执行的任务。 这可以清除 copilot 到目前为止知道的执行历史记录，以便未来的响应更具相关性。