update adp json-rpc Interface

Author: chgaowei

chinese/07-ANP-智能体描述协议规范(20250715)(draft).md

@@ -307,185 +307,273 @@ interface是智能体对外提供的接口，Interface分为两类接口：
 
 #### JSON-RPC 2.0 接口描述文档
 
-下面是一个JSON-RPC 2.0 接口描述文档的示例：
+下面是一个符合OpenRPC规范的JSON-RPC 2.0 接口描述文档示例：
 
 ```json
 {
-  "protocolType": "ANP",
-  "protocolVersion": "1.0.0",
-  "type": "JSON-RPC 2.0",
-  "url": "https://grand-hotel.com/api/jsonrpc-interface.json",
-  "security": {
-    "didwba": {
-      "scheme": "didwba",
-      "in": "header",
-      "name": "Authorization"
-    }
+  "openrpc": "1.3.2",
+  "info": {
+    "title": "Grand Hotel Services API",
+    "version": "1.0.0",
+    "description": "JSON-RPC 2.0 API for hotel services including room management, booking, and guest services",
+    "x-anp-protocol-type": "ANP",
+    "x-anp-protocol-version": "1.0.0"
   },
-  "transport": {
+  "security": [
+    {
+      "didwba": []
+    }
+  ],
+  "servers": [
+    {
+      "name": "Production Server",
+      "url": "https://grand-hotel.com/api/v1/jsonrpc",
+      "description": "Production server for Grand Hotel API"
+    }
+  ],
+  "x-transport": {
     "protocol": "HTTPS",
     "host": "grand-hotel.com",
     "path": "/api/v1/jsonrpc",
     "method": "POST",
     "port": 443,
-    "contentType": "application/json",
-  },
-  "info": {
-    "title": "Grand Hotel Services API",
-    "version": "1.0.0",
-    "description": "JSON-RPC 2.0 API for hotel services including room management, booking, and guest services"
+    "contentType": "application/json"
   },
   "methods": [
     {
       "name": "searchRooms",
-      "description": "Search available hotel rooms based on criteria",
-      "params": {
-        "type": "object",
-        "properties": {
-          "checkIn": {
-            "type": "string",
-            "format": "date",
-            "description": "Check-in date in YYYY-MM-DD format"
-          },
-          "checkOut": {
-            "type": "string", 
-            "format": "date",
-            "description": "Check-out date in YYYY-MM-DD format"
-          },
-          "guests": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 8,
-            "description": "Number of guests"
-          },
-          "roomType": {
-            "type": "string",
-            "enum": ["standard", "deluxe", "suite", "presidential"],
-            "description": "Preferred room type"
+      "summary": "Search available hotel rooms",
+      "description": "Search available hotel rooms based on criteria such as dates, number of guests, and room type",
+      "params": [
+        {
+          "name": "searchCriteria",
+          "description": "Room search criteria",
+          "required": true,
+          "schema": {
+            "type": "object",
+            "properties": {
+              "checkIn": {
+                "type": "string",
+                "format": "date",
+                "description": "Check-in date in YYYY-MM-DD format"
+              },
+              "checkOut": {
+                "type": "string", 
+                "format": "date",
+                "description": "Check-out date in YYYY-MM-DD format"
+              },
+              "guests": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 8,
+                "description": "Number of guests"
+              },
+              "roomType": {
+                "type": "string",
+                "enum": ["standard", "deluxe", "suite", "presidential"],
+                "description": "Preferred room type"
+              }
+            },
+            "required": ["checkIn", "checkOut", "guests"]
           }
-        },
-        "required": ["checkIn", "checkOut", "guests"]
-      },
+        }
+      ],
       "result": {
-        "type": "object",
-        "properties": {
-          "rooms": {
-            "type": "array",
-            "items": {
-              "$ref": "#/definitions/Room"
+        "name": "searchResult",
+        "description": "Search results containing available rooms",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "rooms": {
+              "type": "array",
+              "items": {
+                "$ref": "#/components/schemas/Room"
+              }
+            },
+            "total": {
+              "type": "integer",
+              "description": "Total number of available rooms"
             }
-          },
-          "total": {
-            "type": "integer",
-            "description": "Total number of available rooms"
           }
         }
       }
     },
     {
       "name": "makeReservation",
-      "description": "Create a new hotel reservation",
-      "params": {
+      "summary": "Create hotel reservation",
+      "description": "Create a new hotel reservation with guest information and booking details",
+      "params": [
+        {
+          "name": "reservationData",
+          "description": "Reservation information",
+          "required": true,
+          "schema": {
+            "type": "object",
+            "properties": {
+              "roomId": {
+                "type": "string",
+                "description": "Unique room identifier"
+              },
+              "guestInfo": {
+                "$ref": "#/components/schemas/GuestInfo"
+              },
+              "checkIn": {
+                "type": "string",
+                "format": "date",
+                "description": "Check-in date"
+              },
+              "checkOut": {
+                "type": "string",
+                "format": "date",
+                "description": "Check-out date"
+              },
+              "specialRequests": {
+                "type": "string",
+                "description": "Special requests or preferences"
+              }
+            },
+            "required": ["roomId", "guestInfo", "checkIn", "checkOut"]
+          }
+        }
+      ],
+      "result": {
+        "name": "reservationResult",
+        "description": "Reservation confirmation details",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "reservationId": {
+              "type": "string",
+              "description": "Unique reservation identifier"
+            },
+            "confirmationNumber": {
+              "type": "string",
+              "description": "Booking confirmation number"
+            },
+            "totalAmount": {
+              "type": "number",
+              "description": "Total reservation amount"
+            }
+          }
+        }
+      }
+    }
+  ],
+  "components": {
+    "securitySchemes": {
+      "didwba": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "DID-WBA",
+        "description": "DID-WBA authentication scheme"
+      }
+    },
+    "schemas": {
+      "Room": {
         "type": "object",
         "properties": {
-          "roomId": {
+          "id": {
             "type": "string",
             "description": "Unique room identifier"
           },
-          "guestInfo": {
-            "$ref": "#/definitions/GuestInfo"
-          },
-          "checkIn": {
+          "type": {
             "type": "string",
-            "format": "date"
+            "description": "Room type"
           },
-          "checkOut": {
-            "type": "string",
-            "format": "date"
+          "price": {
+            "type": "number",
+            "description": "Room price per night"
           },
-          "specialRequests": {
-            "type": "string",
-            "description": "Special requests or preferences"
+          "amenities": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "List of room amenities"
+          },
+          "availability": {
+            "type": "boolean",
+            "description": "Room availability status"
           }
-        },
-        "required": ["roomId", "guestInfo", "checkIn", "checkOut"]
+        }
       },
-      "result": {
+      "GuestInfo": {
         "type": "object",
         "properties": {
-          "reservationId": {
+          "firstName": {
             "type": "string",
-            "description": "Unique reservation identifier"
+            "description": "Guest's first name"
           },
-          "confirmationNumber": {
+          "lastName": {
             "type": "string",
-            "description": "Booking confirmation number"
+            "description": "Guest's last name"
           },
-          "totalAmount": {
-            "type": "number",
-            "description": "Total reservation amount"
+          "email": {
+            "type": "string",
+            "format": "email",
+            "description": "Guest's email address"
+          },
+          "phone": {
+            "type": "string",
+            "description": "Guest's phone number"
           }
-        }
+        },
+        "required": ["firstName", "lastName", "email"]
       }
     }
-  ],
-  "definitions": {
-    "Room": {
-      "type": "object",
-      "properties": {
-        "id": {"type": "string"},
-        "type": {"type": "string"},
-        "price": {"type": "number"},
-        "amenities": {"type": "array", "items": {"type": "string"}},
-        "availability": {"type": "boolean"}
-      }
-    },
-    "GuestInfo": {
-      "type": "object",
-      "properties": {
-        "firstName": {"type": "string"},
-        "lastName": {"type": "string"},
-        "email": {"type": "string", "format": "email"},
-        "phone": {"type": "string"}
-      },
-      "required": ["firstName", "lastName", "email"]
-    }
   }
 }
 ```
 
