TAG

#JSON Schema

共 6 篇文章

MCP 工具参数默认值与必填校验:为什么 inputSchema 里省略的字段会让服务端收到 undefined

Agent 调用带可选参数的 MCP 工具时,模型省略字段常让服务端收到缺键参数对象,引发解引用报错或空值写入。文章从 JSON Schema 中 required 与 default 的语义边界出发,说明缺键如何产生、校验点应放在哪里,并比较客户端预填与服务端容错解析的取舍。

MCP 工具参数类型强制转换:为什么模型输出的字符串数字会让服务端校验失败

Agent 调用带数值与布尔参数的 MCP 工具时,模型常把 5 写成 "5"、把 true 写成 "true",服务端按 inputSchema 严格校验就会直接拒绝。本文用一个库存查询工具贯穿全文,梳理类型声明、序列化路径、隐式转换歧义与枚举大小写问题,并对比客户端预校验与服务端宽松解析的取舍。

MCP 工具输出校验:structuredContent 与 outputSchema 不一致时客户端为何解析失败

远程 MCP Server 返回结构化工具结果时,outputSchema 声明返回结构,structuredContent 承载实际负载。本文用一个订单查询工具贯穿全文,分析二者不一致、schema 未声明、客户端只读 content 文本分支时各自的解析失败路径,对比纯文本封装与严格校验两种方案,并给出服务端与客户端的校验点和可观测指标。

MCP Elicitation 中途索要参数:工具执行到一半如何安全地向人类追问

工具跑到一半才发现缺少必填参数,直接报错会让用户重来一遍。本文以订位工具为例,拆解 MCP elicitation/create 如何暂停调用、用受限 JSON Schema 收集结构化输入并恢复执行,分析 accept、decline、cancel 三条路径、schema 校验失败与超时处理、敏感字段为何必须走 URL 模式,并给出可观测指标与适用边界。

MCP 工具定义注入如何挤占上下文:工具 schema 的 token 开销与按需加载机制

接入多个 MCP Server 的 Agent 为什么越接越笨?本文从工具名、描述与 JSON Schema 被序列化进系统提示并随每轮请求重复计费讲起,分析工具数量增长带来的上下文挤占与选择准确率下降,对比全量注入、检索式筛选与动态发现三种加载策略的延迟与可靠性权衡,并给出可观测指标与适用边界。