{"record":{"id":"a12175cfa21cb01d","repo":"Significant-Gravitas/AutoGPT","slug":"chat-transport-not-configured","errorCode":null,"errorMessage":"chat_transport_not_configured","messagePattern":"chat_transport_not_configured","errorType":"http","errorClass":"HTTPException","httpStatus":503,"severity":"error","filePath":"autogpt_platform/backend/backend/api/features/chat/routes.py","lineNumber":575,"sourceCode":"\nasync def _resolve_new_session_llm_route(\n    user_id: str,\n    request: CreateSessionRequest | None,\n) -> tuple[CopilotLlmAuthProvider, str | None]:\n    auth_provider = request.llm_auth_provider if request else \"platform\"\n    credential_id = request.llm_credential_id if request else None\n\n    if auth_provider == \"codex\":\n        await enforce_codex_access_http(user_id)\n\n    if request is not None and request.builder_graph_id is not None:\n        if auth_provider == \"codex\" or credential_id is not None:\n            raise HTTPException(\n                status_code=422,\n                detail=\"codex_builder_session_unsupported\",\n            )\n        if not _is_deployment_chat_available():\n            raise HTTPException(\n                status_code=503,\n                detail=\"chat_transport_not_configured\",\n            )\n        return \"platform\", None\n\n    transports = await _get_chat_transports(user_id)\n    if request is not None:\n        route_was_explicit = bool(\n            {\"llm_auth_provider\", \"llm_credential_id\"} & request.model_fields_set\n        )\n        if route_was_explicit:\n            if auth_provider == \"platform\" and credential_id is not None:\n                raise HTTPException(\n                    status_code=422,\n                    detail=\"codex_credential_not_allowed\",\n                )\n            if auth_provider == \"codex\" and credential_id is None:\n                raise HTTPException(","sourceCodeStart":557,"sourceCodeEnd":593,"githubUrl":"https://github.com/Significant-Gravitas/AutoGPT/blob/9c8bb5550f446ba5d3046b78896578742495b3cf/autogpt_platform/backend/backend/api/features/chat/routes.py#L557-L593","documentation":"A 503 from _resolve_new_session_llm_route's builder branch: the request is a valid builder session (builder_graph_id set, no codex/credential override), but _is_deployment_chat_available() reports the deployment chat transport is not configured on this backend. The backend knows it cannot serve the session, so it fails fast with service-unavailable instead of creating a broken session.","triggerScenarios":"POST /chat/sessions with builder_graph_id while the backend lacks the deployment-chat configuration (missing agent-server base URL / transport settings for deployment chat in that environment).","commonSituations":"Local dev backend started without the deployment/agent-server env vars; a staging environment where the builder chat feature is not enabled; version skew where the frontend deploys builder-chat UI ahead of backend configuration.","solutions":["Enable/configure deployment chat on the backend: set the required transport/env config (deployment chat / agent-server endpoint) and restart.","Verify you are pointing at an environment that supports builder chat (prod/staging vs a stripped-down local stack).","If the feature is intentionally off in this environment, gate the builder-chat entry point in the client so the request is never made."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"const caps = await getBackendCapabilities();\nif (!caps.deployment_chat) showUnavailable(); else createSession({builder_graph_id});","typeGuard":null,"tryCatchPattern":"try {\n  await createSession({builder_graph_id: g});\n} catch (e) {\n  if (e.status === 503) showFeatureUnavailable('Builder chat is not configured here');\n  else throw e;\n}","preventionTips":["Gate builder-chat UI on a capability/feature flag from the backend.","Keep deployment-chat env config present in every environment that serves the builder UI."],"tags":["backend","chat","deployment","configuration","http-503"],"backgroundTag":null,"analyzedSha":"9c8bb5550f446ba5d3046b78896578742495b3cf","analyzedAt":"2026-08-14T17:17:21.957Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}