Files
wehub-resource-sync 1443d3fdf9
Ruff Format Check / Ruff Format & Lint (push) Failing after 7m39s
Deploy VitePress site to Pages / build (push) Failing after 9m11s
Deploy VitePress site to Pages / Deploy (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 12:32:26 +08:00

84 lines
2.4 KiB
Markdown

# 其他配置
本文档介绍 Yuxi 的其他配置选项,包括内容安全、网页搜索和服务端口等。
## 内容安全
系统内置内容审查机制,帮助保障服务内容的合规性。
### 启用方式
在「系统设置」→「基本设置」页面中配置,可选择启用关键词过滤和 LLM 内容审查。
### 检测流程
系统会在以下时机进行检测:
1. **用户输入检测**:接收到用户消息后立即检测
2. **流式输出检测**:实时检测输出的关键词(仅关键词模式)
3. **输出完成检测**:流式输出结束后进行全面检测
### 检测模式
**关键词检测**
敏感词库位于 `backend/package/yuxi/config/static/bad_keywords.txt`,每行一个关键词。修改后实时生效,无需重启服务。
**LLM 检测**
使用大模型对内容进行审查,可以更好地识别提示词注入等复杂问题,但会增加响应延迟。
::: warning 性能考虑
LLM 检测会增加用户交互的延迟,请根据实际需求选择是否启用。
:::
## 网页搜索
系统集成了 Tavily 联网搜索能力,让大模型能够获取实时网页信息。
### 配置步骤
1. 访问 [Tavily 官网](https://app.tavily.com/) 注册并创建 API Key
2.`.env` 文件中添加:
```env
TAVILY_API_KEY=sk-xxxxxxxxxxxxxxxx
```
3. 重启服务:
```bash
docker compose up -d api-dev web-dev
```
### 使用方式
配置完成后,在智能体的工具配置区域会看到 Tavily 搜索工具。模型会自动判断何时需要调用搜索来获取最新信息。
如需关闭,删除或清空 `TAVILY_API_KEY` 后重启服务即可。
## 服务端口
系统各服务通过以下端口提供访问:
| 端口 | 服务 | 说明 |
|------|------|------|
| 5173 | Web 前端 | 用户界面 |
| 5050 | API 后端 | 核心服务接口 |
| 7474 | Neo4j HTTP | 图数据库管理界面 |
| 7687 | Neo4j Bolt | 图数据库连接 |
| 9000/9001 | MinIO | 对象存储 |
| 19530/9091 | Milvus | 向量数据库 |
| 5432 | PostgreSQL | 业务数据库 |
### 可选服务端口
| 端口 | 服务 | 说明 |
|------|------|------|
| 30000 | MinerU | PDF 解析服务 |
| 8080 | PP-Structure-V3 | OCR 服务 |
| 8081 | vLLM | 本地推理服务 |
### 快速访问
- Web 界面:http://localhost:5173
- API 文档:http://localhost:5050/docs
- Neo4j 管理:http://localhost:7474