Clonar el proyecto

El proyecto de código usado en este tutorial está disponible en https://github.com/microsoft/MicrosoftCloud. El repositorio del proyecto incluye código del lado cliente y del lado servidor necesarios para ejecutar el proyecto, lo que le permite explorar las características integradas relacionadas con la inteligencia artificial (IA), la comunicación y los datos de la organización. Además, el proyecto sirve como recurso para guiarle en la incorporación de características similares en sus propias aplicaciones.

En este ejercicio, aprenderá a:

• Clone el repositorio de GitHub.
• Agregue un archivo .env al proyecto y actualícelo.

Antes de continuar, asegúrese de que tiene todos los requisitos previos instalados y configurados como se describe en la sección Requisitos previos de este tutorial.

Clonación del repositorio de GitHub y creación de un .env archivo

1. Ejecute el comando siguiente para clonar el repositorio de GitHub de Microsoft Cloud en la máquina.

   git clone https://github.com/microsoft/MicrosoftCloud
   

2. Abra la carpeta MicrosoftCloud/samples/openai-acs-msgraph en Visual Studio Code.

   Nota:

   Aunque usaremos Visual Studio Code en este tutorial, se puede usar cualquier editor de código para trabajar con el proyecto de ejemplo.

3. Observe las siguientes carpetas y archivos:

   • client: código de aplicación del lado cliente.
   • server: código de API del lado servidor.
   • docker-compose.yml: se usa para ejecutar una base de datos postgreSQL local.

4. Cambie el nombre de .env.example en la raíz del proyecto a .env.

5. Abra el archivo .env y dedique un momento a examinar las claves que se incluyen:

   ENTRAID_CLIENT_ID=
   TEAM_ID=
   CHANNEL_ID=
   OPENAI_API_KEY=
   OPENAI_ENDPOINT=
   OPENAI_MODEL=gpt-4o
   OPENAI_API_VERSION=2024-05-01-preview
   POSTGRES_USER=
   POSTGRES_PASSWORD=
   ACS_CONNECTION_STRING=
   ACS_PHONE_NUMBER=
   ACS_EMAIL_ADDRESS=
   CUSTOMER_EMAIL_ADDRESS=
   CUSTOMER_PHONE_NUMBER=
   API_PORT=3000
   AZURE_AI_SEARCH_ENDPOINT=
   AZURE_AI_SEARCH_KEY=
   AZURE_AI_SEARCH_INDEX=
   

6. Actualice los valores siguientes en .env. El servidor de API usará estos valores para conectarse a la base de datos de PostgreSQL local.

   POSTGRES_USER=web
   POSTGRES_PASSWORD=web-password
   

7. Ahora que tiene el proyecto en su lugar, vamos a probar algunas de las características de la aplicación y a aprender cómo se compilan. Seleccione el botón Siguiente que aparece a continuación para continuar o saltar a un ejercicio específico mediante la tabla de contenido.

Paso siguiente