As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Instalação do Jupyter AI
<a name="sagemaker-jupyterai-installation"></a>

Para usar o Jupyter AI, você deve instalar o pacote Jupyter AI. Para usuários do [Amazon SageMaker AI Distribution](https://github.com/aws/sagemaker-distribution/tree/main/build_artifacts/v1), recomendamos selecionar a imagem SageMaker de distribuição versão 1.2 ou posterior. Nenhuma outra instalação é necessária. Os usuários do JupyterLab in Studio podem escolher a versão de sua SageMaker distribuição na Amazon ao criar um espaço.

Para usuários de outros ambientes IPython, a versão do pacote Jupyter AI recomendado depende da JupyterLab versão que eles estão usando.

A distribuição do Jupyter AI consiste em dois pacotes.
+ `jupyter_ai`: Este pacote fornece uma JupyterLab extensão e uma interface de usuário (UI) nativa de bate-papo. Ele atua como um assistente de conversação usando o grande modelo de linguagem de sua escolha.
+ `jupyter_ai_magics`: este pacote fornece os comandos mágicos `%%ai` e `%ai` do IPython com os quais você pode invocar um grande modelo de linguagem (LLM) a partir das células do seu caderno.

**nota**  
A instalação do `jupyter_ai` também instala o `jupyter_ai_magics`. No entanto, você pode instalar de `jupyter_ai_magics` forma independente sem JupyterLab ou`jupyter_ai`. Os comandos mágicos `%%ai` e `%ai` funcionam em qualquer ambiente de kernel do IPython. Se você só instalar o `jupyter_ai_magics`, não poderá usar a interface de usuário de chat.

Para usuários de JupyterLab 3, em particular usuários do Studio Classic, recomendamos instalar a `jupyter-ai` [versão 1.5.x](https://pypi.org/project/jupyter-ai/#history) ou qualquer versão 1.x posterior. No entanto, é altamente recomendável usar o Jupyter AI com JupyterLab 4. A `jupyter-ai` versão compatível com JupyterLab 3 pode não permitir que os usuários definam parâmetros adicionais do modelo, como temperatura, amostragem top-k e top-p, tokens ou comprimento máximo ou contratos de licença de aceitação do usuário.

Para usuários de JupyterLab 4 ambientes que não usam SageMaker Distribuição, recomendamos instalar a `jupyter-ai` [versão 2.5.x](https://pypi.org/project/jupyter-ai/#history) ou qualquer versão 2.x posterior.

Consulte as instruções de instalação na seção de *Instalação* da [documentação do Jupyter AI](https://jupyter-ai.readthedocs.io/en/latest/users/index.html#installation-via-pip).