alibaba/nacos · error · IllegalArgumentException

Agent draft must not be null

Error message

Agent draft must not be null

What it means

Error "Agent draft must not be null" thrown in alibaba/nacos.

Source

Thrown at ai/src/main/java/com/alibaba/nacos/ai/service/agent/AgentPersistenceService.java:774

            versionInfo.setLabels(new LinkedHashMap<String, String>(derived.getLabels()));
            
            AgentResourceExt resourceExt = AgentResourceExtSerializer.deserialize(meta.getExt());
            resourceExt.setVersionCatalog(derived.getVersionCatalog());
            AiResource updateValue = buildMetaUpdateValue(meta, versionInfo, resourceExt);
            if (resourcePersistService.updateMetaCas(namespaceId, agentName,
                Constants.Agent.RESOURCE_TYPE_AGENT, meta.getMetaVersion(), updateValue)) {
                return getAgent(namespaceId, agentName);
            }
        }
        throw conflict("Agent lifecycle metadata changed concurrently: " + agentName, null);
    }
    
    private void validateSubsequentDraftInputs(String namespaceId, String agentName,
        AgentVersionDetail draft, String basedOnVersion) {
        AgentValidationUtils.validateNamespaceId(namespaceId);
        AgentValidationUtils.validateAgentName(agentName);
        if (draft == null) {
            throw new IllegalArgumentException("Agent draft must not be null");
        }
        AgentValidationUtils.validateVersion(draft.getVersion());
        if (draft.getNamespaceId() != null
            && !namespaceId.equals(draft.getNamespaceId())) {
            throw new IllegalArgumentException("Agent draft namespaceId does not match request");
        }
        if (draft.getAgentName() != null && !agentName.equals(draft.getAgentName())) {
            throw new IllegalArgumentException("Agent draft agentName does not match request");
        }
        if (draft.getStatus() != null
            && !AiConstants.Agent.VERSION_STATUS_DRAFT.equals(draft.getStatus())) {
            throw new IllegalArgumentException("Agent draft status must be draft");
        }
        if (draft.getContentDigest() != null || draft.getCreateTime() != null
            || draft.getUpdateTime() != null) {
            throw new IllegalArgumentException(
                "Agent draft must not contain read-only projection fields");
        }

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Provide a non-null value for agent draft before invoking this operation.

When it happens

Trigger: Thrown at ai/src/main/java/com/alibaba/nacos/ai/service/agent/AgentPersistenceService.java:774 when the library encounters an invalid state.

Common situations: Calling agent draft persistence with a null draft object.

AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14). Data as JSON: /api/errors/b7edc673ee34fb0a. Report an issue: GitHub.