docs: readme file add web search section

BobDu · BobDu · commit 3888609cc77c · 2025-05-28T22:02:24.000+08:00
Signed-off-by: Bob Du &lt;i@bobdu.cc&gt;
diff --git a/README.en.md b/README.en.md
@@ -32,6 +32,8 @@ Some unique features have been added:
 
 [✓] Implement SSO login through the auth proxy feature (need to integrate a third-party authentication reverse proxy, it can support login protocols such as LDAP/OIDC/SAML)
 
+[✓] Web Search functionality (Real-time web search based on Tavily API)
+
 > [!CAUTION]
 > This project is only published on GitHub, based on the MIT license, free and for open source learning usage. And there will be no any form of account selling, paid service, discussion group, discussion group and other behaviors. Beware of being deceived.
 
@@ -72,6 +74,13 @@ Some unique features have been added:
 		- [Manual packaging](#manual-packaging)
 			- [Backend service](#backend-service-1)
 			- [Frontend webpage](#frontend-webpage-1)
+	- [Auth Proxy Mode](#auth-proxy-mode)
+	- [Web Search Functionality](#web-search-functionality)
+		- [Features](#features)
+		- [Configuration](#configuration)
+		- [Usage](#usage)
+		- [Technical Implementation](#technical-implementation)
+		- [Notes](#notes)
 	- [Frequently Asked Questions](#frequently-asked-questions)
 	- [Contributing](#contributing)
 	- [Sponsorship](#sponsorship)
@@ -347,6 +356,92 @@ Recommended for current IdP to use LDAP protocol, using [authelia](https://www.a
 
 Recommended for current IdP to use OIDC protocol, using [oauth2-proxy](https://oauth2-proxy.github.io/oauth2-proxy)
 
+## Web Search Functionality
+
+> [!TIP]
+> Web Search functionality is based on [Tavily API](https://tavily.com/) implementation, allowing ChatGPT to access the latest web information to answer questions.
+
+### Features
+
+- **Real-time Web Search**: Get the latest web information based on Tavily API
+- **Intelligent Query Extraction**: Automatically extract the most relevant search keywords from user questions
+- **Search Result Integration**: Seamlessly integrate search results into AI conversations
+- **Per-session Control**: Each conversation can independently enable or disable search functionality
+- **Search History**: Save search queries and results to database
+- **Configurable System Messages**: Support custom search-related system prompt messages
+
+### Configuration
+
+#### 1. Get Tavily API Key
+
+1. Visit [Tavily Official Website](https://tavily.com/) to register an account
+2. Obtain API Key
+
+#### 2. Administrator Configuration
+
+1. Login to the system as an administrator
+2. Go to system settings page
+3. Find "Web Search Configuration" option
+4. Fill in the following configurations:
+   - **Enable Status**: Turn on/off global search functionality
+   - **API Key**: Enter Tavily API Key
+   - **Search Query System Message**: Prompt template for extracting search keywords
+   - **Search Result System Message**: Prompt template for processing search results
+
+#### 3. System Message Templates
+
+**Search Query Extraction Template** (for extracting search keywords from user questions):
+```
+You are a search query extraction assistant. Extract the most relevant search query from user's question and wrap it with <search_query></search_query> tags.
+Current time: {current_time}
+```
+
+**Search Result Processing Template** (for processing conversations with search results):
+```
+You are a helpful assistant with access to real-time web search results. Use the provided search information to give accurate and up-to-date responses.
+Current time: {current_time}
+```
+
+### Usage
+
+#### User Operations
+
+1. **Enable Search Functionality**:
+   - In the conversation interface, find the search toggle button
+   - Click to enable web search functionality for the current session
+
+2. **Ask Questions for Real-time Information**:
+   - After enabling search, directly ask ChatGPT questions that require real-time information
+   - The system will automatically search for relevant information and integrate it into the response
+
+3. **View Search History**:
+   - Search queries and results are saved in the database
+   - You can view specific search records through the database
+
+#### Workflow
+
+1. **User Question**: User asks a question in a search-enabled session
+2. **Query Extraction**: System uses AI to extract search keywords from the question
+3. **Web Search**: Call Tavily API for real-time search
+4. **Result Integration**: Provide search results as context to AI
+5. **Generate Response**: AI generates more accurate responses based on search results
+
+### Technical Implementation
+
+- **Search Engine**: Tavily API
+- **Query Extraction**: Use OpenAI API to intelligently extract keywords
+- **Result Format**: JSON format to store complete search results
+- **Data Storage**: MongoDB stores search queries and results
+- **Timeout Setting**: Search request timeout is 300 seconds
+
+### Notes
+
+- Web Search functionality requires additional Tavily API costs
+- Search functionality will increase response time
+- It is recommended to enable selectively based on actual needs
+- Administrators can control the global search functionality status
+- Each session can independently control whether to use search functionality
+
 
 ## Contributing
 
diff --git a/README.md b/README.md
@@ -32,6 +32,8 @@
 
 [✓] 通过 auth proxy 功能实现sso登录 (配合第三方身份验证反向代理 可实现支持 LDAP/OIDC/SAML 等协议登录)
 
+[✓] Web Search 网络搜索功能 (基于 Tavily API 实现实时网络搜索)
+
 
 > [!CAUTION]
 > 声明：此项目只发布于 Github，基于 MIT 协议，免费且作为开源学习使用。并且不会有任何形式的卖号、付费服务、讨论群、讨论组等行为。谨防受骗。
@@ -74,6 +76,13 @@
 		- [手动打包](#手动打包)
 			- [后端服务](#后端服务-1)
 			- [前端网页](#前端网页-1)
+	- [Auth Proxy Mode](#auth-proxy-mode)
+	- [Web Search 网络搜索功能](#web-search-网络搜索功能)
+		- [功能特性](#功能特性)
+		- [配置方式](#配置方式)
+		- [使用方式](#使用方式)
+		- [技术实现](#技术实现)
+		- [注意事项](#注意事项)
 	- [常见问题](#常见问题)
 	- [参与贡献](#参与贡献)
 	- [赞助](#赞助)
@@ -358,6 +367,92 @@ pnpm build
 
 当前 Idp 使用 OIDC 协议的 可以选择使用 [oauth2-proxy](https://oauth2-proxy.github.io/oauth2-proxy)
 
+## Web Search 网络搜索功能
+
+> [!TIP]
+> Web Search 功能基于 [Tavily API](https://tavily.com/) 实现，可以让 ChatGPT 获取最新的网络信息来回答问题。
+
+### 功能特性
+
+- **实时网络搜索**: 基于 Tavily API 获取最新的网络信息
+- **智能查询提取**: 自动从用户问题中提取最相关的搜索关键词
+- **搜索结果整合**: 将搜索结果无缝整合到 AI 对话中
+- **按会话控制**: 每个对话可以独立开启或关闭搜索功能
+- **搜索历史记录**: 保存搜索查询和结果到数据库
+- **可配置系统消息**: 支持自定义搜索相关的系统提示消息
+
+### 配置方式
+
+#### 1. 获取 Tavily API Key
+
+1. 访问 [Tavily 官网](https://tavily.com/) 注册账号
+2. 获取 API Key
+
+#### 2. 管理员配置
+
+1. 以管理员身份登录系统
+2. 进入系统设置页面
+3. 找到 "Web Search 配置" 选项
+4. 填写以下配置：
+   - **启用状态**: 开启/关闭全局搜索功能
+   - **API Key**: 填入 Tavily API Key
+   - **搜索查询系统消息**: 用于提取搜索关键词的提示模板
+   - **搜索结果系统消息**: 用于处理搜索结果的提示模板
+
+#### 3. 系统消息模板
+
+**搜索查询提取模板** (用于从用户问题中提取搜索关键词):
+```
+You are a search query extraction assistant. Extract the most relevant search query from user's question and wrap it with <search_query></search_query> tags.
+Current time: {current_time}
+```
+
+**搜索结果处理模板** (用于处理包含搜索结果的对话):
+```
+You are a helpful assistant with access to real-time web search results. Use the provided search information to give accurate and up-to-date responses.
+Current time: {current_time}
+```
+
+### 使用方式
+
+#### 用户端操作
+
+1. **开启搜索功能**:
+   - 在对话界面中，找到搜索开关按钮
+   - 点击开启当前会话的网络搜索功能
+
+2. **提问获取实时信息**:
+   - 开启搜索后，直接向 ChatGPT 提问需要实时信息的问题
+   - 系统会自动搜索相关信息并整合到回答中
+
+3. **查看搜索历史**:
+   - 搜索查询和结果会保存在数据库中
+   - 可以通过数据库查看具体的搜索记录
+
+#### 工作流程
+
+1. **用户提问**: 用户在开启搜索的会话中提问
+2. **查询提取**: 系统使用 AI 从问题中提取搜索关键词
+3. **网络搜索**: 调用 Tavily API 进行实时搜索
+4. **结果整合**: 将搜索结果作为上下文提供给 AI
+5. **生成回答**: AI 基于搜索结果生成更准确的回答
+
+### 技术实现
+
+- **搜索引擎**: Tavily API
+- **查询提取**: 使用 OpenAI API 智能提取关键词
+- **结果格式**: JSON 格式存储完整搜索结果
+- **数据存储**: MongoDB 存储搜索查询和结果
+- **超时设置**: 搜索请求超时时间为 300 秒
+
+### 注意事项
+
+- Web Search 功能需要额外的 Tavily API 费用
+- 搜索功能会增加响应时间
+- 建议根据实际需求选择性开启
+- 管理员可以控制全局搜索功能的开启状态
+- 每个会话可以独立控制是否使用搜索功能
+
 
 ## 常见问题
 Q: 为什么 `Git` 提交总是报错？
