openeuler/agent

OPEA Docker镜像文档

镜像概述和主要用途

OPEA官方Docker镜像基于openEuler构建，由openEuler CloudNative SIG维护，可免费使用且无每用户速率限制。OPEA是一个开放平台项目，旨在创建开放、多提供商、健壮且可组合的生成式AI（GenAI）解决方案，整合生态系统中的最佳创新。

核心功能和特性

OPEA平台包含以下核心组件：

• 先进生成式AI系统的可组合构建块详细框架，包括LLM、数据存储和提示引擎
• 检索增强生成式AI组件堆栈结构和端到端工作流的架构蓝图
• 围绕性能、功能、可信度和企业级就绪性对生成式AI系统进行分级的四步评估

支持的标签及对应Dockerfile链接

每个AgentQnA Docker镜像的标签由AgentQnA版本和基础镜像版本组成，详情如下：

使用场景和适用范围

适用于构建问答应用的分层多代理系统，其中监督代理与用户交互并将任务分派给工作代理：

• 工作RAG代理：使用检索工具从知识库（向量数据库）检索相关文档
• 工作SQL代理：从SQL数据库检索相关数据
• 可扩展集成其他工具（如网络搜索工具、知识图谱查询工具）以获取更多信息源

使用方法和配置说明

快速部署步骤

1. 设置环境变量
2. 部署检索工具
3. 准备SQL数据库
4. 启动其他工具

1. 设置环境变量

设置部署AgentQnA服务所需的环境变量：

bash
# 示例：host_ip="192.168.1.1"
export host_ip="外部公网IP"
# 示例：no_proxy="localhost, 127.0.0.1, 192.168.1.1"
export no_proxy="你的no_proxy设置"
export HUGGINGFACEHUB_API_TOKEN="你的Huggingface API令牌"

若处于代理环境，还需设置代理相关环境变量：

bash
export http_proxy="你的HTTP代理"
export https_proxy="你的HTTPS代理"

2. 部署检索工具

首先启动mega-service。

获取launch_retrieval_tool.sh：https://github.com/opea-project/GenAIExamples.git

bash
cd $WORKDIR/GenAIExamples/AgentQnA/retrieval_tool
bash launch_retrieval_tool.sh

然后将数据摄入向量数据库（可使用示例数据或自有数据）：

bash
bash run_ingest_data.sh

3. 准备SQL数据库

本示例使用Chinook SQLite数据库，执行以下命令：

bash
# 下载数据
cd $WORKDIR
git clone https://github.com/lerocha/chinook-database.git
cp chinook-database/ChinookDatabase/DataSources/Chinook_Sqlite.sqlite $WORKDIR/GenAIExamples/AgentQnA/tests/

4. 启动其他工具

本示例使用Meta CRAG KDD Challenge提供的部分模拟API，以展示从模拟知识图谱获取额外上下文的优势：

bash
docker run -d -p=8080:8000 docker.io/aicrowd/kdd-cup-24-crag-mock-api:v0

获取帮助

• openEuler CloudNative SIG
• openEuler 社区

更多信息

• OPEA项目官网：opea.dev
• OPEA技术文档：https://opea-project.github.io/