{"record":{"id":"77b68be6003190f2","repo":"alibaba/nacos","slug":"unsupported-agent-orderby-s","errorCode":null,"errorMessage":"Unsupported Agent orderBy: %s","messagePattern":"Unsupported Agent orderBy: (.+?)","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":400,"severity":"error","filePath":"ai/src/main/java/com/alibaba/nacos/ai/service/agent/AgentOperationService.java","lineNumber":989,"sourceCode":"            || request.getTags() != null || request.getExtensions() != null;\n    }\n    \n    private void validateListFilters(String agentNameContains, String tag, String scope,\n        String orderBy) {\n        if (StringUtils.isNotEmpty(agentNameContains)) {\n            AgentValidationUtils.validateAgentName(agentNameContains);\n        }\n        if (StringUtils.isNotBlank(tag)\n            && tag.codePointCount(0, tag.length()) > MAX_TAG_LENGTH) {\n            throw new IllegalArgumentException(\"Invalid Agent tag filter: \" + tag);\n        }\n        if (StringUtils.isNotBlank(scope)\n            && !VisibilityConstants.SCOPE_PUBLIC.equals(scope)\n            && !VisibilityConstants.SCOPE_PRIVATE.equals(scope)) {\n            throw new IllegalArgumentException(\"Agent scope must be PUBLIC or PRIVATE\");\n        }\n        if (StringUtils.isNotBlank(orderBy) && !\"download_count\".equals(orderBy)) {\n            throw new IllegalArgumentException(\"Unsupported Agent orderBy: \" + orderBy);\n        }\n    }\n    \n    private NacosApiException illegalState(String message) {\n        return new NacosApiException(NacosException.INVALID_PARAM, ErrorCode.ILLEGAL_STATE,\n            message);\n    }\n    \n    private NacosApiException conflict(String message) {\n        return new NacosApiException(NacosException.CONFLICT, ErrorCode.RESOURCE_CONFLICT,\n            message);\n    }\n}\n","sourceCodeStart":971,"sourceCodeEnd":1003,"githubUrl":"https://github.com/alibaba/nacos/blob/9b989acdf181d00898f2e8839257bb2b2a3cefe3/ai/src/main/java/com/alibaba/nacos/ai/service/agent/AgentOperationService.java#L971-L1003","documentation":"Error \"Unsupported Agent orderBy: %s\" thrown in alibaba/nacos.","triggerScenarios":"Thrown at ai/src/main/java/com/alibaba/nacos/ai/service/agent/AgentOperationService.java:989 when the library encounters an invalid state.","commonSituations":"Requesting an agent list sorted by an unsupported orderBy field.","solutions":["Check the server/plugin configuration and enable the required module or use a supported alternative."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"9b989acdf181d00898f2e8839257bb2b2a3cefe3","analyzedAt":"2026-08-14T07:17:31.569Z","schemaVersion":2},"datasetVersion":"2026-08-14T10:17:34.591Z"}