diff options
| author | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
|---|---|---|
| committer | Zhineng Li <im@zhineng.li> | 2026-07-12 17:11:17 +0800 |
| commit | 1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634 (patch) | |
| tree | 5f0857666365b7e40cdaa3733ebe1f3ba9e13c67 /data/zh_cn/airegistry/2026-03-17/api-docs.php | |
| parent | 7347bac4ab7e136157fc94777e6cf87ef9e08599 (diff) | |
| download | afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.tar.gz afterglow-metadata-full-1c7f908ce09f98fdcbf79ed2a8ae21be60eaa634.zip | |
update APIs 20260712
Diffstat (limited to 'data/zh_cn/airegistry/2026-03-17/api-docs.php')
| -rw-r--r-- | data/zh_cn/airegistry/2026-03-17/api-docs.php | 2568 |
1 files changed, 2568 insertions, 0 deletions
diff --git a/data/zh_cn/airegistry/2026-03-17/api-docs.php b/data/zh_cn/airegistry/2026-03-17/api-docs.php new file mode 100644 index 0000000..5619f53 --- /dev/null +++ b/data/zh_cn/airegistry/2026-03-17/api-docs.php @@ -0,0 +1,2568 @@ +<?php return [ + 'version' => '1.0', + 'info' => ['style' => 'RPC', 'product' => 'AIRegistry', 'version' => '2026-03-17'], + 'directories' => [ + 'CreateNamespace', 'CreatePrompt', 'CreatePromptVersion', 'CreateSkillDraft', 'DeleteNamespace', 'DeletePrompt', 'DeleteSkill', 'DownloadSkillVersionViaOss', 'ForcePublishSkillVersion', 'GetNamespace', 'GetPrompt', 'GetPromptVersion', 'GetSkillDetail', 'GetSkillImportFileUrl', 'GetSkillVersionDetail', 'ListNamespaces', 'ListPromptVersions', 'ListPrompts', 'ListSkills', 'OfflineSkill', + 'OnlineSkill', 'PublishSkillVersion', 'SubmitPromptVersion', 'SubmitSkillVersion', 'UpdateNamespace', 'UpdatePrompt', 'UpdatePromptVersion', 'UpdateSkillBizTags', 'UpdateSkillDraft', 'UpdateSkillLabels', 'UpdateSkillScope', 'UploadSkillViaOss', + ], + 'components' => [ + 'schemas' => [], + ], + 'apis' => [ + 'CreateNamespace' => [ + 'summary' => '创建 AI Registry 的命名空间，返回对应的命名空间 ID', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'Name', + 'in' => 'query', + 'schema' => ['title' => '工作空间名称', 'description' => '工作空间名称', 'type' => 'string', 'required' => false, 'example' => '我的Prompt空间'], + ], + [ + 'name' => 'Description', + 'in' => 'query', + 'schema' => ['title' => '工作空间描述', 'description' => '工作空间描述', 'type' => 'string', 'required' => false, 'example' => '用于管理客服场景的Prompt'], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'schema' => ['title' => '标签，多个用逗号分隔', 'description' => '标签，多个用逗号分隔', 'type' => 'string', 'required' => false, 'example' => 'customer-service,production'], + ], + [ + 'name' => 'ScanPolicy', + 'in' => 'query', + 'schema' => ['title' => '扫描策略。', 'description' => '扫描策略。'."\n" + ."\n" + .'包含两个配置项：'."\n" + .'- minBlockRiskLevel:风险等级拦截'."\n" + .' - high: 拦截高风险'."\n" + .' - medium: 拦截中 / 高风险'."\n" + .' - low: 拦截高 / 中 / 低所有风险'."\n" + .'- maxSkipRatio:最大跳过比例，若扫描跳过比例大于该值，视为不通过。', 'type' => 'string', 'required' => false, 'example' => '{"minBlockRiskLevel":"medium","maxSkipRatio":0.2}'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<CreateNamespaceResult>', + 'description' => 'RestResult<CreateNamespaceResult>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '命名空间创建结果', + 'type' => 'object', + 'properties' => [ + 'NamespaceId' => ['description' => '命名空间ID。默认命名空间不可查询、更改或删除。', 'type' => 'string', 'example' => 'a2a9310a-9d91-4283-b4e2-844f6d45fe64'], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'NamespaceQuotaLimited', 'errorMessage' => 'User has reached the maximum namespace limit .', 'description' => '单个用户创建的命名空间数量达到上限'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建 AI Registry 命名空间', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"NamespaceId\\": \\"a2a9310a-9d91-4283-b4e2-844f6d45fe64\\"\\n }\\n}","type":"json"}]', + ], + 'CreatePrompt' => [ + 'summary' => '创建提示词，并创建该提示词的初始的草稿版本内容', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => '提示词 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + [ + 'name' => 'Template', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 模板内容', 'description' => '提示词初始草稿版本的模板内容', 'type' => 'string', 'required' => true, 'example' => '你是一个客服助手，请回答：{question}'], + ], + [ + 'name' => 'TargetVersion', + 'in' => 'query', + 'schema' => ['title' => '指定草稿版本号，不填则默认 0.0.1', 'description' => '提示词初始草稿版本的版本号，不填则默认 0.0.1', 'type' => 'string', 'required' => false, 'example' => '0.0.1'], + ], + [ + 'name' => 'Variables', + 'in' => 'query', + 'schema' => ['title' => '变量定义，JSON 数组字符串', 'description' => '变量定义，JSON 数组字符串，支持名称 name, 描述 description, 默认值 defaultValue 参数', 'type' => 'string', 'required' => false, 'example' => '[{"name":"question","defaultValue":"Hello"}]'], + ], + [ + 'name' => 'CommitMsg', + 'in' => 'query', + 'schema' => ['title' => '提交说明', 'description' => '提交说明', 'type' => 'string', 'required' => false, 'example' => '初始版本'], + ], + [ + 'name' => 'Description', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 描述', 'description' => '提示词描述', 'type' => 'string', 'required' => false, 'example' => '客服问答 Prompt'], + ], + [ + 'name' => 'BizTags', + 'in' => 'query', + 'schema' => ['title' => '业务标签，逗号分隔', 'description' => '业务标签，逗号分隔', 'type' => 'string', 'required' => false, 'example' => 'cs,qa,support'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<String>', + 'description' => 'RestResult<String>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '创建的提示词的草稿版本的版本号', 'type' => 'string', 'example' => '0.0.1'], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + 409 => [ + ['errorCode' => 'PromptAlreadyExist', 'errorMessage' => 'The specified prompt already exists.', 'description' => '创建的提示词已经存在'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建提示词', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": \\"0.0.1\\"\\n}","type":"json"}]', + ], + 'CreatePromptVersion' => [ + 'summary' => '新建提示词的版本，新版本默认为草稿状态。如果草稿版本已经存在，则会报错', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => 'Prompt 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + [ + 'name' => 'Template', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 模板内容，与 basedOnVersion 二选一', 'description' => 'Prompt 模板内容，与 basedOnVersion 二选一', 'type' => 'string', 'required' => false, 'example' => '你是一个客服助手，请回答：{question}'], + ], + [ + 'name' => 'BasedOnVersion', + 'in' => 'query', + 'schema' => ['title' => '基于此版本 fork，与 template 二选一', 'description' => '基于此版本 fork，与 template 二选一', 'type' => 'string', 'required' => false, 'example' => '0.0.1'], + ], + [ + 'name' => 'TargetVersion', + 'in' => 'query', + 'schema' => ['title' => '指定草稿版本号，不填则自动递增', 'description' => '指定草稿版本号，不填则自动递增', 'type' => 'string', 'required' => false, 'example' => '0.0.2'], + ], + [ + 'name' => 'Variables', + 'in' => 'query', + 'schema' => ['title' => '变量定义，JSON 数组字符串', 'description' => '变量定义，JSON 数组字符串', 'type' => 'string', 'required' => false, 'example' => '[{"name":"question","defaultValue":"Hello"}]'], + ], + [ + 'name' => 'CommitMsg', + 'in' => 'query', + 'schema' => ['title' => '提交说明', 'description' => '提交说明', 'type' => 'string', 'required' => false, 'example' => '初始版本'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<String>', + 'description' => 'RestResult<String>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '创建的草稿版本的版本号', 'type' => 'string', 'example' => '0.0.1'], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + 409 => [ + ['errorCode' => 'PromptVersionAlreadyExist', 'errorMessage' => 'The specified prompt version already exist.', 'description' => '提示词版本已存在'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '新建提示词的版本', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": \\"0.0.1\\"\\n}","type":"json"}]', + ], + 'CreateSkillDraft' => [ + 'summary' => '创建 Skill 草稿，返回 Skill 版本', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'SkillCard', + 'in' => 'query', + 'schema' => ['title' => 'Skill 卡片 JSON 字符串，包含完整 Skill 信息', 'description' => 'Skill 卡片 JSON 字符串，包含完整 Skill 信息', 'type' => 'string', 'required' => false, 'example' => '{"name":"customer-service-skill","description":"customer-skill-desc","skillMd":"---\\nname: customer-service-skill\\ndescription: customer-skill-desc\\n---\\ncustomer-skill-content"}'], + ], + [ + 'name' => 'BasedOnVersion', + 'in' => 'query', + 'schema' => ['title' => '基于此版本 fork，不填则创建新 Skill', 'description' => '基于此版本 fork，不填则基于最新版本创建新 Skill', 'type' => 'string', 'required' => false, 'example' => '0.0.1'], + ], + [ + 'name' => 'TargetVersion', + 'in' => 'query', + 'schema' => ['title' => '指定草稿版本号，不填则自动递增', 'description' => '指定草稿版本号，不填则自动递增', 'type' => 'string', 'required' => false, 'example' => '0.0.2'], + ], + [ + 'name' => 'CommitMsg', + 'in' => 'query', + 'schema' => ['title' => '提交说明', 'description' => '提交说明', 'type' => 'string', 'required' => false, 'example' => '初始版本'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<String>', + 'description' => 'RestResult<String>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => 'Skill 版本。', 'type' => 'string', 'example' => '3aa3fb14dddd4bdb941cf4536e4e918b'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建Skill草稿', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": \\"3aa3fb14dddd4bdb941cf4536e4e918b\\"\\n}","type":"json"}]', + ], + 'DeleteNamespace' => [ + 'summary' => '删除 AI 治理中心的指定命名空间，删除时会检查命名空间下有无使用中的资源存在（Skill/Prompt 等），如果存在则删除失败', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Boolean>', + 'description' => 'RestResult<Boolean>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '命名空间删除结果', 'type' => 'boolean', 'example' => 'True'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'NamespaceInUse', 'errorMessage' => 'The namespace is in use and cannot be deleted.', 'description' => '命名空间下使用中，还有未删除的资源'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除 AI 治理中心的指定命名空间', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": true\\n}","type":"json"}]', + ], + 'DeletePrompt' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => 'Prompt 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Boolean>', + 'description' => 'RestResult<Boolean>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '是否成功', 'type' => 'boolean', 'example' => 'true'], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除提示词', + 'summary' => '删除指定的提示词', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": true\\n}","type":"json"}]', + ], + 'DeleteSkill' => [ + 'summary' => '删除指定 Skill。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'delete', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID。', 'type' => 'string', 'example' => '195BF118-9AEF-5F3F-9A58-D88A77EB07DE'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除Skill', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"195BF118-9AEF-5F3F-9A58-D88A77EB07DE\\"\\n}","type":"json"}]', + ], + 'DownloadSkillVersionViaOss' => [ + 'summary' => '通过 OSS 下载 Skill 版本 - 返回 OSS 下载 URL', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'SkillVersion', + 'in' => 'query', + 'schema' => ['title' => '版本号', 'description' => '版本号', 'type' => 'string', 'required' => true, 'example' => '0.0.1'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<String>', + 'description' => 'RestResult<String>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '通过OSS下载 Skill 的 Url。', 'type' => 'string', 'example' => 'https://sample-bucket.oss-region.aliyuncs.com/xxxxxx'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '通过 OSS 下载 Skill', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": \\"https://sample-bucket.oss-region.aliyuncs.com/xxxxxx\\"\\n}","type":"json"}]', + ], + 'ForcePublishSkillVersion' => [ + 'summary' => '强制发布版本', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'SkillVersion', + 'in' => 'query', + 'schema' => ['title' => '版本号', 'description' => '版本号', 'type' => 'string', 'required' => true, 'example' => '0.0.2'], + ], + [ + 'name' => 'UpdateLatestLabel', + 'in' => 'query', + 'schema' => ['title' => '是否更新 latest 标签', 'description' => '是否更新 latest 标签', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '强制发布 Skill', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\"\\n}","type":"json"}]', + ], + 'GetNamespace' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<NamespaceInfo>', + 'description' => 'RestResult<NamespaceInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '命名空间信息。', + 'type' => 'object', + 'properties' => [ + 'NamespaceId' => ['description' => '命名空间ID。', 'type' => 'string', 'example' => 'a2a9310a-9d91-4283-b4e2-844f6d45fe64'], + 'Name' => ['description' => '命名空间名称。', 'type' => 'string', 'example' => 'magic:magic-cn-1us4sed5d01'], + 'Description' => ['description' => '命名空间的描述信息', 'type' => 'string', 'example' => 'secret for bbtadmin'], + 'Tags' => ['description' => '命名空间的标签', 'type' => 'string', 'example' => '{}'], + 'Source' => ['description' => '命名空间的来源', 'type' => 'string', 'example' => 'magic:magic-cn-1us4sed5d01'], + 'SourceIndex' => ['description' => '命名空间来源序号', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'PromptCount' => ['description' => '命名空间下的提示词数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'CreatedTime' => ['description' => '命名空间创建时间', 'type' => 'string', 'example' => '2025-11-17T09:57:38+08:00'], + 'SkillCount' => ['description' => '命名空间下的技能数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'ScanPolicy' => ['description' => '扫描策略。'."\n" + ."\n" + .'包含两个配置项：'."\n" + .'- minBlockRiskLevel:风险等级拦截'."\n" + .' - high: 拦截高风险'."\n" + .' - medium: 拦截中 / 高风险'."\n" + .' - low: 拦截高 / 中 / 低所有风险'."\n" + .'- maxSkipRatio:最大跳过比例，若扫描跳过比例大于该值，视为不通过。', 'type' => 'string', 'example' => '{"minBlockRiskLevel":"medium","maxSkipRatio":0.2}'], + 'PublicAccessEnabled' => ['type' => 'boolean'], + 'PublicDomain' => ['type' => 'string'], + 'IpWhitelist' => ['type' => 'string'], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'NamespaceNotFound', 'errorMessage' => 'The specified namespace does not exist.', 'description' => '指定的命名空间不存在'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询 AI 治理中心命名空间详情', + 'summary' => '查询 AI 治理中心命名空间详细信息', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"NamespaceId\\": \\"a2a9310a-9d91-4283-b4e2-844f6d45fe64\\",\\n \\"Name\\": \\"magic:magic-cn-1us4sed5d01\\",\\n \\"Description\\": \\"secret for bbtadmin\\",\\n \\"Tags\\": \\"{}\\",\\n \\"Source\\": \\"magic:magic-cn-1us4sed5d01\\",\\n \\"SourceIndex\\": 0,\\n \\"PromptCount\\": 1,\\n \\"CreatedTime\\": \\"2025-11-17T09:57:38+08:00\\",\\n \\"SkillCount\\": 1,\\n \\"ScanPolicy\\": \\"{\\\\\\"minBlockRiskLevel\\\\\\":\\\\\\"medium\\\\\\",\\\\\\"maxSkipRatio\\\\\\":0.2}\\",\\n \\"PublicAccessEnabled\\": true,\\n \\"PublicDomain\\": \\"\\",\\n \\"IpWhitelist\\": \\"\\"\\n }\\n}","type":"json"}]', + ], + 'GetPrompt' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => 'Prompt 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<PromptGovernanceInfo>', + 'description' => 'RestResult<PromptGovernanceInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '返回结果', + 'type' => 'object', + 'properties' => [ + 'SchemaVersion' => ['description' => '模式版本', 'type' => 'integer', 'format' => 'int32', 'example' => '1.0'], + 'PromptKey' => ['description' => '提示词 唯一标识', 'type' => 'string', 'example' => 'customer-service-qa'], + 'Description' => ['description' => '提示词描述', 'type' => 'string', 'example' => 'Prompt for test'], + 'BizTags' => [ + 'description' => '业务标签列表', + 'type' => 'array', + 'items' => ['description' => '业务标签', 'type' => 'string', 'example' => 'image-generation'], + ], + 'LatestVersion' => ['description' => '该提示词最新版本的版本号', 'type' => 'string', 'example' => '0.0.1'], + 'GmtModified' => ['description' => '提示词修改时间', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-11-13T02:11:53Z'], + 'EditingVersion' => ['description' => '草稿版本的版本号，如果不存在草稿版本，则为空', 'type' => 'string', 'example' => '0.0.1'], + 'ReviewingVersion' => ['description' => '提示词审核中的版本的版本号', 'type' => 'string', 'example' => '0.0.1'], + 'OnlineCnt' => ['description' => '提示词在线的版本数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Labels' => [ + 'description' => '提示词标签和版本的映射关系', + 'type' => 'object', + 'additionalProperties' => ['type' => 'string', 'example' => '{"prod":"0.0.1"}', 'description' => '提示词标签和版本的键值对'], + ], + 'Versions' => [ + 'description' => '版本号列表', + 'type' => 'array', + 'items' => ['description' => '版本号', 'type' => 'string', 'example' => '0.0.1'], + ], + 'VersionDetails' => [ + 'description' => '版本详细信息的列表', + 'type' => 'array', + 'items' => [ + 'description' => '版本详细信息', + 'type' => 'object', + 'properties' => [ + 'PromptKey' => ['description' => '提示词 唯一标识', 'type' => 'string', 'example' => 'customer-service-qa'], + 'Version' => ['description' => '版本号', 'type' => 'string', 'example' => '0.0.1'], + 'Status' => ['description' => '版本状态。草稿 draft / 正式 online', 'type' => 'string', 'example' => 'online'], + 'CommitMsg' => ['description' => '该版本的提交信息', 'type' => 'string', 'example' => 'This is a test Version'], + 'SrcUser' => ['description' => '该版本的创建者', 'type' => 'string', 'example' => 'admin'], + 'GmtModified' => ['description' => '修改时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '1627545952000'], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'PromptNotFound', 'errorMessage' => 'The specified prompt does not exist.', 'description' => '当前操作的 Prompt 不存在'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询 Prompt 详情信息', + 'summary' => '获取 Prompt 详情信息', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"SchemaVersion\\": 1,\\n \\"PromptKey\\": \\"customer-service-qa\\",\\n \\"Description\\": \\"Prompt for test\\",\\n \\"BizTags\\": [\\n \\"image-generation\\"\\n ],\\n \\"LatestVersion\\": \\"0.0.1\\",\\n \\"GmtModified\\": 0,\\n \\"EditingVersion\\": \\"0.0.1\\",\\n \\"ReviewingVersion\\": \\"0.0.1\\",\\n \\"OnlineCnt\\": 1,\\n \\"Labels\\": {\\n \\"key\\": \\"{\\\\\\"prod\\\\\\":\\\\\\"0.0.1\\\\\\"}\\"\\n },\\n \\"Versions\\": [\\n \\"0.0.1\\"\\n ],\\n \\"VersionDetails\\": [\\n {\\n \\"PromptKey\\": \\"customer-service-qa\\",\\n \\"Version\\": \\"0.0.1\\",\\n \\"Status\\": \\"online\\",\\n \\"CommitMsg\\": \\"This is a test Version\\",\\n \\"SrcUser\\": \\"admin\\",\\n \\"GmtModified\\": 1627545952000\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'GetPromptVersion' => [ + 'summary' => '查询提示词指定版本的详细信息。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => 'Prompt 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + [ + 'name' => 'PromptVersion', + 'in' => 'query', + 'schema' => ['title' => '版本号', 'description' => '版本号', 'type' => 'string', 'required' => true, 'example' => '0.0.1'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<PromptVersionDetailInfo>', + 'description' => 'RestResult<PromptVersionDetailInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '查询结果', + 'type' => 'object', + 'properties' => [ + 'PromptKey' => ['description' => '提示词 唯一标识', 'type' => 'string', 'example' => 'customer-service-qa'], + 'Version' => ['description' => '版本号', 'type' => 'string', 'example' => '0.0.1'], + 'Status' => ['description' => '版本状态。草稿 draft / 正式 online', 'type' => 'string', 'example' => 'online'], + 'Template' => ['description' => '提示词版本的模板内容', 'type' => 'string', 'example' => 'You are a {{domain}} expert.'], + 'CommitMsg' => ['description' => '该版本的提交信息', 'type' => 'string', 'example' => 'This is a test version'], + 'SrcUser' => ['description' => '版本的创建者', 'type' => 'string', 'example' => 'admin'], + 'GmtModified' => ['description' => '提示词修改时间', 'type' => 'integer', 'format' => 'int64', 'example' => '1605345828000'], + 'Md5' => ['description' => '该版本提示词内容的md5', 'type' => 'string', 'example' => '93EF3AC0C56DDACB5A9E528BB1C825C8'], + 'Variables' => [ + 'description' => '该版本的变量列表', + 'type' => 'array', + 'items' => [ + 'description' => '提示词变量', + 'type' => 'object', + 'properties' => [ + 'Name' => ['description' => '变量名称', 'type' => 'string', 'example' => 'domain'], + 'DefaultValue' => ['description' => '默认值', 'type' => 'string', 'example' => 'code'], + 'Description' => ['description' => '变量描述', 'type' => 'string', 'example' => 'domain'], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'PromptVersionNotFound', 'errorMessage' => 'The specificed prompt version is illegal or not found.', 'description' => '指定的提示词版本不存在或者非法'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询提示词版本详细信息', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"PromptKey\\": \\"customer-service-qa\\",\\n \\"Version\\": \\"0.0.1\\",\\n \\"Status\\": \\"online\\",\\n \\"Template\\": \\"You are a {{domain}} expert.\\",\\n \\"CommitMsg\\": \\"This is a test version\\",\\n \\"SrcUser\\": \\"admin\\",\\n \\"GmtModified\\": 1605345828000,\\n \\"Md5\\": \\"93EF3AC0C56DDACB5A9E528BB1C825C8\\",\\n \\"Variables\\": [\\n {\\n \\"Name\\": \\"domain\\",\\n \\"DefaultValue\\": \\"code\\",\\n \\"Description\\": \\"domain\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'GetSkillDetail' => [ + 'summary' => '获取 Skill 的元数据和版本信息。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<SkillGovernanceInfo>', + 'description' => 'RestResult<SkillGovernanceInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => 'C5272879-3C44-5E5A-8056-CB4E8EB36DCD'], + 'Data' => [ + 'description' => '录像计划详细信息。', + 'type' => 'object', + 'properties' => [ + 'Versions' => [ + 'title' => '所有版本摘要列表', + 'description' => '所有版本摘要列表', + 'type' => 'array', + 'items' => [ + 'description' => '数据结构。', + 'type' => 'object', + 'properties' => [ + 'Version' => ['description' => '版本号。', 'type' => 'string', 'example' => '2017-08-01'], + 'Status' => ['description' => '资源状态', 'type' => 'string', 'example' => 'online'], + 'Author' => ['description' => '作者', 'type' => 'string', 'example' => '22618'], + 'Description' => ['description' => '备注。', 'type' => 'string', 'example' => 'dataphin_300067022_pre'], + 'CreateTime' => ['description' => '文件创建的时间戳，单位为毫秒。', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-12-02T02:12:01Z'], + 'UpdateTime' => ['description' => '更新时间。', 'type' => 'integer', 'format' => 'int64', 'example' => '2021-05-06T06:37Z'], + 'PublishPipelineInfo' => ['description' => 'Skill 审核信息。', 'type' => 'string', 'example' => '{'."\n" + .' "executionId": "54408ebe-3c19-4e2e-82a3-f400cedfcd24",'."\n" + .' "status": "APPROVED",'."\n" + .' "pipeline": ['."\n" + .' {'."\n" + .' "nodeId": "fence",'."\n" + .' "executedAt": "2026-05-21T07:42:24.684194457Z",'."\n" + .' "passed": true,'."\n" + .' "messageType": "json",'."\n" + .' "message": {'."\n" + .' "resultCode": "PASS_PARTIAL_SKIP",'."\n" + .' "reports": ['."\n" + .' {'."\n" + .' "file": "SKILL.md",'."\n" + .' "taskId": "E25BDA44-6E10-51AF-B6AB-417EBB4CEF40",'."\n" + .' "riskLevel": "none"'."\n" + .' },'."\n" + .' {'."\n" + .' "file": "pdf-3/presentation.pptx",'."\n" + .' "taskId": "BEEC2D66-B9AE-5C4F-828D-BFAB6E561891",'."\n" + .' "riskLevel": "skip",'."\n" + .' "errorCode": "500",'."\n" + .' "errorMessage": "Scan failed. Please contact us through the online service."'."\n" + .' }'."\n" + .' ]'."\n" + .' },'."\n" + .' "checkpoints": ['."\n" + .' {'."\n" + .' "title": "promptAttack",'."\n" + .' "passed": true'."\n" + .' },'."\n" + .' {'."\n" + .' "title": "contentModeration",'."\n" + .' "passed": true'."\n" + .' }'."\n" + .' ],'."\n" + .' "durationMs": 18933'."\n" + .' }'."\n" + .' ]'."\n" + .'}'], + 'DownloadCount' => ['description' => '下载次数', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'CommitMsg' => ['description' => '版本提交信息。', 'type' => 'string', 'example' => '版本1说明。'], + ], + ], + ], + 'Writeable' => ['description' => '是否可以编辑。', 'type' => 'boolean', 'example' => 'true'], + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间', 'type' => 'integer', 'format' => 'int64', 'example' => '2021-05-06T06:37Z'], + 'Enable' => ['title' => '是否启用', 'description' => '是否启用', 'type' => 'boolean', 'example' => 'false'], + 'BizTags' => ['title' => '业务标签 JSON 数组字符串', 'description' => '业务标签 JSON 数组字符串', 'type' => 'string', 'example' => 'test'], + 'From' => ['title' => '来源标记', 'description' => '来源标记', 'type' => 'string', 'example' => 'aqs'], + 'Scope' => ['title' => '可见性范围', 'description' => '可见性范围', 'type' => 'string', 'example' => 'PUBLIC'], + 'Labels' => [ + 'title' => '标签映射', + 'description' => '版本标签映射', + 'type' => 'object', + 'additionalProperties' => ['type' => 'string', 'example' => '0.0.1', 'description' => 'Skill 版本'], + ], + 'EditingVersion' => ['title' => '正在编辑的版本', 'description' => '正在编辑的版本', 'type' => 'string', 'example' => '0.0.3'], + 'ReviewingVersion' => ['title' => '审核中的版本', 'description' => '审核中的版本', 'type' => 'string', 'example' => '0.0.2'], + 'OnlineCnt' => ['title' => '在线版本数量', 'description' => '在线版本数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'DownloadCount' => ['title' => '总下载次数', 'description' => '总下载次数', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'NamespaceId' => ['description' => '命名空间ID。', 'type' => 'string', 'example' => 'cn-beijing:beta'], + 'Name' => ['description' => 'Skill 名称。', 'type' => 'string', 'example' => '0521B历史1'], + 'Description' => ['description' => 'Skill 描述。', 'type' => 'string', 'example' => 'kms-rds-rduphoenix-val-mysql kms key'], + 'Owner' => ['description' => '负责人的UID。', 'type' => 'string', 'example' => '199458752209xxxx'], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取 Skill 详情', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"C5272879-3C44-5E5A-8056-CB4E8EB36DCD\\",\\n \\"Data\\": {\\n \\"Versions\\": [\\n {\\n \\"Version\\": \\"2017-08-01\\",\\n \\"Status\\": \\"online\\",\\n \\"Author\\": \\"22618\\",\\n \\"Description\\": \\"dataphin_300067022_pre\\",\\n \\"CreateTime\\": 0,\\n \\"UpdateTime\\": 0,\\n \\"PublishPipelineInfo\\": \\"{\\\\n \\\\\\"executionId\\\\\\": \\\\\\"54408ebe-3c19-4e2e-82a3-f400cedfcd24\\\\\\",\\\\n \\\\\\"status\\\\\\": \\\\\\"APPROVED\\\\\\",\\\\n \\\\\\"pipeline\\\\\\": [\\\\n {\\\\n \\\\\\"nodeId\\\\\\": \\\\\\"fence\\\\\\",\\\\n \\\\\\"executedAt\\\\\\": \\\\\\"2026-05-21T07:42:24.684194457Z\\\\\\",\\\\n \\\\\\"passed\\\\\\": true,\\\\n \\\\\\"messageType\\\\\\": \\\\\\"json\\\\\\",\\\\n \\\\\\"message\\\\\\": {\\\\n \\\\\\"resultCode\\\\\\": \\\\\\"PASS_PARTIAL_SKIP\\\\\\",\\\\n \\\\\\"reports\\\\\\": [\\\\n {\\\\n \\\\\\"file\\\\\\": \\\\\\"SKILL.md\\\\\\",\\\\n \\\\\\"taskId\\\\\\": \\\\\\"E25BDA44-6E10-51AF-B6AB-417EBB4CEF40\\\\\\",\\\\n \\\\\\"riskLevel\\\\\\": \\\\\\"none\\\\\\"\\\\n },\\\\n {\\\\n \\\\\\"file\\\\\\": \\\\\\"pdf-3/presentation.pptx\\\\\\",\\\\n \\\\\\"taskId\\\\\\": \\\\\\"BEEC2D66-B9AE-5C4F-828D-BFAB6E561891\\\\\\",\\\\n \\\\\\"riskLevel\\\\\\": \\\\\\"skip\\\\\\",\\\\n \\\\\\"errorCode\\\\\\": \\\\\\"500\\\\\\",\\\\n \\\\\\"errorMessage\\\\\\": \\\\\\"Scan failed. Please contact us through the online service.\\\\\\"\\\\n }\\\\n ]\\\\n },\\\\n \\\\\\"checkpoints\\\\\\": [\\\\n {\\\\n \\\\\\"title\\\\\\": \\\\\\"promptAttack\\\\\\",\\\\n \\\\\\"passed\\\\\\": true\\\\n },\\\\n {\\\\n \\\\\\"title\\\\\\": \\\\\\"contentModeration\\\\\\",\\\\n \\\\\\"passed\\\\\\": true\\\\n }\\\\n ],\\\\n \\\\\\"durationMs\\\\\\": 18933\\\\n }\\\\n ]\\\\n}\\",\\n \\"DownloadCount\\": 100,\\n \\"CommitMsg\\": \\"版本1说明。\\"\\n }\\n ],\\n \\"Writeable\\": true,\\n \\"UpdateTime\\": 0,\\n \\"Enable\\": false,\\n \\"BizTags\\": \\"test\\",\\n \\"From\\": \\"aqs\\",\\n \\"Scope\\": \\"PUBLIC\\",\\n \\"Labels\\": {\\n \\"key\\": \\"0.0.1\\"\\n },\\n \\"EditingVersion\\": \\"0.0.3\\",\\n \\"ReviewingVersion\\": \\"0.0.2\\",\\n \\"OnlineCnt\\": 1,\\n \\"DownloadCount\\": 100,\\n \\"NamespaceId\\": \\"cn-beijing:beta\\",\\n \\"Name\\": \\"0521B历史1\\",\\n \\"Description\\": \\"kms-rds-rduphoenix-val-mysql kms key\\",\\n \\"Owner\\": \\"199458752209xxxx\\"\\n }\\n}","type":"json"}]', + ], + 'GetSkillImportFileUrl' => [ + 'summary' => '获取上传 Skill 到 OSS 的 URL，客户端使用返回的 URL 执行 PUT 上传 Skill。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'none', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'ContentType', + 'in' => 'query', + 'schema' => ['title' => '上传文件 Content-Type，默认 application/zip', 'description' => '上传文件 Content-Type，默认 application/zip', 'type' => 'string', 'required' => false, 'example' => 'application/zip'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<AiRegistrySkillImportFileUrlResponse>', + 'description' => 'RestResult<AiRegistrySkillImportFileUrlResponse>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '返回结果', + 'type' => 'object', + 'properties' => [ + 'UploadUrl' => ['description' => '文件上传 URL，客户端使用此 URL 上传文件', 'type' => 'string', 'example' => 'https://mse-shared-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/skill/import/199xxxxxxxx0842/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/2026/06/10/xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/1781082579097.zip?Expires=1781083479&OSSAccessKeyId=STS.NZXGXTD2yoDLd5PfsYxjFrvBJ&Signature=Loyyzzzzzzzz%3D&security-token=CAIStgxxxxxxx'], + 'OssObjectName' => ['description' => '已授权OSS空间的文件名。'."\n" + ."\n" + .'> 在FaceContrastPicture、FaceContrastPictureUrl、CertifyId、OSS四种图片传入方式中，选择其中一种传入即可。', 'type' => 'string', 'example' => '1190239587066411/skill/import/5e993afe-f629-4619-9ac2-51b125300cdd/2026/06/09/35059076-5992-4a71-a706-89230e57f2a2/ui-ux-pro-max.zip'], + 'ContentType' => ['description' => '文件类型。', 'type' => 'string', 'example' => 'application/zip'], + 'MaxSize' => ['description' => '允许上传文件的最大大小（单位MB）。', 'type' => 'string', 'example' => '10'], + ], + ], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取上传 Skill 到 OSS 的链接', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"UploadUrl\\": \\"https://mse-shared-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/skill/import/199xxxxxxxx0842/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/2026/06/10/xxxx-xxxx-xxxx-xxxx-xxxxxxxxxx/1781082579097.zip?Expires=1781083479&OSSAccessKeyId=STS.NZXGXTD2yoDLd5PfsYxjFrvBJ&Signature=Loyyzzzzzzzz%3D&security-token=CAIStgxxxxxxx\\",\\n \\"OssObjectName\\": \\"1190239587066411/skill/import/5e993afe-f629-4619-9ac2-51b125300cdd/2026/06/09/35059076-5992-4a71-a706-89230e57f2a2/ui-ux-pro-max.zip\\",\\n \\"ContentType\\": \\"application/zip\\",\\n \\"MaxSize\\": \\"10\\"\\n }\\n}","type":"json"}]', + ], + 'GetSkillVersionDetail' => [ + 'summary' => '获取指定版本详情', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'get', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'SkillVersion', + 'in' => 'query', + 'schema' => ['title' => '版本号', 'description' => '版本号', 'type' => 'string', 'required' => true, 'example' => '0.0.1'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<SkillVersionDetailInfo>', + 'description' => 'RestResult<SkillVersionDetailInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => '3EF4C9EC-0D5B-5AD6-8585-4D2AAA22B1E3'], + 'Data' => [ + 'description' => '录像计划详细信息。', + 'type' => 'object', + 'properties' => [ + 'SkillMd' => ['title' => 'Skill 卡片内容（SKILL.md）', 'description' => 'Skill 卡片内容（SKILL.md）', 'type' => 'string', 'example' => '---'."\n" + .'name: hello-world'."\n" + .'description: Say hello to users'."\n" + .'---'."\n" + ."\n" + .'Hello World Skill'], + 'Resource' => [ + 'title' => '资源映射（key 为资源名称）', + 'description' => '资源映射（key 为资源名称）', + 'type' => 'object', + 'additionalProperties' => [ + 'type' => 'object', + 'properties' => [ + 'Name' => ['title' => '资源名称（包含文件扩展名）', 'description' => '资源名称（包含文件扩展名）', 'type' => 'string', 'example' => 'sample.md'], + 'Type' => ['title' => '资源类型：template, data, script 等', 'description' => '资源类型：template, data, script 等', 'type' => 'string', 'example' => 'script'], + 'Content' => ['title' => '资源内容', 'description' => '资源内容', 'type' => 'string', 'example' => '这是一个示例文件'], + 'Metadata' => [ + 'title' => '资源元数据', + 'description' => '资源元数据', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'description' => '元数据的 key', 'example' => 'version'], + ], + ], + 'description' => 'Resource Key', + ], + ], + 'NamespaceId' => ['description' => '应用所属的命名空间ID。', 'type' => 'string', 'example' => 'f52aea1c-774e-4cc1-9dd1-d91432484d44'], + 'Name' => ['description' => 'Skill 名称。', 'type' => 'string', 'example' => '业务模式'], + 'Description' => ['description' => '当前版本的 Skill 的描述。', 'type' => 'string', 'example' => 'secret for bbtadmin'], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取 Skill 版本详情', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"3EF4C9EC-0D5B-5AD6-8585-4D2AAA22B1E3\\",\\n \\"Data\\": {\\n \\"SkillMd\\": \\"---\\\\nname: hello-world\\\\ndescription: Say hello to users\\\\n---\\\\n\\\\nHello World Skill\\",\\n \\"Resource\\": {\\n \\"key\\": {\\n \\"Name\\": \\"sample.md\\",\\n \\"Type\\": \\"script\\",\\n \\"Content\\": \\"这是一个示例文件\\",\\n \\"Metadata\\": {\\n \\"key\\": \\"version\\"\\n }\\n }\\n },\\n \\"NamespaceId\\": \\"f52aea1c-774e-4cc1-9dd1-d91432484d44\\",\\n \\"Name\\": \\"业务模式\\",\\n \\"Description\\": \\"secret for bbtadmin\\"\\n }\\n}","type":"json"}]', + ], + 'ListNamespaces' => [ + 'summary' => '列出 AI 治理中心的命名空间列表。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + 'tenantRelevance' => 'publicInformation', + ], + 'parameters' => [ + [ + 'name' => 'Tags', + 'in' => 'query', + 'schema' => ['title' => '按标签过滤，多个用逗号分隔，取交集匹配', 'description' => '按标签过滤，多个用逗号分隔，取交集匹配', 'type' => 'string', 'required' => false, 'example' => 'production,customer-service'], + ], + [ + 'name' => 'Name', + 'in' => 'query', + 'schema' => ['title' => '按名称模糊搜索', 'description' => '按名称模糊搜索', 'type' => 'string', 'required' => false, 'example' => 'test-namespace'], + ], + [ + 'name' => 'PageNo', + 'in' => 'query', + 'schema' => ['title' => '页码，默认 1', 'description' => '页码，默认 1', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['title' => '每页数量，默认 10', 'description' => '每页数量，默认 10', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<PageNamespaceInfo>', + 'description' => 'RestResult<PageNamespaceInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '命名空间创建结果', + 'type' => 'object', + 'properties' => [ + 'TotalCount' => ['description' => '总个数', 'type' => 'integer', 'format' => 'int32', 'example' => '2'], + 'PageNumber' => ['description' => '页码', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageSize' => ['description' => '分页大小，默认为10。', 'type' => 'integer', 'format' => 'int32', 'example' => '50'], + 'Items' => [ + 'description' => '返回数据条目', + 'type' => 'array', + 'items' => [ + 'description' => '-', + 'type' => 'object', + 'properties' => [ + 'NamespaceId' => ['description' => '命名空间ID。', 'type' => 'string', 'example' => '76d4b6e4-31bf-475a-8710-6217ec049c1f'], + 'Name' => ['description' => '命名空间名称。', 'type' => 'string', 'example' => 'magic:magic-cn-1us4sed5d01'], + 'Description' => ['description' => '命名空间的描述信息', 'type' => 'string', 'example' => 'Default project, auto-created by EMR.'], + 'Tags' => ['description' => '命名空间的标签', 'type' => 'string', 'example' => 'qa,test'], + 'Source' => ['description' => '命名空间的来源', 'type' => 'string', 'example' => 'magic:magic-cn-fpi4secsq01'], + 'SourceIndex' => ['description' => '命名空间来源序号', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'PromptCount' => ['description' => '命名空间下的提示词数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'CreatedTime' => ['description' => '命名空间创建时间', 'type' => 'string', 'example' => '2022-07-11T09:32:03+08:00'], + 'SkillCount' => ['description' => '命名空间下的技能数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PublicAccessEnabled' => ['title' => '是否开启公网访问。', 'type' => 'boolean'], + 'PublicDomain' => ['title' => '公网访问域名。', 'type' => 'string'], + 'IpWhitelist' => ['title' => '公网访问 IP 白名单。', 'type' => 'string'], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列出 AI 治理中心的命名空间', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"TotalCount\\": 2,\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 50,\\n \\"Items\\": [\\n {\\n \\"NamespaceId\\": \\"76d4b6e4-31bf-475a-8710-6217ec049c1f\\",\\n \\"Name\\": \\"magic:magic-cn-1us4sed5d01\\",\\n \\"Description\\": \\"Default project, auto-created by EMR.\\",\\n \\"Tags\\": \\"qa,test\\",\\n \\"Source\\": \\"magic:magic-cn-fpi4secsq01\\",\\n \\"SourceIndex\\": 0,\\n \\"PromptCount\\": 1,\\n \\"CreatedTime\\": \\"2022-07-11T09:32:03+08:00\\",\\n \\"SkillCount\\": 1,\\n \\"PublicAccessEnabled\\": true,\\n \\"PublicDomain\\": \\"\\",\\n \\"IpWhitelist\\": \\"\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'ListPromptVersions' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => 'Prompt 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + [ + 'name' => 'PageNo', + 'in' => 'query', + 'schema' => ['title' => '页码，默认 1', 'description' => '页码，默认 1', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['title' => '每页数量，默认 10', 'description' => '每页数量，默认 10', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<PagePromptVersionInfo>', + 'description' => 'RestResult<PagePromptVersionInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '创建的提示词的草稿版本的版本号', + 'type' => 'object', + 'properties' => [ + 'TotalCount' => ['description' => '总数。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageNumber' => ['description' => '分页序号，范围1-100。', 'type' => 'integer', 'format' => 'int32', 'example' => '1'."\n"], + 'PagesAvailable' => ['description' => '可用页数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageItems' => [ + 'description' => '提示词版本列表', + 'type' => 'array', + 'items' => [ + 'description' => '提示词版本信息', + 'type' => 'object', + 'properties' => [ + 'PromptKey' => ['description' => '提示词唯一标识', 'type' => 'string', 'example' => 'customer-service-qa'], + 'Version' => ['description' => '版本号', 'type' => 'string', 'example' => '0.0.1'], + 'Status' => ['description' => '提示词版本状态', 'type' => 'string', 'example' => 'draft'], + 'CommitMsg' => ['description' => '提示词版本提交信息', 'type' => 'string', 'example' => 'This is a test version'], + 'SrcUser' => ['description' => '提示词版本创建者', 'type' => 'string', 'example' => 'admin'], + 'GmtModified' => ['description' => '修改日期'."\n" + ."\n", 'type' => 'integer', 'format' => 'int64', 'example' => '2026-01-04T16:09:29+08:00'], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'PromptNotFound', 'errorMessage' => 'The specified prompt does not exist.', 'description' => '当前操作的 Prompt 不存在'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列出指定提示词的所有版本', + 'summary' => '列出Prompt版本列表', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"TotalCount\\": 1,\\n \\"PageNumber\\": 1,\\n \\"PagesAvailable\\": 1,\\n \\"PageItems\\": [\\n {\\n \\"PromptKey\\": \\"customer-service-qa\\",\\n \\"Version\\": \\"0.0.1\\",\\n \\"Status\\": \\"draft\\",\\n \\"CommitMsg\\": \\"This is a test version\\",\\n \\"SrcUser\\": \\"admin\\",\\n \\"GmtModified\\": 0\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'ListPrompts' => [ + 'summary' => '列出命名空间下的提示词列表。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '命名空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => '过滤关键词', 'description' => '要查找的提示词的标识，可选', 'type' => 'string', 'required' => false, 'example' => 'customer'], + ], + [ + 'name' => 'Search', + 'in' => 'query', + 'schema' => ['title' => '搜索模式：accurate（精确）或 blur（模糊）', 'description' => '搜索模式：accurate（精确）或 blur（模糊）', 'type' => 'string', 'required' => false, 'example' => 'blur'], + ], + [ + 'name' => 'BizTags', + 'in' => 'query', + 'schema' => ['title' => '按业务标签过滤，逗号分隔', 'description' => '按业务标签过滤，逗号分隔', 'type' => 'string', 'required' => false, 'example' => 'cs,qa'], + ], + [ + 'name' => 'PageNo', + 'in' => 'query', + 'schema' => ['title' => '页码，默认 1', 'description' => '页码，默认 1', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['title' => '每页数量，默认 10，最大 50', 'description' => '每页数量，默认 10，最大 50', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<PagePromptInfo>', + 'description' => 'RestResult<PagePromptInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => [ + 'description' => '返回结果', + 'type' => 'object', + 'properties' => [ + 'TotalCount' => ['description' => '提示词总数量', 'type' => 'integer', 'format' => 'int32', 'example' => '5'], + 'PageNumber' => ['description' => '页码', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PagesAvailable' => ['description' => '可用页数', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PageItems' => [ + 'description' => '提示词列表', + 'type' => 'array', + 'items' => [ + 'description' => '提示词信息', + 'type' => 'object', + 'properties' => [ + 'SchemaVersion' => ['description' => '提示词模式版本号', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PromptKey' => ['description' => '提示词唯一标识', 'type' => 'string', 'example' => 'customer'], + 'Description' => ['description' => '描述。', 'type' => 'string', 'example' => 'test prompt'], + 'BizTags' => [ + 'description' => '业务标签列表', + 'type' => 'array', + 'items' => ['description' => '业务标签', 'type' => 'string', 'example' => 'test'], + ], + 'LatestVersion' => ['description' => '该提示词的最新版本号', 'type' => 'string', 'example' => '0.0.1'], + 'GmtModified' => ['description' => '提示词修改时间', 'type' => 'integer', 'format' => 'int64', 'example' => '2026-04-22 11:51:03'], + 'EditingVersion' => ['description' => '提示词草稿版本的版本号，如果不存在草稿版本，则为空', 'type' => 'string', 'example' => '0.0.1'], + 'ReviewingVersion' => ['description' => '提示词正在审核中的版本的版本号，如果不存在审核中的版本，则为空', 'type' => 'string', 'example' => '0.0.1'], + 'OnlineCnt' => ['description' => '提示词在线版本的数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'Labels' => [ + 'description' => '提示词版本和标签的映射关系', + 'type' => 'object', + 'additionalProperties' => ['type' => 'string', 'example' => '{"prod":"0.0.1"}', 'description' => '提示词版本标签的键值对'], + ], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列出命名空间下的提示词列表', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": {\\n \\"TotalCount\\": 5,\\n \\"PageNumber\\": 1,\\n \\"PagesAvailable\\": 1,\\n \\"PageItems\\": [\\n {\\n \\"SchemaVersion\\": 1,\\n \\"PromptKey\\": \\"customer\\",\\n \\"Description\\": \\"test prompt\\",\\n \\"BizTags\\": [\\n \\"test\\"\\n ],\\n \\"LatestVersion\\": \\"0.0.1\\",\\n \\"GmtModified\\": 0,\\n \\"EditingVersion\\": \\"0.0.1\\",\\n \\"ReviewingVersion\\": \\"0.0.1\\",\\n \\"OnlineCnt\\": 1,\\n \\"Labels\\": {\\n \\"key\\": \\"{\\\\\\"prod\\\\\\":\\\\\\"0.0.1\\\\\\"}\\"\\n }\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'ListSkills' => [ + 'summary' => '列出 Skills', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'read', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'list', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => '过滤关键词', 'description' => '过滤关键词', 'type' => 'string', 'required' => false, 'example' => 'customer'], + ], + [ + 'name' => 'Search', + 'in' => 'query', + 'schema' => ['title' => '搜索模式：accurate（精确）或 blur（模糊）', 'description' => '搜索模式：accurate（精确）或 blur（模糊）', 'type' => 'string', 'required' => false, 'example' => 'blur'], + ], + [ + 'name' => 'OrderBy', + 'in' => 'query', + 'schema' => ['title' => '排序字段，支持 download_count，默认为 gmt_modified', 'description' => '排序字段，支持 download_count，默认为 gmt_modified', 'type' => 'string', 'required' => false, 'example' => 'download_count'], + ], + [ + 'name' => 'Owner', + 'in' => 'query', + 'schema' => ['title' => '按所有者过滤', 'description' => '按所有者过滤', 'type' => 'string', 'required' => false, 'example' => 'user123'], + ], + [ + 'name' => 'Scope', + 'in' => 'query', + 'schema' => ['title' => '按可见性过滤：PUBLIC 或 PRIVATE', 'description' => '按可见性过滤：PUBLIC 或 PRIVATE', 'type' => 'string', 'required' => false, 'example' => 'PUBLIC'], + ], + [ + 'name' => 'PageNo', + 'in' => 'query', + 'schema' => ['title' => '页码，默认 1', 'description' => '页码，默认 1', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + ], + [ + 'name' => 'PageSize', + 'in' => 'query', + 'schema' => ['title' => '每页数量，默认 10，最大 50', 'description' => '每页数量，默认 10，最大 50', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '10'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<PageSkillInfo>', + 'description' => 'RestResult<PageSkillInfo>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID', 'type' => 'string', 'example' => '195BF118-9AEF-5F3F-9A58-D88A77EB07DE'], + 'Data' => [ + 'description' => '调用成功时，返回的规则信息列表。详情参见**RuleInfo**信息。'."\n" + ."\n" + .'> 返回规则信息按照规则创建时间倒序排列。', + 'type' => 'object', + 'properties' => [ + 'TotalCount' => ['description' => '任务总数量。', 'type' => 'integer', 'format' => 'int32', 'example' => '0'], + 'PageNumber' => ['description' => '分页序号', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'PagesAvailable' => ['description' => 'pagesAvailable.', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], + 'PageItems' => [ + 'description' => 'mcp server信息', + 'type' => 'array', + 'items' => [ + 'description' => 'mcp server信息', + 'type' => 'object', + 'properties' => [ + 'UpdateTime' => ['title' => '更新时间', 'description' => '更新时间', 'type' => 'integer', 'format' => 'int64', 'example' => '2025-03-05T19:24:43.798'], + 'Enable' => ['title' => '是否启用', 'description' => '是否启用', 'type' => 'boolean', 'example' => 'false'], + 'BizTags' => ['title' => '业务标签 JSON 数组字符串', 'description' => '业务标签 JSON 数组字符串', 'type' => 'string', 'example' => 'test'], + 'From' => ['title' => '来源标记', 'description' => '来源标记', 'type' => 'string', 'example' => 'aqs'], + 'Scope' => ['title' => '可见性范围', 'description' => '可见性范围', 'type' => 'string', 'example' => 'rd-yORclL'], + 'Labels' => [ + 'title' => '标签映射', + 'description' => '标签映射', + 'type' => 'object', + 'additionalProperties' => ['type' => 'string', 'example' => 'latest', 'description' => '标签的Key。'], + ], + 'EditingVersion' => ['title' => '正在编辑的版本', 'description' => '正在编辑的版本', 'type' => 'string', 'example' => '0.0.3'], + 'ReviewingVersion' => ['title' => '审核中的版本', 'description' => '审核中的版本', 'type' => 'string', 'example' => '0.0.2'], + 'OnlineCnt' => ['title' => '在线版本数量', 'description' => '在线版本数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'], + 'DownloadCount' => ['title' => '总下载次数', 'description' => '总下载次数', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'NamespaceId' => ['description' => '库所属组或者企业空间 ID', 'type' => 'string', 'example' => 'cn-hangzhou:creatulize-test'], + 'Name' => ['description' => '名称', 'type' => 'string', 'example' => 'OCR品牌'], + 'Description' => ['description' => '描述。', 'type' => 'string', 'example' => 'secret for bbtadmin'], + 'Owner' => ['description' => '责任人的账号 ID。', 'type' => 'string', 'example' => 'manual'], + 'Writeable' => ['description' => '是否可以编辑。', 'type' => 'boolean'], + ], + ], + ], + ], + ], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列出 Skills', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"195BF118-9AEF-5F3F-9A58-D88A77EB07DE\\",\\n \\"Data\\": {\\n \\"TotalCount\\": 0,\\n \\"PageNumber\\": 1,\\n \\"PagesAvailable\\": 10,\\n \\"PageItems\\": [\\n {\\n \\"UpdateTime\\": 0,\\n \\"Enable\\": false,\\n \\"BizTags\\": \\"test\\",\\n \\"From\\": \\"aqs\\",\\n \\"Scope\\": \\"rd-yORclL\\",\\n \\"Labels\\": {\\n \\"key\\": \\"latest\\"\\n },\\n \\"EditingVersion\\": \\"0.0.3\\",\\n \\"ReviewingVersion\\": \\"0.0.2\\",\\n \\"OnlineCnt\\": 1,\\n \\"DownloadCount\\": 100,\\n \\"NamespaceId\\": \\"cn-hangzhou:creatulize-test\\",\\n \\"Name\\": \\"OCR品牌\\",\\n \\"Description\\": \\"secret for bbtadmin\\",\\n \\"Owner\\": \\"manual\\",\\n \\"Writeable\\": true\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'OfflineSkill' => [ + 'summary' => '下线 Skill 或者 Skill 的某个版本。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'Scope', + 'in' => 'query', + 'schema' => ['title' => '操作范围：skill（整个 Skill）或 version（指定版本）', 'description' => '操作范围：skill（整个 Skill）或 version（指定版本）', 'type' => 'string', 'required' => false, 'example' => 'version'], + ], + [ + 'name' => 'SkillVersion', + 'in' => 'query', + 'schema' => ['title' => '版本号（当 scope 为 version 时必填）', 'description' => '版本号（当 scope 为 version 时必填）', 'type' => 'string', 'required' => false, 'example' => '0.0.2'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '下线 Skill', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\"\\n}","type":"json"}]', + ], + 'OnlineSkill' => [ + 'summary' => '上线 Skill 或者 Skill 的某个版本。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'Scope', + 'in' => 'query', + 'schema' => ['title' => '操作范围：skill（整个 Skill）或 version（指定版本）', 'description' => '操作范围：skill（整个 Skill）或 version（指定版本）', 'type' => 'string', 'required' => false, 'example' => 'version'], + ], + [ + 'name' => 'SkillVersion', + 'in' => 'query', + 'schema' => ['title' => '版本号（当 scope 为 version 时必填）', 'description' => '版本号（当 scope 为 version 时必填）', 'type' => 'string', 'required' => false, 'example' => '0.0.2'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '上线 Skill', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\"\\n}","type":"json"}]', + ], + 'PublishSkillVersion' => [ + 'summary' => '发布 Skill 的某个版本。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'SkillVersion', + 'in' => 'query', + 'schema' => ['title' => '版本号', 'description' => '版本号', 'type' => 'string', 'required' => true, 'example' => '0.0.2'], + ], + [ + 'name' => 'UpdateLatestLabel', + 'in' => 'query', + 'schema' => ['title' => '是否更新 latest 标签', 'description' => '是否更新 latest 标签', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '本次调用请求的ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。', 'type' => 'string', 'example' => '5D26736A-7CB1-5133-9D51-7F7451BBB2C3'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '发布 Skill 版本', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"5D26736A-7CB1-5133-9D51-7F7451BBB2C3\\"\\n}","type":"json"}]', + ], + 'SubmitPromptVersion' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => 'Prompt 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + [ + 'name' => 'PromptVersion', + 'in' => 'query', + 'schema' => ['title' => '要提交的版本号，不填则提交当前草稿', 'description' => '要提交的版本号，不填则默认提交当前的草稿版本', 'type' => 'string', 'required' => false, 'example' => '0.0.1'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<String>', + 'description' => 'RestResult<String>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '提交的版本的版本号', 'type' => 'string', 'example' => '0.0.1'], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'PromptVersionNotFound', 'errorMessage' => 'The specificed prompt version is illegal or not found.', 'description' => '指定的提示词版本不存在或者非法'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '将提示词的草稿版本提交发布为正式版本', + 'summary' => '将提示词的草稿版本提交发布为正式版本。要求指定的版本必须为草稿版本。', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": \\"0.0.1\\"\\n}","type":"json"}]', + ], + 'SubmitSkillVersion' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'SkillVersion', + 'in' => 'query', + 'schema' => ['title' => '草稿版本号', 'description' => '草稿版本号', 'type' => 'string', 'required' => true, 'example' => '0.0.2'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<String>', + 'description' => 'RestResult<String>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求ID', 'type' => 'string', 'example' => 'BE66410A-37F8-55C5-8471-589CA195760C'], + 'Data' => ['description' => 'Skill 版本。', 'type' => 'string', 'example' => 'ba9b5c2466dc408c9fcd9df72bcd762a'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '提交 Skill 版本', + 'summary' => '将 Skill 的某个版本提交审核。', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"BE66410A-37F8-55C5-8471-589CA195760C\\",\\n \\"Data\\": \\"ba9b5c2466dc408c9fcd9df72bcd762a\\"\\n}","type":"json"}]', + ], + 'UpdateNamespace' => [ + 'summary' => '更新命名空间信息', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'Name', + 'in' => 'query', + 'schema' => ['title' => '工作空间名称', 'description' => '工作空间名称', 'type' => 'string', 'required' => false, 'example' => '我的Prompt空间'], + ], + [ + 'name' => 'Description', + 'in' => 'query', + 'schema' => ['title' => '工作空间描述', 'description' => '工作空间描述', 'type' => 'string', 'required' => false, 'example' => '用于管理客服场景的Prompt'], + ], + [ + 'name' => 'Tags', + 'in' => 'query', + 'schema' => ['title' => '标签，多个用逗号分隔。传空串表示清空。', 'description' => '标签，多个用逗号分隔。传空串表示清空。', 'type' => 'string', 'required' => false, 'example' => 'customer-service,production'], + ], + [ + 'name' => 'ScanPolicy', + 'in' => 'query', + 'schema' => ['description' => '扫描策略。'."\n" + ."\n" + .'包含两个配置项：'."\n" + .'- minBlockRiskLevel:风险等级拦截'."\n" + .' - high: 拦截高风险'."\n" + .' - medium: 拦截中 / 高风险'."\n" + .' - low: 拦截高 / 中 / 低所有风险'."\n" + .'- maxSkipRatio:最大跳过比例，若扫描跳过比例大于该值，视为不通过。', 'type' => 'string', 'required' => false, 'example' => '{"minBlockRiskLevel":"medium","maxSkipRatio":0.2}'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Boolean>', + 'description' => 'RestResult<Boolean>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '是否成功', 'type' => 'boolean', 'example' => 'true'], + ], + ], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新命名空间', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": true\\n}","type":"json"}]', + ], + 'UpdatePrompt' => [ + 'summary' => '修改提示词的元数据，例如描述，业务标签等。', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => '提示词唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + [ + 'name' => 'Description', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 描述', 'description' => '提示词描述', 'type' => 'string', 'required' => false, 'example' => '客服问答 Prompt'], + ], + [ + 'name' => 'BizTags', + 'in' => 'query', + 'style' => 'json', + 'schema' => [ + 'title' => '业务标签，字符串数组', + 'description' => '业务标签列表，字符串数组', + 'type' => 'array', + 'items' => ['description' => '业务标签', 'type' => 'string', 'required' => false, 'example' => 'cs'], + 'required' => false, + 'example' => '["cs","qa","support"]', + ], + ], + [ + 'name' => 'Labels', + 'in' => 'query', + 'style' => 'json', + 'schema' => ['description' => '提示词版本和标签的映射关系', 'type' => 'object', 'required' => false, 'example' => '{"latest":"0.0.1","stable":"0.0.1"}'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Boolean>', + 'description' => 'RestResult<Boolean>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '修改结果', 'type' => 'boolean', 'example' => 'true'], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'PromptNotFound', 'errorMessage' => 'The specified prompt does not exist.', 'description' => '当前操作的 Prompt 不存在'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '修改提示词的元数据', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": true\\n}","type":"json"}]', + ], + 'UpdatePromptVersion' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'PromptKey', + 'in' => 'query', + 'schema' => ['title' => 'Prompt 唯一标识', 'description' => 'Prompt 唯一标识', 'type' => 'string', 'required' => true, 'example' => 'customer-service-qa'], + ], + [ + 'name' => 'Template', + 'in' => 'query', + 'schema' => ['title' => '更新后的模板内容', 'description' => '更新后的模板内容', 'type' => 'string', 'required' => true, 'example' => '你是一个客服助手，请回答：{question}'], + ], + [ + 'name' => 'Variables', + 'in' => 'query', + 'schema' => ['title' => '更新后的变量定义 JSON', 'description' => '更新后的变量定义 JSON', 'type' => 'string', 'required' => false, 'example' => '[{"name":"question","defaultValue":"Hello"}]'], + ], + [ + 'name' => 'CommitMsg', + 'in' => 'query', + 'schema' => ['title' => '提交说明', 'description' => '提交说明', 'type' => 'string', 'required' => false, 'example' => '优化回答语气'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Boolean>', + 'description' => 'RestResult<Boolean>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '请求 ID', 'type' => 'string', 'example' => 'D9E87E66-9EF0-5C10-A5E6-924020A0C9B7'], + 'Data' => ['description' => '修改结果', 'type' => 'boolean', 'example' => 'true'], + ], + ], + ], + ], + 'errorCodes' => [ + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'PromptVersionNotFound', 'errorMessage' => 'The specificed prompt version is illegal or not found.', 'description' => '指定的提示词版本不存在或者非法'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新提示词的草稿版本', + 'summary' => '更新提示词版本内容。只支持修改提示词的草稿版本', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"D9E87E66-9EF0-5C10-A5E6-924020A0C9B7\\",\\n \\"Data\\": true\\n}","type":"json"}]', + ], + 'UpdateSkillBizTags' => [ + 'summary' => '更新业务标签', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000', 'description' => '工作空间 ID'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill', 'description' => 'Skill 名称'], + ], + [ + 'name' => 'BizTags', + 'in' => 'query', + 'schema' => ['title' => '业务标签 JSON 数组字符串', 'type' => 'string', 'required' => true, 'example' => '["cs","qa","support"]', 'description' => '业务标签 JSON 数组字符串'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['type' => 'string', 'description' => ''], + ], + 'description' => 'RestResult<Void>', + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新 Skill 业务标签', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"\\"\\n}","type":"json"}]', + ], + 'UpdateSkillDraft' => [ + 'summary' => '更新 Draft', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'SkillCard', + 'in' => 'query', + 'schema' => ['title' => 'Skill 卡片 JSON 字符串，包含完整 Skill 信息', 'description' => 'Skill 卡片 JSON 字符串，包含完整 Skill 信息', 'type' => 'string', 'required' => true, 'example' => '{"name":"customer-service-skill","description":"..."}'], + ], + [ + 'name' => 'CommitMsg', + 'in' => 'query', + 'schema' => ['title' => '提交说明', 'description' => '提交说明', 'type' => 'string', 'required' => false, 'example' => '更新说明'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => '6F402E85-E6D9-5A79-9EAF-8A1B6DCE7F79'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新 Skill 草稿', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"6F402E85-E6D9-5A79-9EAF-8A1B6DCE7F79\\"\\n}","type":"json"}]', + ], + 'UpdateSkillLabels' => [ + 'summary' => '更新版本标签', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'Labels', + 'in' => 'query', + 'schema' => ['title' => '版本标签映射 JSON 字符串', 'description' => '版本标签映射 JSON 字符串', 'type' => 'string', 'required' => true, 'example' => '{"latest":"0.0.2","stable":"0.0.1"}'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => '195BF118-9AEF-5F3F-9A58-D88A77EB07DE'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新 Skill 版本标签', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"195BF118-9AEF-5F3F-9A58-D88A77EB07DE\\"\\n}","type":"json"}]', + ], + 'UpdateSkillScope' => [ + 'summary' => '更新可见性', + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'update', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'description' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000'], + ], + [ + 'name' => 'SkillName', + 'in' => 'query', + 'schema' => ['title' => 'Skill 名称', 'description' => 'Skill 名称', 'type' => 'string', 'required' => true, 'example' => 'customer-service-skill'], + ], + [ + 'name' => 'Scope', + 'in' => 'query', + 'schema' => ['title' => '可见性', 'description' => '可见性', 'type' => 'string', 'required' => true, 'example' => 'PUBLIC'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<Void>', + 'description' => 'RestResult<Void>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['description' => '阿里云为该请求生成的唯一标识符。', 'type' => 'string', 'example' => 'F4BFD370-7466-5F56-ACE5-A2D11A26C6BB'], + ], + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新 Skill 的可见性', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"F4BFD370-7466-5F56-ACE5-A2D11A26C6BB\\"\\n}","type":"json"}]', + ], + 'UploadSkillViaOss' => [ + 'methods' => ['get', 'post'], + 'schemes' => ['https'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'operationType' => 'write', + 'deprecated' => false, + 'systemTags' => [ + 'operationType' => 'create', + 'riskType' => 'none', + 'chargeType' => 'free', + 'abilityTreeNodes' => ['FEATUREmseSJUUGO'], + ], + 'parameters' => [ + [ + 'name' => 'NamespaceId', + 'in' => 'query', + 'schema' => ['title' => '工作空间 ID', 'type' => 'string', 'required' => true, 'example' => '550e8400-e29b-41d4-a716-446655440000', 'description' => ''], + ], + [ + 'name' => 'OssObjectName', + 'in' => 'query', + 'schema' => ['title' => 'OSS 对象名称（路径）', 'type' => 'string', 'required' => true, 'description' => ''], + ], + [ + 'name' => 'Overwrite', + 'in' => 'query', + 'schema' => ['title' => '是否覆盖已存在的 Skill，默认 false', 'type' => 'boolean', 'example' => 'false', 'description' => ''], + ], + [ + 'name' => 'CommitMsg', + 'in' => 'query', + 'schema' => ['type' => 'string'], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => [ + 'title' => 'RestResult<String>', + 'type' => 'object', + 'properties' => [ + 'RequestId' => ['type' => 'string', 'description' => ''], + 'Data' => ['type' => 'string', 'description' => ''], + ], + 'description' => '', + ], + ], + ], + 'errorCodes' => [ + 400 => [ + ['errorCode' => 'InvalidParameter', 'errorMessage' => 'Parameter Error.', 'description' => '参数缺失、格式错误或校验不通过'], + ], + 403 => [ + ['errorCode' => 'NoPermission', 'errorMessage' => 'You are not authorized to access this resource.', 'description' => '当前用户没有操作对应资源的权限'], + ], + [ + ['errorCode' => 'SkillNotFound', 'errorMessage' => 'The specified skill does not exist.', 'description' => '当前操作的 Skill 不存在'], + ], + 409 => [ + ['errorCode' => 'SkillAlreadyExist', 'errorMessage' => 'Skill already exist.', 'description' => '对应的 Skill 已存在'], + ], + 500 => [ + ['errorCode' => 'SysyemError', 'errorMessage' => 'System error.', 'description' => '系统异常'], + ], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '通过 OSS 上传 Skill', + 'summary' => '通过 OSS 上传 Skill (ZIP) - 从 OSS 拉取文件内容后上传到 Nacos', + 'changeSet' => [], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"RequestId\\": \\"\\",\\n \\"Data\\": \\"\\"\\n}","type":"json"}]', + ], + ], + 'endpoints' => [], + 'errorCodes' => [ + ['code' => 'AgentSpecAlreadyExist', 'message' => 'AgentSpec already exist.', 'http_code' => 409, 'description' => '对应的 AgentSpec 已经存在'], + ['code' => 'AgentSpecNotFound', 'message' => 'Corresponding agent spec not found.', 'http_code' => 404, 'description' => '对应的 AgentSpec 不存在'], + ['code' => 'AlreadyExist', 'message' => 'Skill already exist.', 'http_code' => 409, 'description' => '对应的 Skill 已经存在'], + ['code' => 'InvalidParameter', 'message' => 'Parameter Error.', 'http_code' => 400, 'description' => '参数缺失、格式错误或校验不通过'], + ['code' => 'NamespaceInUse', 'message' => 'The namespace is in use and cannot be deleted.', 'http_code' => 400, 'description' => '命名空间下使用中，还有未删除的资源'], + ['code' => 'NamespaceNotFound', 'message' => 'The specified namespace does not exist.', 'http_code' => 404, 'description' => '指定的命名空间不存在'], + ['code' => 'NamespaceQuotaLimit', 'message' => 'User has reached the maximum namespace limit .', 'http_code' => 400, 'description' => '单个用户创建的命名空间数量达到上限'], + ['code' => 'NamespaceQuotaLimited', 'message' => 'User has reached the maximum namespace limit .', 'http_code' => 400, 'description' => '单个用户创建的命名空间数量达到上限'], + ['code' => 'NoPermission', 'message' => 'You are not authorized to access this resource.', 'http_code' => 403, 'description' => '当前用户没有操作对应资源的权限'], + ['code' => 'PromptAlreadyExist', 'message' => 'The specified prompt already exists.', 'http_code' => 409, 'description' => '创建的提示词已经存在'], + ['code' => 'PromptNotFound', 'message' => 'The specified prompt does not exist.', 'http_code' => 404, 'description' => '当前操作的 Prompt 不存在'], + ['code' => 'PromptVersionAlreadyExist', 'message' => 'The specified prompt version already exist.', 'http_code' => 409, 'description' => '提示词版本已存在'], + ['code' => 'PromptVersionNotFound', 'message' => 'The specificed prompt version is illegal or not found.', 'http_code' => 404, 'description' => '指定的提示词版本不存在或者非法'], + ['code' => 'SkillAlreadyExist', 'message' => 'Skill already exist.', 'http_code' => 409, 'description' => '对应的 Skill 已存在'], + ['code' => 'SkillNotFound', 'message' => 'The specified skill does not exist.', 'http_code' => 404, 'description' => '当前操作的 Skill 不存在'], + ['code' => 'SysyemError', 'message' => 'System error.', 'http_code' => 500, 'description' => '系统异常'], + ], + 'changeSet' => [], +]; |