{"record":{"id":"ae3fa7715de20cd0","repo":"conductor-oss/conductor","slug":"vertexaiagentclient-is-not-yet-implemented","errorCode":null,"errorMessage":"VertexAiAgentClient is not yet implemented","messagePattern":"VertexAiAgentClient is not yet implemented","errorType":"exception","errorClass":"UnsupportedOperationException","httpStatus":null,"severity":"error","filePath":"agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/service/VertexAiAgentClient.java","lineNumber":46,"sourceCode":" *\n * <p>To implement: add {@code @Component} to activate auto-registration, inject {@link\n * org.conductoross.conductor.ai.agentspan.runtime.credentials.CredentialResolutionService} for\n * credentials, and replace each method body with the real Vertex AI Agent Builder REST calls.\n *\n * <p>rawConfig keys to support: {@code projectId}, {@code location}, {@code agentId}, {@code\n * sessionId}.\n */\n// @Component  -- uncomment when implemented\npublic class VertexAiAgentClient implements ConductorAgentClient {\n\n    @Override\n    public String agentType() {\n        return \"vertex\";\n    }\n\n    @Override\n    public ConductorAgentStartResponse startAgent(ConductorAgentStartRequest request) {\n        throw new UnsupportedOperationException(\"VertexAiAgentClient is not yet implemented\");\n    }\n\n    @Override\n    public ConductorAgentStatusResponse getAgentStatus(String executionId) {\n        throw new UnsupportedOperationException(\"VertexAiAgentClient is not yet implemented\");\n    }\n\n    @Override\n    public void respond(ConductorAgentRespondRequest request) {\n        throw new UnsupportedOperationException(\"VertexAiAgentClient is not yet implemented\");\n    }\n\n    @Override\n    public void cancelAgent(ConductorAgentCancelRequest request) {\n        throw new UnsupportedOperationException(\"VertexAiAgentClient is not yet implemented\");\n    }\n}\n","sourceCodeStart":28,"sourceCodeEnd":64,"githubUrl":"https://github.com/conductor-oss/conductor/blob/cf7c3e4a8adfb158be778ab1ec525323c363cd3a/agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/service/VertexAiAgentClient.java#L28-L64","documentation":"VertexAiAgentClient is a stub ConductorAgentClient whose startAgent method throws UnsupportedOperationException. The class is deliberately not a Spring @Component (the annotation is commented out) and exists as a placeholder so the agentType `vertex` is reserved; invoking startAgent means the caller bypassed the registry's enabled-client check.","triggerScenarios":"Calling agentType(\"vertex\").startAgent(request) on the stub directly, or a misconfigured registry that resolves `vertex` to this stub and submits a ConductorAgentStartRequest.","commonSituations":"User enabled the `vertex` agent type in config before the integration shipped; a test wired the stub directly; the @Component line was uncommented accidentally.","solutions":["Do not enable the `vertex` agent type — keep using a supported client (e.g. the default/Anthropic/OpenAI client).","If you need Vertex AI, implement startAgent against the Vertex Agent Builder API and uncomment @Component.","Check your agent-type routing config and remove `vertex` from the enabled list."],"exampleFix":"// before: routing config enables vertex\nconductor.integrations.ai.agents.enabled-types: anthropic, vertex\n// after: only ship supported types\nconductor.integrations.ai.agents.enabled-types: anthropic","handlingStrategy":"fallback","validationCode":"// Do not route start requests to a stub client.\nboolean isImplemented(ConductorAgentClient c) {\n    try { c.agentType(); }\n    catch (UnsupportedOperationException e) { return false; }\n    return true;\n}\n// Prefer: check the enabled/supported agent types list before calling startAgent.","typeGuard":"boolean supportsVertex(List<String> enabledTypes) {\n    return enabledTypes.contains(\"vertex\") && vertexImplementationPresent();\n}","tryCatchPattern":"try {\n    return client.startAgent(request);\n} catch (UnsupportedOperationException e) {\n    // fall back to a supported agent type, or return 501 Not Implemented\n    return notImplemented(\"vertex agent not implemented\");\n}","preventionTips":["Keep `vertex` out of the enabled agent types until the integration ships.","Do not uncomment the @Component on the stub.","Route based on a registry of implemented clients, not on agentType strings."],"tags":["agentspan","vertex-ai","not-implemented","stub"],"backgroundTag":null,"analyzedSha":"cf7c3e4a8adfb158be778ab1ec525323c363cd3a","analyzedAt":"2026-08-14T03:33:19.897Z","schemaVersion":2},"datasetVersion":"2026-08-14T05:17:29.042Z"}