要求
软件要求
- JDK 21.0 或更高版本 - 从 Adoptium 下载
- OpenAI API 的密钥（由 workshop 组织者提供）
- Podman 或 Docker - 参见 Podman 安装 或 Docker 安装
- 如果您使用 Podman，Podman Desktop 提供了一个出色的用户体验来管理您的容器： Podman Desktop
- Git（非强制） - 参见 Git 安装
- 具有 Java 支持的 IDE（IntelliJ、Eclipse、带有 Java 扩展的 VSCode 等）
- 终端
想使用我们的环境而不是您自己的环境吗？
如果您正在参加由讲师指导的 workshop 并已获得虚拟机，请点击此处了解如何使用它（如果您更喜欢使用它而不是自己的笔记本电脑）。
AI 模型要求
您将需要一个 OpenAI API 密钥才能完成此 workshop。 如果您的讲师为您提供了一个密钥，请使用它！ 如果您没有密钥，请点击此处创建一个。
您的讲师没有提供密钥吗？
如果您是第一次创建 OpenAI 开发者帐户，您应该获得 5 美元的免费 OpenAI 试用额度。 如果您已经拥有帐户并已用完您的免费试用额度，那么您将需要为您的帐户充值。
不用担心，此 workshop 不会花费太多。 您可以查看 OpenAI 定价计算器。
完成此 workshop 的费用不应超过 0.25 美元（约 0.22 欧元）。
一旦您有了 OpenAI API 密钥，请确保您已将其设置为环境变量，例如
须知
您可以通过在项目目录中运行以下命令，在 dev 模式 中运行 Quarkus 应用程序
Quarkus dev 模式
这将在 dev 模式下启动应用程序，这意味着每次源代碼发生更改时，应用程序都会自动重新编译。 只需刷新浏览器即可查看更改。 应用程序在 https://:8080/ 上提供服务。
停止应用程序
切换步骤时，请确保在启动下一步之前停止正在运行的应用程序。 您可以通过在运行应用程序的终端中按 Ctrl+C 来退出应用程序。
Dev UI
Quarkus 附带一个 Dev UI，该 UI 仅在 dev 模式下可用，网址为 https://:8080/q/dev/。 Dev UI 可以看作是您构建 Quarkus 应用程序时的工具箱。
调试
要调试在 dev 模式下运行的 Quarkus 应用程序，请设置您的断点并选择 Run > Attach to Process，然后选择 Quarkus 进程（在 IntelliJ 中）。
开始吧
现在是开始 workshop 的时候了。
获取 workshop 材料
使用 git 或将存储库下载为 zip 文件。
使用 Git
如果您还没有，请克隆存储库并检出 main 分支。
然后导航到目录
直接下载
如果您没有使用 git 方法，您可以从 GitHub 存储库下载存储库作为 zip 文件
curl -L -o workshop.zip https://github.com/quarkusio/quarkus-langchain4j-workshop/archive/refs/heads/main.zip
然后解压缩该文件并导航到目录
预热缓存
此 workshop 需要下载各种 Maven 工件和 Docker 镜像。 其中一些工件很大，而且因为我们必须在 workshop 位置共享互联网连接，所以最好在 workshop 之前下载它们。
如果您正在为 workshop 做准备，您可能会发现预先下载其中一些工件很有帮助。 这可以节省共享带宽的压力。 但是，如果您已经在参加 workshop，请不要担心预热任何东西。
预热 Maven
要预热 Maven，您可以在项目的根目录中运行以下命令
预热 Docker 镜像
要下载 Docker 镜像，您可以运行以下命令之一
在 IDE 中导入项目
然后，从 IDE 中的 step-01 目录打开项目，并在整个 workshop 中使用该目录。 如果您在任何地方遇到困难并想继续前进，只需切换到您完成的最后一步的 step-xx 目录。
完成后，您可以转到下一步： Step 1。