{ "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" } }