{"record":{"id":"2e4e4ae37af291c7","repo":"langchain-ai/langgraph","slug":"embed-must-be-provided","errorCode":null,"errorMessage":"embed must be provided","messagePattern":"embed must be provided","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"libs/checkpoint/langgraph/checkpoint/store/base/embed.py","lineNumber":82,"sourceCode":"    if embed is None:\n        raise ValueError(\"embed must be provided\")\n    if isinstance(embed, str):\n        init_embeddings = _get_init_embeddings()\n        if init_embeddings is None:\n            from importlib.metadata import PackageNotFoundError, version\n\n            try:\n                lc_version = version(\"langchain\")\n                version_info = f\"Found langchain version {lc_version}, but\"\n            except PackageNotFoundError:\n                version_info = \"langchain is not installed;\"","sourceCodeStart":null,"sourceCodeEnd":null,"githubUrl":"https://github.com/langchain-ai/langgraph/blob/38031739e551638e373fb553453256c23feeb41f/libs/checkpoint/langgraph/checkpoint/store/base/embed.py#L82","documentation":"Argument guard at the top of ensure_embeddings: the embed parameter is None. The function's contract is to normalize an Embeddings object, a plain embedding function, or a provider:identifier string into an Embeddings instance; with None there is nothing to wrap, so construction aborts immediately.","triggerScenarios":"Thrown at libs/checkpoint/langgraph/checkpoint/store/base/embed.py:82 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Pass an Embeddings instance, e.g. ensure_embeddings(OpenAIEmbeddings())","Pass a callable that maps list[str] -> list[list[float]] to have it wrapped in EmbeddingsLambda","Pass a provider string like 'openai:text-embedding-3-small' (requires langchain>=0.3.9)"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"38031739e551638e373fb553453256c23feeb41f","analyzedAt":"2026-08-26T18:02:49.312Z","contentChangedAt":"2026-08-26T18:02:49.312Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}