fix(import): единая идентичность внешних URI (#96)
Единая 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>
This commit was merged in pull request #96.
This commit is contained in:
1 parent
178093e81b
commit
1b6db09bd1
22 files changed
+1669
-353
No files matched your search
@@ -0,0 +1,170 @@
|
||||
{
|
||||
"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"
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user