Python Back End

Instalar dependencias de Python

Para seguir las mejores prácticas en Python, ahora vas a crear un entorno virtual, que es una instalación privada de Python dedicada a este proyecto, donde se podrán instalar todas las dependencias. Haz esto con el siguiente comando:

Este comando crea un entorno virtual en Python en un .venv Directorio (dot-venv). Puedes reemplazar .venv en este comando por cualquier otro nombre que prefieras. Ten en cuenta que en algunas instalaciones de Python, puede que necesites usar python en lugar de python3 para invocar el intérprete de Python.

El siguiente paso es activar el entorno virtual, que es una forma de convertir este entorno virtual en el entorno Python activo para la sesión de terminal en la que estás. Si trabajas en un sistema operativo basado en UNIX como Linux o macOS, activa el entorno virtual de la siguiente manera:

El comando de activación anterior también funcionaría si trabajas dentro de un entorno WSL en una computadora con Microsoft Windows. Pero si usas el símbolo de Windows o PowerShell, el comando de activación es diferente:

Cuando se activa el entorno virtual, el prompt de línea de comandos cambia para mostrar el nombre del entorno:

El último paso para configurar el entorno Python es instalar algunos paquetes que la aplicación inicial necesita. Cerciórate de que el entorno virtual se activó en el paso anterior y luego ejecuta el siguiente comando para instalar estas dependencias:

Escribe un archivo de configuración

En el directorio principal del código que descargaste en la sección anterior hay un archivo llamado env.example. Este archivo contiene todas las variables de configuración soportadas por la aplicación.

Haz una copia de este archivo y ponle el nombre .env:

Si sigues el tutorial en Windows, usa copy en lugar de cp en el comando anterior.

Abre .env en tu editor de texto favorito para revisar la configuración de la aplicación y revisa las siguientes subsecciones para orientarte sobre cómo configurarla.

Configuración de Elasticsearch

Autenticación

Si usas una cuenta de Elastic Cloud, debes establecer las variables ELASTICSEARCH_URL y ELASTIC_API_KEY :

Para obtener ayuda para obtener tu ELASTICSEARCH_URL y la clave de API, consulta las instrucciones sobre cómo crear un despliegue de Elastic Cloud.

Si trabajas con una instancia autoalojada de Elasticsearch, entonces deberías comentar ELASTIC_API_KEY, y establecer ELASTICSEARCH_URL a tu endpoint de Elasticsearch:

Índices

La aplicación emplea dos índices de Elasticsearch. Las variables de configuración ES_INDEX y ES_INDEX_CHAT_HISTORY permiten proporcionar nombres para estos índices. Los valores predeterminados incluidos en el archivo de configuración deberían estar bien en la mayoría de los casos.

Configuración de LLM

La solicitud también necesita acceso a tu LLM. Si usas OpenAI, entonces emplea las siguientes variables de configuración:

Esta aplicación soporta cualquier LLM que tenga integración Langchain. Los comentarios en el archivo de configuración te guiarán para configurar algunos LLM populares además de OpenAI. También podrás usar cualquier otro LLM que no venga preconfigurado con cambios mínimos en la aplicación.

Conjunto de datos de muestras de carga

La aplicación viene con un conjunto de datos de ejemplo, almacenado en el archivo de datos/data.json . No dudes en abrir este archivo en tu editor de texto para familiarizarte con los documentos que contiene.

Importa el conjunto de datos en la aplicación usando el siguiente comando:

Inicia el Back End

Tras seguir todos los pasos anteriores, deberías poder iniciar el backend en Python con el siguiente comando:

Deja el backend abierto y abre una nueva sesión de terminal para continuar con el resto de este tutorial.