ForcePilot/docs/advanced/misc.md
Wenjie Zhang 62bb928064 refactor: 更新文档部署说明
- 移除对于双版本文档的支持,更加清晰
- 将 docs 的入口从根目录移动到子目录
2026-03-24 11:09:46 +08:00

84 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 其他配置
本文档介绍 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