Two tools with Chinese descriptions and basic schemas. search_feishu_doc has a dynamic enum (good), but both tools lack English descriptions, making them inaccessible to non-Chinese-speaking agents. Parameter descriptions are minimal. Output schemas are not documented in the code. Error handling is absent, no guidance on what to do if a document is not found or the API fails. The tools are READ_ONLY, which is correct, but this is not declared via toolAnnotations. Overall structure is present but falls short of production quality.
读取飞书开放平台文档的详细内容。根据文档路径获取完整的 API 说明,并保存到本地临时文件。返回文件路径和文件大小,如果文件较大会包含警告提示。使用 Read 工具读取文件内容,对于大文件建议使用 offset/limit 参数分段读取或使用 Grep 搜索特定内容。
搜索飞书开放平台 API 文档。根据分类浏览文档列表,返回该分类下所有文档的标题和路径。适用于查找特定 API 接口、了解某个功能模块有哪些接口等场景。
Descriptions are in Chinese only; non-Chinese-speaking agents cannot understand when or why to call these tools. LLMs require descriptions in their training language to reason about tool selection.
Output schemas are not documented. Callers cannot know what fields to expect from search_feishu_doc (does it return paths, IDs, metadata?) or read_feishu_doc (file path, size, content preview?). This forces LLMs to guess and wastes tokens on trial-and-error.
No error handling or recovery guidance. If a document path is invalid or the API times out, the tools return raw errors with no actionable next steps for the agent. Missing pattern: recovery-guide.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
READ_ONLY operations are not declared via toolAnnotations (readOnlyHint). Agents cannot distinguish safe tools from destructive ones, risking incorrect retry logic or permission assumptions.
Parameter 'category' in search_feishu_doc uses dynamic enum (good), but the description is vague about format. Parameter 'path' in read_feishu_doc has no validation rules or format hints (e.g., is it a URL, file path, or opaque ID?).