DeepAgentForce 使用手册
欢迎使用 DeepAgentForce 智能助手平台！本手册将帮助你快速上手并掌握核心功能。
🚀 快速开始
注册并登录
首次访问系统，点击注册创建账号，或使用已有账号登录。登录后将进入主界面。
配置大模型
点击左侧「配置」菜单，填写模型 API 地址、API Key 和模型名称。支持 OpenAI、OpenRouter 等兼容接口。
开始对话
在主对话界面输入问题，AI 将自动分析意图并生成回答。你还可以上传文件、构建知识库、使用各种工具技能。
⭐ 核心功能
图 1：DeepAgentForce 系统架构
智能对话
基于大语言模型的智能问答，支持多轮对话、上下文理解和文件上传。
思考可视化
清晰展示 AI 的思考过程和工具调用步骤，让决策透明可见。
知识库
上传私有文档，构建专属知识库。AI 会基于你的资料回答专业问题。
Agent Skills
模块化工具扩展系统，支持 PDF 处理、联网搜索等自动调用能力。
文件下载
AI 生成的文件（作文、报告等）自动保存，点击即可下载。
用户画像
AI 自动学习用户偏好和行为模式，越用越懂你。
多租户支持
支持团队协作，多成员共享工作空间，独立管理配置和知识库。
📥 文件下载
下载 AI 生成的文件
当 AI 生成文件（如作文、报告、代码等）时，可以要求 AI 保存到指定位置。文件会自动保存到你的下载目录中。
请求 AI 保存文件
例如：「帮我写一篇关于春天的作文，并保存到文件」
AI 自动保存
AI 会将文件保存到 data/outputs/{租户ID}/ 目录
点击下载
点击页面右上角的「下载」按钮，在弹出的列表中查看和下载文件
💬 智能对话
图 2：智能对话界面
基础 如何提问
在底部的输入框中输入你的问题，按 Enter 或点击发送按钮即可。AI 会自动分析问题并生成回答。
进阶 上传文件
点击输入框左侧的 📎 图标，可上传 PDF、Word、TXT、Markdown 等格式文件。AI 会读取文件内容并结合回答。
技巧 多会话管理
点击左侧的「+」按钮可开启新对话。所有对话会自动保存在历史记录中，方便随时回顾和继续。
🛠️ Skill 管理界面
图 3：可视化 Skill 管理界面
📚 知识库管理
构建专属知识库
进入「知识库」页面，上传你的私有文档（PDF、Word、TXT、Markdown），系统会自动向量化并建立索引。之后的相关问题会优先检索你的知识库内容。
| 支持的格式 | 说明 |
|---|---|
| 最常用的文档格式，支持文本和图片提取 | |
| Word (.docx) | 微软 Office 文档，支持段落和表格 |
| TXT | 纯文本文件，最简单可靠 |
| Markdown | 支持代码和格式的轻量级标记语言 |
图 4：知识库管理界面
🛠️ Agent Skills
Agent Skills 是系统的模块化扩展能力。当 AI 识别到需要特定工具时，会自动调用对应的 Skill。
PDF Processing
PDF 文档处理：提取文本、表格，支持合并/拆分文档。
RAG Query
企业知识库问答：从你上传的文档中检索相关信息。
Web Search
联网搜索：实时获取网络上的最新信息。
自定义 Skills
支持开发者自行扩展新的工具技能，满足个性化需求。
⚙️ 模型配置
配置说明
在「配置」页面填写大模型的连接信息。配置会自动保存，下次启动时无需重新填写。
| 配置项 | 说明 | 示例 |
|---|---|---|
| LLM URL | 模型 API 的 Base 地址 | https://openrouter.ai/api/v1 |
| LLM API Key | 访问模型的密钥 | sk-or-xxxxx |
| LLM Model | 使用的模型名称 | anthropic/claude-3.5-sonnet |
图 5：模型配置页面
❓ 常见问题
Q: 提示"未连接到服务器"怎么办？
确保后端服务正在运行（执行 python main.py）。检查网络连接是否正常。
Q: AI 回复很慢或无响应？
可能是模型 API 响应较慢，或网络连接不稳定。可以检查「配置」页面的模型设置是否正确。
Q: 如何下载 AI 生成的文件？
点击页面右上角的「下载」按钮。确保在对话中让 AI 保存了文件（如「帮我保存这篇作文」）。
Q: 多租户是什么意思？
每个账号（租户）有独立的数据空间，包括上传的文档、生成的配置文件等。不同租户之间数据完全隔离，确保隐私安全。
Q: 如何让 AI 使用我的文档回答？
在「知识库」页面先上传文档，之后的对话会自动检索相关内容。
Q: 知识库搜索不准确？
确保文档内容清晰、格式规范。复杂 PDF 建议先转换为纯文本格式上传。