Единая transport-canonical идентичность внешних документов; normalizer v6 с immutable historical replay; matrix 1.0.4 / corpus 1.0.5. PR CI run840 success, локальная приёмка и independent review выполнены. Co-authored-by: bsodfather <bsodfather@gmail.com>
171 lines
6.2 KiB
JSON
171 lines
6.2 KiB
JSON
{
|
||
"dependencies": [],
|
||
"dependency_snapshots": [],
|
||
"normalization": {
|
||
"config": {
|
||
"external_references_enabled": false,
|
||
"max_aliases": 128,
|
||
"max_bytes": 262144,
|
||
"max_collection_items": 10000,
|
||
"max_depth": 64,
|
||
"max_expanded_nodes": 100000,
|
||
"max_external_document_bytes": 262144,
|
||
"max_nodes": 50000,
|
||
"max_reference_depth": 32,
|
||
"max_reference_documents": 32,
|
||
"max_references": 4096,
|
||
"max_scalar_bytes": 262144,
|
||
"normalizer_version": "normalized-ir-v5",
|
||
"projection_version": "preview-v6"
|
||
},
|
||
"ir_fingerprint": "1e7a724e849b657d79d78f494d962ba5ebc164f154902153a8ed0610e0744679",
|
||
"normalizer_version": "normalized-ir-v5",
|
||
"projection_version": "preview-v6"
|
||
},
|
||
"preview": {
|
||
"findings": [],
|
||
"groups": [
|
||
{
|
||
"key": "imported_operation",
|
||
"operations": [
|
||
{
|
||
"category": "imported",
|
||
"description": "Выполняет GET /items",
|
||
"draft": {
|
||
"category": "imported",
|
||
"display_name": "List Items",
|
||
"input_mapping": {},
|
||
"input_schema": {
|
||
"description": "Входные параметры MCP-инструмента",
|
||
"nullable": false,
|
||
"required": true,
|
||
"type": "object"
|
||
},
|
||
"name": "list_items",
|
||
"output_mapping": {
|
||
"rules": [
|
||
{
|
||
"required": true,
|
||
"source": "$.response.body.id",
|
||
"target": "$.output.id"
|
||
}
|
||
]
|
||
},
|
||
"output_schema": {
|
||
"description": "Ответ API",
|
||
"fields": {
|
||
"id": {
|
||
"nullable": false,
|
||
"required": true,
|
||
"type": "string"
|
||
}
|
||
},
|
||
"nullable": false,
|
||
"required": true,
|
||
"type": "object"
|
||
},
|
||
"target": {
|
||
"base_url": "https://api.example.test",
|
||
"method": "GET",
|
||
"path_template": "/items",
|
||
"response_contract": [
|
||
{
|
||
"media_type": "application/json",
|
||
"schema_variant": 0,
|
||
"status_code": 200
|
||
}
|
||
]
|
||
},
|
||
"tool_description": {
|
||
"description": "Выполняет GET /items",
|
||
"examples": [
|
||
{
|
||
"input": {}
|
||
}
|
||
],
|
||
"title": "List Items"
|
||
},
|
||
"wizard_state": {}
|
||
},
|
||
"findings": [
|
||
{
|
||
"code": "missing_summary",
|
||
"message": "У метода нет summary, отображаемое имя будет сгенерировано автоматически.",
|
||
"operation_key": "GET /items",
|
||
"severity": "warning",
|
||
"source_location": {
|
||
"pointer": "/paths/~1items/get"
|
||
}
|
||
},
|
||
{
|
||
"code": "missing_description",
|
||
"message": "У метода нет description. Перед публикацией лучше описать, когда агенту стоит вызывать этот инструмент.",
|
||
"operation_key": "GET /items",
|
||
"severity": "warning",
|
||
"source_location": {
|
||
"pointer": "/paths/~1items/get"
|
||
}
|
||
},
|
||
{
|
||
"code": "no_input_fields",
|
||
"message": "У инструмента нет входных параметров. Это нормально для справочных методов, но проверьте, что агенту не нужно передавать фильтры.",
|
||
"operation_key": "GET /items",
|
||
"severity": "info",
|
||
"source_location": {
|
||
"pointer": "/paths/~1items/get"
|
||
}
|
||
},
|
||
{
|
||
"code": "weak_tool_description",
|
||
"message": "Описание инструмента слишком короткое или техническое. Перед публикацией добавьте, когда агент должен вызывать инструмент и что будет в успешном ответе.",
|
||
"operation_key": "GET /items",
|
||
"severity": "warning",
|
||
"source_location": {
|
||
"pointer": "/paths/~1items/get"
|
||
}
|
||
},
|
||
{
|
||
"code": "weak_tool_name",
|
||
"message": "Имя инструмента `list_items` выглядит слишком общим. Лучше использовать имя с конкретным действием и объектом.",
|
||
"operation_key": "GET /items",
|
||
"severity": "warning",
|
||
"source_location": {
|
||
"pointer": "/paths/~1items/get"
|
||
}
|
||
}
|
||
],
|
||
"input_fields": 0,
|
||
"key": "GET /items",
|
||
"method": "GET",
|
||
"operation_id": "listItems",
|
||
"output_fields": 1,
|
||
"path": "/items",
|
||
"server_urls": [
|
||
"https://api.example.test"
|
||
],
|
||
"source_location": {
|
||
"pointer": "/paths/~1items/get"
|
||
},
|
||
"suggested_display_name": "List Items",
|
||
"suggested_name": "list_items"
|
||
}
|
||
],
|
||
"title": "Без группы"
|
||
}
|
||
],
|
||
"source": {
|
||
"format": "openapi",
|
||
"servers": [
|
||
"https://api.example.test"
|
||
],
|
||
"title": "URI preview parity",
|
||
"version": "3.1.0"
|
||
}
|
||
},
|
||
"preview_digest": "ab615bbb932979b3c9d7d78223fc932069e1d7443860a24c682edddc0de11637",
|
||
"source": {
|
||
"digest": "sha256:edc9f4ec760d76a6830ae5b9932881d898626faffbc0067162ddb44ebdf8b94c",
|
||
"source_id": "src_openapi_01a1278095397d018780ab3dafd4b464"
|
||
}
|
||
}
|