克隆项目

本教程中使用的代码项目在以下位置 https://github.com/microsoft/MicrosoftCloud提供。 项目的存储库包括运行项目所需的客户端代码和服务器端代码,使你能够探索与人工智能(AI)、通信和组织数据相关的集成功能。 此外,该项目充当资源,指导你将类似的功能合并到自己的应用程序中。

在本练习中,你将:

  • 克隆 GitHub 存储库。
  • .env 文件添加到项目中并对其进行更新。

在继续之前,请确保已按照本教程的 “先决条件 ”部分中所述安装和配置了所有先决条件。

克隆 GitHub 存储库并创建 .env 文件

  1. 运行以下命令,将 Microsoft Cloud GitHub 存储库 克隆到计算机。

    git clone https://github.com/microsoft/MicrosoftCloud
    
  2. 在 Visual Studio Code 中打开 MicrosoftCloud/samples/openai-acs-msgraph 文件夹。

    注释

    尽管我们将在整个本教程中使用 Visual Studio Code,但任何代码编辑器都可用于处理示例项目。

  3. 请注意以下文件夹和文件:

    • 客户端:客户端应用程序代码。
    • 服务器:服务器端 API 代码。
    • docker-compose.yml:用于运行本地 PostgreSQL 数据库。
  4. 将项目根目录中的 .env.example 重命名为 .env

  5. 打开 .env 文件,花点时间查看包含的密钥:

    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. 更新 .env 中的以下值。 API 服务器将使用这些值连接到本地 PostgreSQL 数据库。

    POSTGRES_USER=web
    POSTGRES_PASSWORD=web-password
    
  7. 准备好项目后,让我们尝试一些应用程序功能并了解如何生成它们。 选择下面的“ 下一步 ”按钮以继续使用或跳转到使用目录的特定练习。

下一步