From 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 Mon Sep 17 00:00:00 2001 From: Zhineng Li Date: Sun, 12 Jul 2026 17:11:17 +0800 Subject: update APIs 20260712 --- data/zh_cn/agentexplorer/2026-03-17/api-docs.php | 268 +++++++++++++++++++++++ 1 file changed, 268 insertions(+) create mode 100644 data/zh_cn/agentexplorer/2026-03-17/api-docs.php (limited to 'data/zh_cn/agentexplorer') diff --git a/data/zh_cn/agentexplorer/2026-03-17/api-docs.php b/data/zh_cn/agentexplorer/2026-03-17/api-docs.php new file mode 100644 index 0000000..e13c00c --- /dev/null +++ b/data/zh_cn/agentexplorer/2026-03-17/api-docs.php @@ -0,0 +1,268 @@ + '1.0', + 'info' => ['style' => 'ROA', 'product' => 'AgentExplorer', 'version' => '2026-03-17'], + 'directories' => ['GetSkillContent', 'SearchSkills', 'ListCategories'], + 'components' => [ + 'schemas' => [ + 'Category' => [ + 'description' => '类目详情', + 'type' => 'object', + 'properties' => [ + 'code' => ['title' => '一级类目Code', 'description' => '一级类目Code', 'type' => 'string', 'example' => 'compute'], + 'name' => ['title' => '一级类目名称', 'description' => '一级类目名称', 'type' => 'string', 'example' => '计算'], + 'children' => [ + 'title' => '子类目', + 'description' => '子类目', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'code' => ['title' => '二级类目Code', 'description' => '二级类目Code', 'type' => 'string', 'example' => 'ecs'], + 'name' => ['title' => '二级类目名称', 'description' => '二级类目名称', 'type' => 'string', 'example' => '弹性计算'], + ], + 'description' => '', + ], + ], + ], + ], + 'Skill' => [ + 'description' => 'Agent Skill 详情', + 'type' => 'object', + 'properties' => [ + 'skillName' => ['title' => 'Agent Skill 英文名，唯一标识符', 'description' => 'Agent Skill 英文名，唯一标识符', 'type' => 'string', 'example' => 'deploy-to-vercel'], + 'displayName' => ['title' => 'Agent Skill 展示名称', 'description' => 'Agent Skill 展示名称', 'type' => 'string', 'example' => 'ECS 实例管理'], + 'description' => ['title' => 'Agent Skill 描述', 'description' => 'Agent Skill 描述', 'type' => 'string', 'example' => 'ECS 实例管理'], + 'categoryCode' => ['title' => '一级类目Code', 'description' => '一级类目Code', 'type' => 'string', 'example' => 'compute'], + 'categoryName' => ['title' => '一级类目名称', 'description' => '一级类目名称', 'type' => 'string', 'example' => '计算'], + 'subCategoryCode' => ['title' => '二级类目Code', 'description' => '二级类目Code', 'type' => 'string', 'example' => 'ecs'], + 'subCategoryName' => ['title' => '二级类目名称', 'description' => '二级类目名称', 'type' => 'string', 'example' => '弹性计算'], + 'likeCount' => ['title' => '点赞数', 'description' => '点赞数', 'type' => 'integer', 'format' => 'int32', 'example' => '128'], + 'installCount' => ['title' => '安装数', 'description' => '安装数', 'type' => 'integer', 'format' => 'int32', 'example' => '1024'], + 'createdAt' => ['title' => '创建时间', 'description' => '创建时间', 'type' => 'string', 'example' => '2026-01-01T00:00:00Z'], + 'updatedAt' => ['title' => '更新时间', 'description' => '更新时间', 'type' => 'string', 'example' => '2026-03-17T00:00:00Z'], + 'descriptionEn' => ['type' => 'string'], + 'nameEn' => ['type' => 'string'], + 'categoryNameEn' => ['type' => 'string'], + 'subCategoryNameEn' => ['type' => 'string'], + 'githubPath' => ['type' => 'string'], + ], + ], + ], + ], + 'apis' => [ + 'GetSkillContent' => [ + 'summary' => '获取指定 Agent Skill 的 SKILL.md 文件内容', + 'path' => '/openapi/skills/{skillName}', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREopenapiexplorerIZJ64T'], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'skillName', + 'in' => 'path', + 'schema' => ['title' => 'skill name', 'description' => 'skill name', 'type' => 'string', 'required' => true, 'example' => 'ecs-manager'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '1764D64D-5262-55DA-BDBF-1F949B1B34F7'], + 'content' => ['title' => 'SKILL.md 文件内容', 'description' => 'SKILL.md 文件内容', 'type' => 'string', 'example' => '---'."\n" + .'name: alibabacloud-find-skills'."\n" + .'description: "Search for official Alibaba Cloud Agent Skills based on user requirements"'."\n" + .'---'."\n" + ."\n" + .'Agent Skill Body Content Here'], + ], + ], + ], + ], + 'errorCodes' => [ + 404 => [ + ['errorCode' => 'NotFound.Skill', 'errorMessage' => 'Specified skill not found.', 'description' => '指定的Skill不存在。'], + ], + 500 => [ + ['errorCode' => 'InternalServerError', 'errorMessage' => 'The request has failed due to a temporary failure of the server.', 'description' => '由于服务器暂时故障，请求失败。'], + ['errorCode' => 'OperationFailed', 'errorMessage' => 'Get skill content failed.', 'description' => '获取Skill内容失败。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"1764D64D-5262-55DA-BDBF-1F949B1B34F7\\",\\n \\"content\\": \\"---\\\\nname: alibabacloud-find-skills\\\\ndescription: \\\\\\"Search for official Alibaba Cloud Agent Skills based on user requirements\\\\\\"\\\\n---\\\\n\\\\nAgent Skill Body Content Here\\"\\n}","type":"json"}]', + 'title' => '获取 Agent Skill 文件内容', + 'changeSet' => [], + ], + 'ListCategories' => [ + 'summary' => '列举所有的阿里云 Skills 类目。', + 'path' => '/openapi/categories', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREopenapiexplorerIZJ64T'], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => '请求ID', 'type' => 'string', 'example' => '099A671E-FA21-5A36-8A73-918572DDEF53'], + 'message' => ['description' => '响应消息', 'type' => 'string', 'example' => 'success'], + 'data' => [ + 'description' => '返回的类目列表', + 'type' => 'array', + 'items' => ['description' => '返回的类目详情', '$ref' => '#/components/schemas/Category'], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 500 => [ + ['errorCode' => 'InternalServerError', 'errorMessage' => 'The request has failed due to a temporary failure of the server.', 'description' => '由于服务器暂时故障，请求失败。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"099A671E-FA21-5A36-8A73-918572DDEF53\\",\\n \\"message\\": \\"success\\",\\n \\"data\\": [\\n {\\n \\"code\\": \\"compute\\",\\n \\"name\\": \\"计算\\",\\n \\"children\\": [\\n {\\n \\"code\\": \\"ecs\\",\\n \\"name\\": \\"弹性计算\\"\\n }\\n ]\\n }\\n ]\\n}","type":"json"}]', + 'title' => '获取所有 Agent Skills 类目信息', + 'changeSet' => [], + ], + 'SearchSkills' => [ + 'summary' => '通过关键词、类目搜索阿里云 Agent Skills。', + 'path' => '/openapi/skills', + 'methods' => ['get'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREopenapiexplorerIZJ64T'], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'keyword', + 'in' => 'query', + 'schema' => ['title' => '搜索关键词', 'description' => '搜索关键词', 'type' => 'string', 'required' => false, 'example' => 'ecs'], + ], + [ + 'name' => 'categoryCode', + 'in' => 'query', + 'schema' => ['title' => 'Skill 类目Code，如果传入多个，使用英文逗号隔开。如果是二级类目，使用 一级类目.二级类目的方式传入', 'description' => 'Skill 类目Code，如果传入多个，使用英文逗号隔开。如果是二级类目，使用 一级类目.二级类目的方式传入', 'type' => 'string', 'required' => false, 'example' => 'compute.serverless,network'], + ], + [ + 'name' => 'nextToken', + 'in' => 'query', + 'schema' => ['title' => '下一个查询开始 Token，取值为上一次 API 调用返回的 NextToken 参数值', 'description' => '下一个查询开始 Token，取值为上一次 API 调用返回的 NextToken 参数值', 'type' => 'string', 'required' => false, 'example' => 'AAAAAZjtYxxxxxxxx'], + ], + [ + 'name' => 'maxResults', + 'in' => 'query', + 'schema' => ['title' => '分页查询时每页的最大条目数。最大值为 100。默认值为 20。', 'description' => '分页查询时每页的最大条目数。最大值为 100。默认值为 20。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '20'], + ], + [ + 'name' => 'skip', + 'in' => 'query', + 'schema' => ['title' => '分页参数，跳过数目', 'description' => '分页参数，跳过数目', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + [ + 'name' => 'searchMode', + 'in' => 'query', + 'schema' => ['title' => '开启向量搜索的方式需指定semantic', 'type' => 'string'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'requestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => '53EAEBC0-4DEC-5AF4-AA21-3923D5A819C3'], + 'nextToken' => ['title' => '返回的 NextToken，用来返回更多结果。', 'description' => '返回的 NextToken，用来返回更多结果。', 'type' => 'string', 'example' => 'AAAAAZjtYxxxxxxxx'], + 'maxResults' => ['title' => '分页查询时每页的最大条目数。最大值为 100。默认值为 20。', 'description' => '分页查询时每页的最大条目数。最大值为 100。默认值为 20。', 'type' => 'integer', 'format' => 'int32', 'example' => '20'], + 'totalCount' => ['title' => '数据总记录数。', 'description' => '数据总记录数。', 'type' => 'integer', 'format' => 'int32', 'example' => '22'], + 'data' => [ + 'description' => '返回的 Skill 列表', + 'type' => 'array', + 'items' => ['description' => '返回的Skill详情', '$ref' => '#/components/schemas/Skill'], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParam.NextToken', 'errorMessage' => 'The specified NextToken is not valid.', 'description' => '指定的nextToken无效。'], + ['errorCode' => 'NextTokenParameterMismatch', 'errorMessage' => 'The request uses the same nextToken as the previous request, but with different parameters. NextTokens should not be reused across non-identical requests. Each unique request must have a distinct nextToken.', 'description' => '请求使用了与之前请求相同的nextToken，但参数不同。请勿在参数不同的请求中重复使用同一nextToken，每个独立请求必须使用唯一的nextToken。 '], + ], + 500 => [ + ['errorCode' => 'InternalServerError', 'errorMessage' => 'The request has failed due to a temporary failure of the server.', 'description' => '由于服务器暂时故障，请求失败。'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '搜索阿里云 Agent Skills', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"requestId\\": \\"53EAEBC0-4DEC-5AF4-AA21-3923D5A819C3\\",\\n \\"nextToken\\": \\"AAAAAZjtYxxxxxxxx\\",\\n \\"maxResults\\": 20,\\n \\"totalCount\\": 22,\\n \\"data\\": [\\n {\\n \\"skillName\\": \\"deploy-to-vercel\\",\\n \\"displayName\\": \\"ECS 实例管理\\",\\n \\"description\\": \\"ECS 实例管理\\",\\n \\"categoryCode\\": \\"compute\\",\\n \\"categoryName\\": \\"计算\\",\\n \\"subCategoryCode\\": \\"ecs\\",\\n \\"subCategoryName\\": \\"弹性计算\\",\\n \\"likeCount\\": 128,\\n \\"installCount\\": 1024,\\n \\"createdAt\\": \\"2026-01-01T00:00:00Z\\",\\n \\"updatedAt\\": \\"2026-03-17T00:00:00Z\\",\\n \\"descriptionEn\\": \\"\\",\\n \\"nameEn\\": \\"\\",\\n \\"categoryNameEn\\": \\"\\",\\n \\"subCategoryNameEn\\": \\"\\",\\n \\"githubPath\\": \\"\\"\\n }\\n ]\\n}","type":"json"}]', + ], + ], + 'endpoints' => [ + ['regionId' => 'public', 'regionName' => '公网', 'areaId' => 'other', 'areaName' => '其它', 'public' => 'agentexplorer.aliyuncs.com', 'endpoint' => 'agentexplorer.aliyuncs.com', 'vpc' => ''], + ], + 'errorCodes' => [ + ['code' => 'InternalServerError', 'message' => 'The request has failed due to a temporary failure of the server.', 'http_code' => 500, 'description' => '由于服务器暂时故障，请求失败。'], + ['code' => 'InvalidParam.NextToken', 'message' => 'The specified NextToken is not valid.', 'http_code' => 400, 'description' => '指定的nextToken无效。'], + ['code' => 'NextTokenParameterMismatch', 'message' => 'The request uses the same nextToken as the previous request, but with different parameters. NextTokens should not be reused across non-identical requests. Each unique request must have a distinct nextToken.', 'http_code' => 400, 'description' => '请求使用了与之前请求相同的nextToken，但参数不同。请勿在参数不同的请求中重复使用同一nextToken，每个独立请求必须使用唯一的nextToken。 '], + ['code' => 'NotFound.Skill', 'message' => 'Specified skill not found.', 'http_code' => 404, 'description' => '指定的Skill不存在。'], + ['code' => 'OperationFailed', 'message' => 'Get skill content failed.', 'http_code' => 500, 'description' => '获取Skill内容失败。'], + ], + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], +]; -- cgit v1.2.3