Yuxi 智能知识库与知识图谱平台核心后端包 - An intelligent knowledge base and knowledge graph platform built on LangGraph v1 + Vue.js + FastAPI + LightRAG architecture
Yuxi provides 9 tools with mostly complete schemas and descriptions in Chinese. Naming follows verb_noun patterns (web_search, query_kb, download_kb_file). Descriptions are detailed (100-300 chars) and include usage scenarios. However, several tools lack output schema documentation, parameter descriptions are sometimes vague, and error handling guidance is absent. Tools like web_search and query_kb have good parameter constraints (enums, ranges), but present_artifacts and list_kbs have minimal parameter documentation. No tool annotations (readOnlyHint/destructiveHint) are visible. Risk labels (READ_ONLY, WRITE) are present but not formalized in schema.
下载知识库文件的原始二进制(pdf/docx/xlsx 等)到沙盒 outputs 目录。 当后续需要对原始文件结构做处理时使用:例如用 openpyxl/pandas 读取 xlsx 单元格、 用 pdfplumber/python-docx 重新解析版面。query_kb/open_kb_document 只返回文本切片, 无法满足这类需要文件对象的场景。返回的 virtual_path 是沙盒内可见路径,可直接在代码中读取。 kb_id 是知识库资源 ID;file_id 来自 query_kb 或 search_file 的返回结果。
在已知知识库文件内做关键词或正则定位。 当 query_kb 已找到候选文件,但需要在该文件内定位术语、指标、章节或实体时使用。
获取指定知识库的思维导图结构 当用户想要了解知识库的整体结构、文件分类、知识架构时使用此工具。 返回知识库的思维导图层级结构。
列出当前用户可访问的知识库列表 返回用户基于权限可访问的知识库名称列表。这个列表是根据用户的角色和部门信息过滤后的结果, 但不包括用户在当前对话中未启用的知识库。
按行窗口打开知识库文档原文 当 query_kb 返回的片段不足以回答问题,或需要查看某个文档的上下文时使用。 kb_id 是知识库资源 ID,也就是 kb_id;file_id 是知识库文件 ID。
将已经生成好的结果文件展示给用户。 使用场景: 1. 你已经写好了最终结果文件;建议放在当前 Project Workdir 的 `outputs/` 下 2. 你希望前端在对话结束后显示这些结果文件卡片 3. 这些文件需要支持下载或预览 注意事项: 1. 可以传入当前 Project Workdir、User Data 或已授权 Skills 中的普通文件 2. 不要传入中间过程文件,只有真正需要给用户看的结果文件才调用 3. 可以一次传多个文件
Output schemas not documented. Tools return results but LLMs cannot predict response structure (fields, types, pagination). Forces agents to guess at downstream field names.
list_kbs has a 'dummy' parameter with trivial description ('Dummy parameter - ignore'). This is anti-pattern; either remove it or document its actual purpose. Confuses LLMs about whether the parameter is required.
present_artifacts filepaths parameter lacks validation guidance. No mention of path traversal protection, allowed directories, or file size limits. Agents could attempt to expose sensitive files.
No error handling guidance in any tool description. LLMs do not know what to do if query_kb returns no results, download_kb_file fails, or kb_id is invalid. No recovery hints provided.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | B | 70 | 2026-07-28+ | v2 |
在指定知识库中检索内容 当用户需要查询具体内容时使用此工具。kb_id 是知识库资源 ID,也就是 kb_id;返回结果中的 file_id 可继续用于 find_kb_document 或 open_kb_document。
搜索知识库中的文件 当用户需要查找特定文件时使用此工具。可以指定知识库名称和搜索关键词。 如果不指定知识库,将搜索所有可访问的知识库。 如果不指定搜索关键词,将返回所有文件。
执行网络网页搜索,通过豆包联网搜索获取实时高质量互联网网页内容、新闻和站点资料。 适用场景: 1. 获取最新的时事新闻、即时信息或最新科技动态 2. 检索特定网站的内容(通过 sites 参数指定) 3. 查找指定时间范围内发布的新闻或文章(通过 time_range 参数过滤) 参数使用建议: - query: 输入简短清晰的搜索关键词或简短提问 - count: 默认 10 条,深度调研可适当调大(最多 50 条) - time_range: 需要最新消息或时效性强的资讯时建议传入 'OneDay'、'OneWeek' 或 'OneMonth' - sites: 仅需特定站点(如官媒、平台)时传入站点域名
Tool annotations (readOnlyHint, destructiveHint, idempotentHint) are absent from schema. Risk labels exist in comments (READ_ONLY, WRITE) but are not formalized in the MCP tool definition, limiting agent safety reasoning.