Spring AI Agent Harness - ReAct/PSE/RAG/MCP/Skills/Docker Sandbox full-stack AI Agent development framework
Spring Harness defines 8 tools with mixed quality. Most tools have descriptions (6/8 present, though some are verbose and in Chinese), but critical gaps exist: parameter schemas are largely absent or incomplete in the source code provided. Tool names follow verb_noun convention (calculator, get_datetime, query_stock, etc.), which is good. However, input schemas visible in the config are minimal, only calculator, get_datetime, query_exchange_rate, and read_project_file show explicit parameter definitions with types and descriptions. execute_code, skill_run, and search_knowledge lack visible input schemas in the provided source. Output schemas are not documented anywhere. Error handling guidance is absent. The execute_code tool is marked IRREVERSIBLE but has no confirmation or dry-run pattern. Overall, this is a typical community server with decent naming but incomplete schema documentation and no error recovery guidance.
通用计算器,支持加减乘除运算
在 Docker 沙箱中执行代码,支持 python、javascript、shell、java、go、rust、c、cpp。返回标准输出、标准错误、退出码和执行时间。适用于复杂计算、数据分析、算法验证、文件处理等需要实际运行代码的场景。
获取当前日期和时间,包括星期几
查询实时汇率,支持美元(USD)、欧元(EUR)、日元(JPY)、港币(HKD)、英镑(GBP)等货币兑人民币(CNY)的实时汇率,返回汇率和更新时间。需要换算货币时必须调用此工具,不要自行估算汇率。
查询股票实时行情(稳定可用,优先使用)。返回当前价格、涨跌幅、开盘价、最高价、最低价、成交量。支持美股(AAPL, MSFT, TSLA)、港股(0700.HK)、A股(600519.SS)。注意:默认只查实时行情,不要主动查历史数据。仅当用户明确要求'历史数据'、'K线'、'过去N天股价'时,才传interval=daily/weekly/monthly参数查询历史数据(历史数据有频率限制,可能失败)
读取项目目录下的本地文本文件内容。当需要审查代码、查看配置、分析文件内容、执行 code-review 等技能时使用。参数为文件路径(相对于项目根目录,如 src/main/java/com/example/MyClass.java)。安全限制:只能读取项目目录下的文本文件,不能读取 .env 等敏感文件,单文件最大 100KB。注意:与 MCP 的 read_file 不同,此工具专门读取项目源代码文件。
query_stock and skill_run lack visible input schemas in source code. Cannot verify parameter types, required fields, or constraints.
execute_code is marked IRREVERSIBLE (can delete files, run arbitrary code) but has no confirmation step, dry-run mode, or recovery guidance. Violates confirmation-request pattern.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract structured data. Violates tool and response-shaper patterns.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2026-07-28+ | v2 |
知识库语义检索(Rerank 精排):基于已上传的知识库文档(PDF/TXT/MD)检索并精排与问题最相关的文本片段。当用户问题涉及已上传文档的内容(如产品资料、项目文档、规章制度等)时,先调用此工具检索相关上下文,再基于检索结果回答;不要凭印象编造知识库内容。参数:query(检索问题/关键词)、topK(返回片段数,默认4,最大8)。
加载指定技能的完整指令。当用户的需求匹配某个技能时,先调用此工具加载技能的详细步骤和规则,再按技能要求执行。参数为技能名称。
Descriptions for query_stock and search_knowledge are verbose (>300 chars) and include example values ('AAPL, MSFT, TSLA', 'topK default 4'). LLMs may reuse examples literally. Descriptions should be 50-200 chars with constraints in schema, not text.
No error handling guidance. Tools do not indicate which errors are retryable, user-fixable, or fatal. No recovery suggestions (e.g., 'If stock not found, try a different ticker').