Two tools with complete schemas and descriptions, but descriptions are generic and lack LLM-optimized guidance. Tool names follow verb_noun pattern (list_, search_) which is good. However, descriptions lack actionable context about when to use each tool, what prerequisites exist, or how results chain together. Parameters are typed but lack detailed constraints (e.g., threshold range 0-1 is mentioned but not enforced in schema). No output schema documentation. Error handling returns text but lacks recovery guidance. Overall: functional but below production baseline.
列出 Cherry Studio 知识库目录下所有可用知识库及其统计信息(向量数量、维度、文件大小等)。
在 Cherry Studio 知识库中通过自然语言进行向量相似度搜索,返回最相关的文档片段。
Missing output schema documentation. Tools return text content but LLMs cannot infer structure of results (e.g., search_knowledge returns similarity scores and source fields, but this is not formally documented). Agents cannot reliably extract and chain results.
Descriptions lack LLM-optimized guidance. 'list_knowledge_bases' description (Chinese) is 28 chars; 'search_knowledge' is 48 chars. Both fall below the 50-200 char baseline for A+ tools. Neither explains WHEN to call the tool, what prerequisites exist, or how to interpret results. Descriptions are feature-focused, not intent-focused.
Parameter 'threshold' lacks schema constraints. Description mentions '0 - 1' range but JSON Schema has no minimum/maximum. LLMs may pass invalid values (e.g., 1.5, -0.5) without validation feedback.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
Error responses lack recovery guidance. When search fails, response is 'execution error: <message>' with no actionable next step. Pattern requires: 'User not found. Try search_users() with a partial name.' This server offers no such guidance.
No pagination support. search_knowledge returns results but no indication of total count, next_cursor, or whether results are truncated. If 100+ matches exist, LLM cannot iterate through them.