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。
- 试用版 SKU 不支持 Microsoft Fabric 中的 Copilot。 仅支持付费版 SKU（F64 或更高版本或 P1 或更高版本）。
- Fabric 中的 Copilot 目前以公共预览版推出，预计于 2024 年 3 月底向所有客户推出。
- 请参阅 Fabric 和 Power BI 中的 Copilot 概述一文获取更多信息。
Chat-magics 的功能
即时查询和代码生成
使用 %%chat 命令可以提出有关笔记本状态的问题。 %%code 可用于生成代码，以实现数据操作或可视化效果。
数据框描述
%describe 命令提供已加载的数据帧的摘要和说明。 这可简化数据探索阶段。
注释和调试
%%add_comments 和 %%fix_errors 命令有助于向代码添加注释并分别修复错误。 这有助于使笔记本更易于理解且无错误。
隐私控制
Chat-magics 还提供精细的隐私设置，可用于控制与 Azure OpenAI 服务共享的数据。 例如，%set_sharing_level 和 %configure_privacy_settings 命令提供此功能。
Chat-magics 能为你做些什么？
Chat-magics 可在 Microsoft Fabric 笔记本中提高工作效率和增强工作流，可加速数据浏览、简化笔记本导航并提高代码质量。 它适应多语言代码环境，并优先考虑数据隐私和安全性。 通过减少认知工作，你可以更专注于解决问题。 无论你是数据科学家、数据工程师还是业务分析师，Chat-magics 都能将可靠的企业级 Azure OpenAI 功能无缝集成到笔记本中。 这样，它便成为高效简化的数据科学和工程任务不可或缺的工具。
Chat-magics 入门
- 打开一个新的或现有的 Microsoft Fabric 笔记本。
- 选择笔记本功能区上的 Copilot 按钮，将 Chat-magic 初始化代码输出到新的笔记本单元格中。
- 当代码单元添加到笔记本顶部后，运行该代码单元。
验证 Chat-magics 安装
- 在笔记本中创建新的单元格，并运行
%chat_magics命令以显示帮助消息。 此步骤验证是否正确安装Chat-magics。
基本命令简介：%%chat 和 %%code
使用 %%chat（单元格 Magic）
- 在笔记本中创建新的单元格。
- 在单元格顶部键入
%%chat。 - 在
%%chat命令下方输入问题或说明 - 例如，当前定义了哪些变量？ - 执行代码单元以查看 Chat-magics 响应。
使用 %%code (Cell 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 目前知晓的执行历史记录，并能提高未来响应的相关性。