GPT-Agent

中文文档 | English

使用 Azure OpenAI 或 OpenAI、Gradio 以及内置的检索流程，构建一个可用于聊天、知识库问答、图片生成和网页搜索的智能助手。

预览

以下为界面布局示意图，并非真实运行截图。

功能特点

• 🤖 支持多轮对话的聊天界面
• 🔧 可灵活配置模型、提示词和检索参数
• 📚 支持知识库管理与检索增强生成（RAG）
• 👓 支持混合检索、重排序和指定文件检索
• 🖼 支持 DALL·E 3 图像生成
• 🔍 支持网页搜索，并保留历史记录
• 🖥 支持使用 Hugging Face 与 Ollama 进行本地 embedding 和聊天
• 📦 提供便携包，便于快速部署

快速开始

1. 安装依赖

克隆仓库并安装所需 Python 包：

git clone https://github.com/chmm195/gpt-agent-gradio.git
cd gpt-agent-gradio
pip install -r requirements.txt

2. 配置环境变量

复制 .env_example 为 .env，并填写以下变量：

• AZURE_OAI_KEY：Azure OpenAI 的 API Key
• AZURE_OAI_ENDPOINT：Azure OpenAI 的终结点
• API_VERSION：Azure OpenAI 使用的 API 版本
• API_TYPE：设置为 Azure OpenAI
• 可选：BING_SUBSCRIPTION_KEY，用于开启网页搜索功能

如果使用 DALL·E 3，请确保部署名称与模型名称一致，例如 dall-e-3。

3. 运行程序

在终端中执行：

python gpt-agent.py

随后打开终端中显示的本地地址，通常为：

http://127.0.0.1:7860

便携版使用方式

如果没有安装 Git，可以下载最新发布包并解压。配置好环境变量后，双击 run.bat 即可启动应用。

默认登录账号为 admin，密码为 123456，如需修改请自行调整。

架构图

使用说明

• 可以通过界面创建和管理知识库。
• 在已有知识库中更换 embedding 模型时，应谨慎处理，避免出现向量维度不一致的问题。
• 本项目同时支持云端部署和本地部署，可根据实际环境选择。