-##### JSON-RPC 2.0 接口文档字段说明
+##### OpenRPC规范字段说明
 
 | 字段名称 | 类型 | 是否必需 | 描述 |
 |---------|------|---------|------|
-| jsonrpc | string | 必需 | JSON-RPC协议版本，固定值为"2.0" |
-| security | object | 必需 | 安全机制定义，包含认证方式和参数配置 |
-| transport | object | 必需 | 传输层配置，包含协议、端点、方法等信息 |
-| info | object | 必需 | API基本信息，包含标题、版本、描述 |
+| openrpc | string | 必需 | OpenRPC规范版本，当前使用"1.3.2" |
+| info | object | 必需 | API基本信息，包含标题、版本、描述等 |
+| servers | array | 可选 | 服务器列表，定义API端点地址 |
 | methods | array | 必需 | 可调用的方法列表 |
-| definitions | object | 可选 | 数据结构定义，用于复用 |
+| components | object | 可选 | 可复用的组件定义，包括schemas和securitySchemes |
+| security | array | 可选 | 安全要求定义 |
+| x-transport | object | 可选 | ANP扩展字段：传输层配置信息 |
+
+##### Info对象字段说明
+
+| 字段名称 | 类型 | 描述 |
+|---------|------|------|
+| title | string | API名称 |
+| version | string | API版本号 |
+| description | string | API功能描述 |
+| x-anp-protocol-type | string | ANP扩展字段：协议类型 |
+| x-anp-protocol-version | string | ANP扩展字段：ANP协议版本 |
 
-##### Transport对象字段说明
+##### X-Transport对象字段说明（ANP扩展）
 
 | 字段名称 | 类型 | 描述 |
 |---------|------|------|
 | protocol | string | 传输协议，如"HTTPS"、"HTTP" |
 | host | string | 服务器主机名 |
-| basePath | string | API基础路径 |
-| endpoint | string | 具体的API端点路径 |
+| path | string | API端点路径 |
 | port | integer | 端口号，HTTPS默认443，HTTP默认80 |
 | method | string | HTTP请求方法，JSON-RPC通常使用"POST" |
 | contentType | string | 内容类型，通常为"application/json" |
-| fullUrl | string | 完整的API访问地址 |
 
 ##### Method对象字段说明
 
 | 字段名称 | 类型 | 描述 |
 |---------|------|------|
 | name | string | 方法名称，用于RPC调用 |
-| description | string | 方法功能描述 |
-| params | object | 输入参数的JSON Schema定义 |
-| result | object | 返回结果的JSON Schema定义 |
+| summary | string | 方法简要描述 |
+| description | string | 方法详细功能描述 |
+| params | array | 输入参数列表，每个参数包含name、description、required和schema |
+| result | object | 返回结果定义，包含name、description和schema |
+
+##### Components对象字段说明
+
+| 字段名称 | 类型 | 描述 |
+|---------|------|------|
+| schemas | object | 数据结构定义，用于复用 |
+| securitySchemes | object | 安全认证方案定义 |
 
 #### MCP server接口文档描述