Server has 5 tools with explicit schemas and descriptions, but quality is uneven. All tools are READ_ONLY and lack destructive/idempotent annotations. Descriptions are present but brief (avg 95 chars, below 194-char baseline). Parameter descriptions are minimal or absent. No output schemas documented. Error handling is basic (generic error messages, no recovery guidance). Tools are well-named with action verbs (list_, get_, ask_, chat_result, bot_chats), but parameter documentation is sparse. The ask_bot tool has internal polling logic (60s timeout) but no guidance on timeout recovery. No pagination support despite potential for large result sets (bot_chats returns 'latest 100' but no limit/offset params). Missing field-level descriptions for complex params like 'history' array items.
向某个知识库客服机器人提问,自动提交并轮询异步任务直到拿到回答(最长等 60 秒)
查看自己某个机器人的最近 100 条问答记录(需要 LOOKHERE_TOKEN)
按 job_id 轮询一次问答任务结果(ask_bot 已内置等待,一般无需手动调用)
按分享 ID 公开查询一个机器人的信息(无需鉴权)
列出自己创建的所有知识库客服机器人(需要 LOOKHERE_TOKEN)
No output schemas documented. LLMs cannot predict response structure (fields, types, nesting). ask_bot returns {job_id, status, reply} but this is inferred from code, not declared in tool definition. chat_result returns {status, reply} but structure is undocumented.
Parameter descriptions are missing or incomplete. 'history' param in ask_bot has description but array items lack field-level docs (role and content types/constraints unclear). 'botId' in bot_chats has minimal description. LLMs cannot infer valid formats.
No error recovery guidance. ask_bot can timeout after 60s, returning {status: 'timeout', hint: '...'}. But error responses lack actionable next steps. Generic error messages ('lookhere.help POST /api/chat/:shareId failed: ...') do not guide LLM on retry strategy or fallback.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 53 | 2026-07-28+ | v2 |
Missing tool annotations. All tools are READ_ONLY but lack explicit readOnlyHint in schema. No destructiveHint or idempotentHint declared. LLMs cannot infer safety properties without annotations.
No pagination support. bot_chats returns 'latest 100' but tool has no limit/offset params. Large result sets risk context window exhaustion. ask_bot polling is internal (60s timeout) but no way to resume or paginate if results exceed limits.