Refresh LangGraph Couchbase persistence notebook

[dex-the-ai]

Summary

• refresh langgraph/couchbase_persistence_langgraph.ipynb so it runs non-interactively with env-driven OpenAI and local Couchbase settings
• keep the existing langgraph install pinned, but update that pin to the latest tested version (1.1.10) and include langchain-openai alongside the current Couchbase checkpointer package
• address the LangGraph deprecation feedback by switching the notebook example from create_react_agent to create_agent in the sync and async flows
• tighten the notebook setup text for the local test / langgraph checkpoint collections

Verification

• uv venv -p 3.12 --seed --clear .venv
• python -m pip install -U papermill nbclient jupyter ipykernel
• python -m pip install -U pip-audit
• pip-audit → no known vulnerabilities
• papermill -k vsc-langgraph-312 langgraph/couchbase_persistence_langgraph.ipynb tutorial-maintenance/runs/couchbase-examples__vector-search-cookbook/2026-04-28-langgraph-couchbase-persistence/couchbase_persistence_langgraph.executed.ipynb

Evidence

• sync and async LangGraph checkpoint flows both executed successfully against local Couchbase
• the notebook now reads OPENAI_API_KEY, CB_CONN_STR, CB_USER, CB_PASS, CB_BUCKET_NAME, and CB_SCOPE_NAME from the environment instead of hard-coding local credentials
• visual evidence is included for the rendered executed notebook output tied to this PR

Rendered notebook screenshot

• tutorial-maintenance/runs/couchbase-examples__vector-search-cookbook/2026-04-28-langgraph-couchbase-persistence/verification.md — run summary, deprecation-fix note, and local setup notes

• tutorial-maintenance/runs/couchbase-examples__vector-search-cookbook/2026-04-28-langgraph-couchbase-persistence/dependency-freeze.txt — tested package versions from the successful run

• papermill result

  Executed 27/27 cells successfully with kernel vsc-langgraph-312.

  Local verification also created the required Couchbase bucket/scope/collections for this artifact run: test, langgraph, checkpoints, and checkpoint_writes.

Notes

• This PR is intentionally scoped to the single langgraph/couchbase_persistence_langgraph.ipynb artifact.
• The deprecation follow-up is now part of the artifact branch itself: the notebook uses create_agent instead of the older create_react_agent example while keeping the rest of the maintenance scope focused.

[github-actions]

Caution

Notebooks or Frontmatter Files Have Been Modified

• Please ensure that a frontmatter.md file is accompanying the notebook file, and that the frontmatter is up to date.
• These changes will be published to the developer portal tutorials only if frontmatter.md is included.
• Proofread all changes before merging, as changes to notebook and frontmatter content will update the developer tutorial.

1 Notebook Files Modified:

Notebook File	Frontmatter Included?
langgraph/couchbase_persistence_langgraph.ipynb	✅

0 Frontmatter Files Modified:

Frontmatter File
Note: frontmatter will be checked and tested in the Test Frontmatter workflow.

[gemini-code-assist]

Code Review

This pull request updates the Couchbase persistence notebook for LangGraph by adding support for langchain-openai, improving environment variable handling, and replacing hardcoded connection strings with configurable variables. The review feedback suggests refining the environment variable check in _set_env to correctly handle empty strings and recommends avoiding hardcoded default passwords to improve security practices.

[ejscribner]

If we can, lets get this up to date so we avoid the deprecation

[dex-the-ai]

Owner ping for this maintenance PR: @teetangh @VirajAgarwal1

Requesting review from the manifest-listed owner(s) where GitHub does not already show a pending review request.

[VirajAgarwal1]

lgtm 🚀
Thanks @dex-the-ai and @ejscribner
Dex helps out a ton!!