本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 安装 Jupyter AI
<a name="sagemaker-jupyterai-installation"></a>

要使用 Jupyter AI，必须先安装 Jupyter AI 软件包。对于 [Amazon SageMaker AI 分发](https://github.com/aws/sagemaker-distribution/tree/main/build_artifacts/v1)用户，我们建议选择 SageMaker 分发映像版本 1.2 或更高版本。无需进一步安装。Studio JupyterLab 中的用户可以在创建空间时选择其亚马逊 SageMaker 发行版的版本。

对于其他 IPython 环境的用户，推荐的 Jupyter AI 软件包的版本取决于 JupyterLab 他们使用的版本。

Jupyter AI 发行版由两个软件包组成。
+ `jupyter_ai`：此软件包提供了 JupyterLab 扩展程序和本机聊天用户界面 (UI)。它使用您选择的大型语言模型充当对话助手。
+ `jupyter_ai_magics`: 此软件包提供了 IPython `%%ai`和`%ai`魔法命令，您可以使用这些命令从笔记本单元格中调用大型语言模型 (LLM)。

**注意**  
安装 `jupyter_ai` 也会安装 `jupyter_ai_magics`。但是，您可以不使用 JupyterLab 或`jupyter_ai_magics`独立安装`jupyter_ai`。这些神奇`%%ai`的命令可以在任何内 IPython 核环境中`%ai`运行。如果您只安装 `jupyter_ai_magics`，则无法使用聊天用户界面。

对于 JupyterLab 3 的用户，特别是 Studio Classic 用户，我们建议安装`jupyter-ai`[版本 1.5.x](https://pypi.org/project/jupyter-ai/#history) 或任何更高版本的 1.x。但是，我们强烈建议将 Jupyter AI 与 4 配 JupyterLab 合使用。与 JupyterLab 3 兼容的`jupyter-ai`版本可能不允许用户设置其他模型参数，例如温度、top-k 和 top-p 采样、最大令牌或最大长度或用户接受许可协议。

对于不使用 SageMaker 发行版的 JupyterLab 4 个环境的用户，我们建议安装`jupyter-ai`[版本 2.5.x](https://pypi.org/project/jupyter-ai/#history) 或任何更高版本的 2.x。

请参阅 [Jupyter AI 文档](https://jupyter-ai.readthedocs.io/en/latest/users/index.html#installation-via-pip)的*安装*部分中的安装说明。