SkoIA Parts
Resolve part problems, check compatibility and identify only the information still missing.
我该使用它吗
质量与安全性
A
发现（3）
- LOWTool 'get_next_observation' description lacks action verb在 get_next_observation 中
- LOWTool 'get_product' description lacks action verb在 get_product 中
- LOWTool 'get_compatibility' description lacks action verb在 get_compatibility 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~6,963token 数（工具定义）
~4.6 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 5.44%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"skoia-parts": {
"url": "https://parts.skoia.me/mcp"
}
}
}远程端点
https://parts.skoia.me/mcpstreamable-http它能做什么
工具清单
工具（15）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢understand_physical_problem(description)
Builds the canonical PhysicalProblem, Observation Graph and explicit unknown set from the supplied description.
输入模式
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_next_observation(description)
Returns the single highest-value missing observation without promoting hypotheses to facts.
输入模式
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢generate_hypotheses(description)
Explores candidate transformations from the same PhysicalProblem and labels every unverified candidate as HYPOTHESIS.
输入模式
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢search_candidates(query, limit)
Searches the verified local index for candidates; a candidate is never presented as an identified product without evidence.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 8
}
},
"required": [
"query"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢synthesize_physical_solution(description)
Runs the canonical resolver and returns either a supported solution or the next required observation.
输入模式
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"required": [
"description"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢verify_solution(description, candidate)
Checks a proposed candidate independently against the canonical constraints and reports verification separately from generation.
输入模式
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"candidate": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"description",
"candidate"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢generate_artifact(solutionId, format, entitlement)
Generates only LIVE deterministic formats after plan acceptance and verification; STEP remains unavailable.
输入模式
{
"type": "object",
"properties": {
"solutionId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"format": {
"type": "string",
"enum": [
"STL",
"3MF",
"OPENSCAD"
]
},
"entitlement": {
"type": "string",
"enum": [
"FREE",
"PAID_VERIFIED"
],
"default": "FREE"
}
},
"required": [
"solutionId",
"format"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_verified_commerce_options(query, limit, surface)
Returns discovery candidates separately from RevenueGuard-approved monetizable offers and enforces distribution rights per surface.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 6
},
"surface": {
"type": "string",
"enum": [
"WEB",
"REST_API",
"MCP",
"WEBMCP",
"CHATGPT_APP",
"APIFY"
],
"default": "MCP"
}
},
"required": [
"query"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢search_parts(query, limit)
Searches the verified local product and part-type index without inventing identities.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 8
}
},
"required": [
"query"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢resolve_problem(description, intent, productA, productB, relationship)
Runs the deterministic problem-first resolver and returns the best supported next action or the minimum missing information.
输入模式
{
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"intent": {
"type": "string",
"enum": [
"CONNECT",
"REPAIR",
"FIND_OR_MAKE",
"MODIFY",
"CREATE"
]
},
"productA": {
"type": "string",
"maxLength": 200
},
"productB": {
"type": "string",
"maxLength": 200
},
"relationship": {
"type": "string",
"maxLength": 80
}
},
"required": [
"description"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_product(id)
Returns one canonical ProductTwin and its source-level provenance by stable identifier.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
}
},
"required": [
"id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_compatibility(productA, productB)
Compares two canonical ProductTwins. It reports direct compatibility only when their verified interface system matches.
输入模式
{
"type": "object",
"properties": {
"productA": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"productB": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
}
},
"required": [
"productA",
"productB"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_fit_guidance(nominalMm, fitType, measurementBasis, gender, material, ...)
Calculates deterministic manufacturing compensation and returns an explicit physical-test warning.
输入模式
{
"type": "object",
"properties": {
"nominalMm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000
},
"fitType": {
"type": "string",
"enum": [
"PRESS",
"TIGHT",
"SLIDING",
"LOOSE"
]
},
"measurementBasis": {
"type": "string",
"enum": [
"NOMINAL",
"INTERNAL",
"EXTERNAL"
]
},
"gender": {
"type": "string",
"enum": [
"MALE",
"FEMALE",
"NEUTRAL"
]
},
"material": {
"type": "string",
"maxLength": 20
},
"process": {
"type": "string",
"maxLength": 30
},
"userCalibrationMm": {
"type": "number",
"minimum": -5,
"maximum": 5
}
},
"required": [
"nominalMm",
"fitType"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢list_generation_options(intent)
Lists only generator families implemented by the current deterministic core.
输入模式
{
"type": "object",
"properties": {
"intent": {
"type": "string",
"enum": [
"CONNECT",
"REPAIR",
"CREATE"
]
}
},
"required": [],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}🟢get_offers(query, limit)
Deprecated compatibility adapter. Returns provider discovery only; use get_verified_commerce_options for separated verified output.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 6
}
},
"required": [
"query"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"const": 1
},
"tool": {
"type": "string"
},
"requestId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_.:-]{1,119}$"
},
"status": {
"type": "string",
"enum": [
"OK",
"NEEDS_INPUT",
"BLOCKED",
"UNAVAILABLE"
]
},
"facts": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"maxItems": 200
},
"confidence": {
"type": "object",
"additionalProperties": false,
"properties": {
"score": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"level": {
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW",
"UNKNOWN"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
}
},
"required": [
"score",
"level"
]
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"source": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"retrieved_at": {
"anyOf": [
{
"type": "string",
"maxLength": 40
},
{
"type": "null"
}
]
},
"verification_status": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "null"
}
]
}
},
"required": [
"type"
]
},
"maxItems": 30
},
"warnings": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"data": {
"type": "object",
"additionalProperties": true
}
},
"required": [
"schemaVersion",
"tool",
"requestId",
"status",
"facts",
"confidence",
"provenance",
"warnings",
"data"
],
"additionalProperties": false
}推荐提示词
search_research
Search for information about [topic] using SkoIA Parts
预期工具：
search_candidatesfind_specific
Find [specific item] using SkoIA Parts
预期工具：
search_candidatesretrieve_data
Get details about [item] from SkoIA Parts
预期工具：
get_next_observationfetch_info
Fetch [information type] using SkoIA Parts
预期工具：
get_next_observationlist_items
List all [items] available in SkoIA Parts
预期工具：
list_generation_options社区
证据
最近观测
已验证未记录版本15 个工具
已验证未记录版本15 个工具