genai-bedrock-agent-chatbot 的安装和配置教程

2025-05-22 19:14:22作者：咎竹峻Karen

项目基础介绍

genai-bedrock-agent-chatbot 是一个使用 Amazon Bedrock 服务构建的开源聊天机器人应用程序。该项目通过 Amazon Bedrock 的 KnowledgeBase 和 Agent 组件，实现了对自然语言的理解和复杂数据集的处理。这个聊天机器人能够将自然语言转换为 Amazon Athena 查询，并处理和利用复杂的数据集。项目主要使用 Python 编程语言。

项目使用的关键技术和框架

Amazon Bedrock: 包括 KnowledgeBase 和 Agent 组件，用于自然语言处理和任务执行。
AWS CDK (Cloud Development Kit): 用于定义和部署 AWS 资源。
Docker: 容器化技术，用于构建可移植的应用程序环境。
Streamlit: 用于快速构建数据密集型的 web 应用程序。
LLamaIndex: 开源工具，用于增强系统的数据处理和检索能力。

安装和配置准备工作

在开始安装之前，请确保您已经完成了以下准备工作：

安装 Docker。
安装 AWS CDK Toolkit (版本 2.114.1 或更高) 并配置 AWS 账户。
安装 Python (版本 3.11 或更高)。
确保您的 AWS 账户已经启用了 Claude 模型和 Titan Embedding 模型访问权限。

创建一个 .env 文件，包含以下内容，并放置在 code/streamlit-app 目录下：

ACCOUNT_ID=<您的账户ID>
AWS_REGION=<您的区域>
LAMBDA_FUNCTION_NAME=invokeAgentLambda

安装步骤

克隆项目到本地：

git clone https://github.com/awslabs/genai-bedrock-agent-chatbot.git
cd genai-bedrock-agent-chatbot

在项目目录中，创建 Python 虚拟环境并激活：

对于 MacOS 和 Linux 用户：
```
python3 -m venv .venv
source .venv/bin/activate
```
对于 Windows 用户：
```
.\.venv\Scripts\activate.bat
```
安装项目依赖：
```
pip install -r requirements.txt
```
合成 CloudFormation 模板：
```
cdk synth
```
如果是首次在特定账户和区域运行 CDK，需要初始化：
```
cdk bootstrap
```
部署 CDK：
```
cdk deploy
```
请注意，首次部署可能会需要一些时间来构建 Docker 镜像。
部署完成后，可以在 CloudFormation 控制台验证状态，并通过 CloudFormation 输出的 URL 测试聊天机器人。
若要删除 CDK 以避免未来产生费用，可以使用以下命令：
```
cdk destroy
```
并确保手动删除 CDK 生成的 S3 桶，以避免产生额外费用。