docs: clean up how-to docs to make them runnable (#1666)

langchain-ai · Sep 10, 2024 · ed0f55a · ed0f55a
1 parent 215b872
commit ed0f55a
Show file tree

Hide file tree

Showing 25 changed files with 1,239 additions and 1,243 deletions.
diff --git a/examples/human_in_the_loop/breakpoints.ipynb b/examples/human_in_the_loop/breakpoints.ipynb
diff --git a/examples/human_in_the_loop/dynamic_breakpoints.ipynb b/examples/human_in_the_loop/dynamic_breakpoints.ipynb
@@ -413,9 +413,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/human_in_the_loop/wait-user-input.ipynb b/examples/human_in_the_loop/wait-user-input.ipynb
diff --git a/examples/map-reduce.ipynb b/examples/map-reduce.ipynb
@@ -250,9 +250,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/memory/delete-messages.ipynb b/examples/memory/delete-messages.ipynb
@@ -464,9 +464,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/pass-config-to-tools.ipynb b/examples/pass-config-to-tools.ipynb
@@ -402,9 +402,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/pass-run-time-values-to-tools.ipynb b/examples/pass-run-time-values-to-tools.ipynb
@@ -53,9 +53,13 @@
     "import getpass\n",
     "import os\n",
     "\n",
-    "os.environ[\"OPENAI_API_KEY\"] = os.environ.get(\"OPENAI_API_KEY\") or getpass.getpass(\n",
-    "    \"OpenAI API Key:\"\n",
-    ")"
+    "\n",
+    "def _set_env(var: str):\n",
+    "    if not os.environ.get(var):\n",
+    "        os.environ[var] = getpass.getpass(f\"{var}: \")\n",
+    "\n",
+    "\n",
+    "_set_env(\"OPENAI_API_KEY\")"
    ]
   },
   {
@@ -524,9 +528,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "poetry-venv-311",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "poetry-venv-311"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/persistence_mongodb.ipynb b/examples/persistence_mongodb.ipynb
@@ -908,9 +908,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/persistence_postgres.ipynb b/examples/persistence_postgres.ipynb
@@ -553,9 +553,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/persistence_redis.ipynb b/examples/persistence_redis.ipynb
@@ -1000,9 +1000,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/state-model.ipynb b/examples/state-model.ipynb
diff --git a/examples/stream-multiple.ipynb b/examples/stream-multiple.ipynb
@@ -34,7 +34,7 @@
    "outputs": [],
    "source": [
     "%%capture --no-stderr\n",
-    "%pip install -U langgraph langchain-openai"
+    "%pip install -U langgraph langchain-openai langchain-community"
    ]
   },
   {
@@ -188,9 +188,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -202,7 +202,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.3"
+   "version": "3.11.9"
   }
  },
  "nbformat": 4,

diff --git a/examples/stream-updates.ipynb b/examples/stream-updates.ipynb
@@ -39,7 +39,7 @@
    "outputs": [],
    "source": [
     "%%capture --no-stderr\n",
-    "%pip install -U langgraph langchain-openai"
+    "%pip install -U langgraph langchain-openai langchain-community"
    ]
   },
   {
@@ -164,9 +164,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -178,7 +178,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.3"
+   "version": "3.11.9"
   }
  },
  "nbformat": 4,

diff --git a/examples/stream-values.ipynb b/examples/stream-values.ipynb
@@ -39,7 +39,7 @@
    "outputs": [],
    "source": [
     "%%capture --no-stderr\n",
-    "%pip install -U langgraph langchain-openai"
+    "%pip install -U langgraph langchain-openai langchain-community"
    ]
   },
   {
@@ -226,9 +226,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -240,7 +240,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.3"
+   "version": "3.11.9"
   }
  },
  "nbformat": 4,

diff --git a/examples/streaming-content.ipynb b/examples/streaming-content.ipynb
@@ -168,9 +168,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/streaming-events-from-within-tools-without-langchain.ipynb b/examples/streaming-events-from-within-tools-without-langchain.ipynb
@@ -337,9 +337,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/streaming-events-from-within-tools.ipynb b/examples/streaming-events-from-within-tools.ipynb
@@ -280,9 +280,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -294,7 +294,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.3"
+   "version": "3.11.9"
   }
  },
  "nbformat": 4,

diff --git a/examples/streaming-from-final-node.ipynb b/examples/streaming-from-final-node.ipynb
@@ -28,7 +28,7 @@
    "outputs": [],
    "source": [
     "%%capture --no-stderr\n",
-    "%pip install -U langgraph langchain-openai"
+    "%pip install -U langgraph langchain-openai langchain-community"
    ]
   },
   {
@@ -317,9 +317,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/streaming-tokens-without-langchain.ipynb b/examples/streaming-tokens-without-langchain.ipynb
@@ -347,9 +347,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/streaming-tokens.ipynb b/examples/streaming-tokens.ipynb
@@ -451,7 +451,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.2"
+   "version": "3.11.9"
   }
  },
  "nbformat": 4,

diff --git a/examples/subgraph-transform-state.ipynb b/examples/subgraph-transform-state.ipynb
@@ -271,9 +271,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/subgraph.ipynb b/examples/subgraph.ipynb
@@ -651,9 +651,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/tool-calling-errors.ipynb b/examples/tool-calling-errors.ipynb
@@ -579,9 +579,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {

diff --git a/examples/tool-calling.ipynb b/examples/tool-calling.ipynb
@@ -492,9 +492,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "langgraph",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "langgraph"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {