Back-end em Python

Instalar as dependências do Python

Para seguir as melhores práticas do Python, você criará agora um ambiente virtual, que é uma instalação privada do Python dedicada a este projeto, onde todas as dependências poderão ser instaladas. Faça isso com o seguinte comando:

Este comando cria um ambiente virtual Python em um arquivo .venv. Diretório (ponto-venv). Você pode substituir .venv neste comando por qualquer outro nome que desejar. Observe que em algumas instalações do Python, você pode precisar usar python em vez de python3 para invocar o interpretador Python.

O próximo passo é ativar o ambiente virtual, que é uma forma de tornar esse ambiente virtual o ambiente Python ativo para a sessão de terminal em que você está. Se você estiver trabalhando em um sistema operacional baseado em UNIX, como Linux ou macOS, ative o ambiente virtual da seguinte forma:

O comando de ativação acima também funcionaria se você estivesse trabalhando em um ambiente WSL em um computador com Microsoft Windows. Mas se você estiver usando o prompt de comando do Windows ou o PowerShell, o comando de ativação é diferente:

Quando o ambiente virtual é ativado, o prompt da linha de comando muda para mostrar o nome do ambiente:

O último passo para configurar o ambiente Python é instalar alguns pacotes necessários para a aplicação inicial. Certifique-se de que o ambiente virtual foi ativado na etapa anterior e, em seguida, execute o seguinte comando para instalar essas dependências:

Escreva um arquivo de configuração

No diretório principal do código que você baixou na seção anterior, há um arquivo chamado env.example. Este arquivo contém todas as variáveis de configuração suportadas pelo aplicativo.

Faça uma cópia deste arquivo e nomeie-a como .env:

Se você estiver seguindo o tutorial no Windows, use copy em vez de cp no comando acima.

Abra o arquivo .env no seu editor de texto preferido para revisar a configuração do aplicativo e consulte as subseções a seguir para obter orientações sobre como configurar o aplicativo.

Instalação do Elasticsearch

Autenticação

Se você estiver usando uma conta Elastic Cloud, deverá definir as variáveis ELASTICSEARCH_URL e ELASTIC_API_KEY :

Para obter ajuda na obtenção do seu ELASTICSEARCH_URL e da sua chave de API, consulte as instruções sobre como criar uma implantação do Elastic Cloud.

Se você estiver trabalhando com uma instância Elasticsearch auto-hospedada, comente a linha ELASTIC_API_KEY e defina ELASTICSEARCH_URL para o seu endpoint do Elasticsearch:

Índices

A aplicação utiliza dois índices do Elasticsearch. As variáveis de configuração ES_INDEX e ES_INDEX_CHAT_HISTORY permitem que você forneça nomes para esses índices. As configurações padrão incluídas no arquivo de configuração devem ser adequadas na maioria dos casos.

Configuração do LLM

A candidatura também precisa ter acesso ao seu mestrado em Direito (LLM). Se você estiver usando o OpenAI, utilize as seguintes variáveis de configuração:

Este aplicativo é compatível com qualquer LLM que possua integração com Langchain. Os comentários no arquivo de configuração irão orientá-lo na configuração de alguns modelos de aprendizado de máquina populares, além do OpenAI. Você também poderá usar qualquer outro LLM que não venha pré-configurado, com alterações mínimas no aplicativo.

Carregar conjunto de dados de exemplo

O aplicativo vem com um conjunto de dados de exemplo, armazenado no arquivo data/data.json . Sinta-se à vontade para abrir este arquivo em seu editor de texto para se familiarizar com os documentos que ele contém.

Importe o conjunto de dados para o aplicativo usando o seguinte comando:

Inicie o Back End

Após seguir todos os passos acima, você deverá conseguir iniciar o backend em Python com o seguinte comando:

Deixe o servidor em execução e abra uma nova sessão de terminal para continuar com o restante deste tutorial.