From 543d7d85afc0850f78941df120b25f772300d033 Mon Sep 17 00:00:00 2001 From: Lauren Hirata Singh Date: Mon, 16 Jun 2025 16:17:52 -0400 Subject: [PATCH] Organize existing content differently --- docs/_scripts/notebook_hooks.py | 1 + docs/docs/agents/deployment.md | 2 +- docs/docs/agents/overview.md | 2 +- docs/docs/concepts/deployment_options.md | 11 +- docs/docs/tutorials/deployment.md | 22 -- docs/mkdocs.yml | 304 +++++++++++------------ docs/uv.lock | 2 + 7 files changed, 166 insertions(+), 178 deletions(-) delete mode 100644 docs/docs/tutorials/deployment.md diff --git a/docs/_scripts/notebook_hooks.py b/docs/_scripts/notebook_hooks.py index 30545408e..4e7fb697e 100644 --- a/docs/_scripts/notebook_hooks.py +++ b/docs/_scripts/notebook_hooks.py @@ -107,6 +107,7 @@ REDIRECT_MAP = { # deployment redirects "how-tos/deploy-self-hosted.md": "cloud/deployment/self_hosted_data_plane.md", "concepts/self_hosted.md": "concepts/langgraph_self_hosted_data_plane.md", + "tutorials/deployment.md": "concepts/deployment_options.md", # assistant redirects "cloud/how-tos/assistant_versioning.md": "cloud/how-tos/configuration_cloud.md", } diff --git a/docs/docs/agents/deployment.md b/docs/docs/agents/deployment.md index 538528549..5e9a6bd07 100644 --- a/docs/docs/agents/deployment.md +++ b/docs/docs/agents/deployment.md @@ -89,4 +89,4 @@ LangGraph Studio Web is a specialized UI that you can connect to LangGraph API s ## Deployment -Once your LangGraph app is running locally, you can deploy it using LangGraph Platform. Refer to the [deployment options guide](../tutorials/deployment.md) for detailed instructions on all supported deployment models. +Once your LangGraph app is running locally, you can deploy it using LangGraph Platform. Refer to the [deployment options guide](../concepts/deployment_options.md) for detailed instructions on all supported deployment models. diff --git a/docs/docs/agents/overview.md b/docs/docs/agents/overview.md index b8ffb6cf2..6065da9eb 100644 --- a/docs/docs/agents/overview.md +++ b/docs/docs/agents/overview.md @@ -32,7 +32,7 @@ LangGraph includes several capabilities essential for building robust, productio - [**Streaming support**](./streaming.md): Real-time streaming of agent state, model tokens, tool outputs, or combined streams. - [**Deployment tooling**](./deployment.md): Includes infrastructure-free deployment tools. [**LangGraph Platform**](https://langchain-ai.github.io/langgraph/concepts/langgraph_platform/) supports testing, debugging, and deployment. - **[Studio](https://langchain-ai.github.io/langgraph/concepts/langgraph_studio/)**: A visual IDE for inspecting and debugging workflows. - - Supports multiple [**deployment options**](https://langchain-ai.github.io/langgraph/tutorials/deployment/) for production. + - Supports multiple [**deployment options**](https://langchain-ai.github.io/langgraph/concepts/deployment_options.md) for production. ## High-level building blocks diff --git a/docs/docs/concepts/deployment_options.md b/docs/docs/concepts/deployment_options.md index 5b776e3b1..c7d61c364 100644 --- a/docs/docs/concepts/deployment_options.md +++ b/docs/docs/concepts/deployment_options.md @@ -5,7 +5,16 @@ search: # Deployment Options -There are 4 main options for deploying with the LangGraph Platform: +## Free deployment + +There are two free options for deploying LangGraph applications via the LangGraph Server: + +1. [Local](./langgraph-platform/local-server.md): Deploy for local testing and development. +1. [Standalone Container (Lite)](../concepts/langgraph_standalone_container.md): A limited version of Standalone Container for deployments unlikely to see more that 1 million node executions per year and that do not need crons and other enterprise features. Standalone Container (Lite) deployment option is free with a LangSmith API key. + +## Production deployment + +There are 4 main options for deploying with the [LangGraph Platform](../concepts/langgraph_platform/): 1. [Cloud SaaS](#cloud-saas) diff --git a/docs/docs/tutorials/deployment.md b/docs/docs/tutorials/deployment.md deleted file mode 100644 index 9042d98b3..000000000 --- a/docs/docs/tutorials/deployment.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -search: - boost: 2 ---- - -# Deployment 🚀 - -There are two free options for deploying LangGraph applications via the LangGraph Server: - -- [Local](./langgraph-platform/local-server.md): Deploy for local testing and development. -- [Standalone Container (Lite)](../concepts/langgraph_standalone_container.md): A limited version of Standalone Container for deployments unlikely to see more that 1 million node executions per year and that do not need crons and other enterprise features. Standalone Container (Lite) deployment option is free with a LangSmith API key. - -## Other deployment options - -Additionally, you can deploy to production with [LangGraph Platform](../concepts/langgraph_platform.md): - -- [Cloud SaaS](../concepts/langgraph_cloud.md): Connect your GitHub repositories and deploy LangGraph Servers within LangChain's cloud. *We manage everything.* -- [Self-Hosted Data Plane(Beta)](../concepts/langgraph_self_hosted_data_plane.md): Create deployments from the [Control Plane UI](../concepts/langgraph_control_plane.md#control-plane-ui) and deploy LangGraph Servers to **your** cloud. *We manage the [control plane](../concepts/langgraph_control_plane.md). You manage the deployments.* -- [Self-Hosted Control Plane(Beta)](../concepts/langgraph_self_hosted_control_plane.md): Create deployments from a self-hosted [Control Plane UI](../concepts/langgraph_control_plane.md#control-plane-ui) and deploy LangGraph Servers to **your** cloud. *You manage everything.* -- [Standalone Container](../concepts/langgraph_standalone_container.md): Deploy LangGraph Server Docker images however you like. - -For more information, see [Deployment options](../concepts/deployment_options.md). diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 5c8ff289d..fa84ebc65 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -89,162 +89,151 @@ plugins: - "!^_" nav: - - Guides: + - Get started: - index.md - - Get started: - - Quickstart: agents/agents.md - - LangGraph basics: - - concepts/why-langgraph.md - - Build a basic chatbot: tutorials/get-started/1-build-basic-chatbot.md - - tutorials/get-started/2-add-tools.md - - tutorials/get-started/3-add-memory.md - - Add human-in-the-loop: tutorials/get-started/4-human-in-the-loop.md - - tutorials/get-started/5-customize-state.md - - tutorials/get-started/6-time-travel.md - - Deployment: tutorials/deployment.md - - Prebuilt agents: - - Overview: agents/overview.md - - agents/run_agents.md - - agents/streaming.md - - agents/models.md - - agents/tools.md - - agents/mcp.md - - agents/context.md - - agents/memory.md - - agents/human-in-the-loop.md - - agents/multi-agent.md - - agents/evals.md - - agents/deployment.md - - agents/ui.md - - LangGraph framework: - - Agent architectures: - - Overview: concepts/agentic_concepts.md + - Quickstarts: + - Agent: agents/agents.md + - Local server: tutorials/langgraph-platform/local-server.md + - Deployment: cloud/quick_start.md + - Set up your application: + - Use requirements.txt: cloud/deployment/setup.md + - Use pyproject.toml: cloud/deployment/setup_pyproject.md + - Use JavaScript: cloud/deployment/setup_javascript.md + - Use custom Docker: cloud/deployment/custom_docker.md + - Key concepts: + - Common patterns: + - Agent architectures: concepts/agentic_concepts.md - Workflows & agents: tutorials/workflows.md - - Graphs: - - Overview: concepts/low_level.md - - Runtime overview: concepts/pregel.md - - Use the Graph API: how-tos/graph-api.ipynb + - Agent development: agents/overview.md + - Workflow orchestration: + - Graphs: concepts/low_level.md + - Subgraphs: concepts/subgraphs.md + - Runtime: concepts/pregel.md + - Functional API: concepts/functional_api.md + - General capabilities: - Streaming: - - Overview: concepts/streaming.md - - "Stream outputs": how-tos/streaming.md - - Persistence: - - Overview: concepts/persistence.md - - concepts/durable_execution.md - - how-tos/persistence.ipynb - - Memory: - - Overview: concepts/memory.md - - Manage memory: how-tos/memory.ipynb - - Human-in-the-loop: - - Overview: concepts/human_in_the_loop.md - - how-tos/human_in_the_loop/add-human-in-the-loop.md - - Breakpoints: - - Overview: concepts/breakpoints.md - - how-tos/human_in_the_loop/breakpoints.ipynb - - Time travel: - - Overview: concepts/time-travel.md - - how-tos/human_in_the_loop/time-travel.ipynb - - Tools: - - Overview: concepts/tools.md - - how-tos/tool-calling.ipynb - - Subgraphs: - - Overview: concepts/subgraphs.md - - how-tos/subgraph.ipynb - - Multi-agent: - - Overview: concepts/multi_agent.md - - how-tos/multi_agent.ipynb - - Functional API: - - Overview: concepts/functional_api.md - - how-tos/use-functional-api.md - - - LangGraph Platform: - - Overview: concepts/langgraph_platform.md - - Get started: - - Quickstart: tutorials/langgraph-platform/local-server.md - - Deployment quickstart: cloud/quick_start.md - - Components: - - Overview: concepts/langgraph_components.md - - LangGraph Server: - - Overview: concepts/langgraph_server.md - - Application structure: - - Overview: concepts/application_structure.md - - cloud/deployment/setup.md - - cloud/deployment/setup_pyproject.md - - cloud/deployment/setup_javascript.md - - cloud/deployment/custom_docker.md - - LangGraph CLI: concepts/langgraph_cli.md - - LangGraph Studio: - - Overview: concepts/langgraph_studio.md - - Quickstart: cloud/how-tos/studio/quick_start.md - - cloud/how-tos/invoke_studio.md - - cloud/how-tos/studio/manage_assistants.md - - cloud/how-tos/threads_studio.md - - cloud/how-tos/iterate_graph_studio.md - - cloud/how-tos/clone_traces_studio.md - - cloud/how-tos/datasets_studio.md - - LangGraph SDK: concepts/sdk.md - - Data management: - - Add semantic search: cloud/deployment/semantic_search.md - - Add TTLs: how-tos/ttl/configure_ttl.md - - Authentication & access control: - - Overview: concepts/auth.md - - how-tos/auth/custom_auth.md - - how-tos/auth/openapi_security.md + - concepts/streaming.md + - cloud/concepts/streaming.md + - Persistence: concepts/persistence.md + - Durable execution: concepts/durable_execution.md + - Memory: concepts/memory.md + - Tools: concepts/tools.md + - Human-in-the-loop: concepts/human_in_the_loop.md + - Breakpoints: concepts/breakpoints.md + - Time travel: concepts/time-travel.md + - Multi-agent: concepts/multi_agent.md + - Commercial-only capabilities: + - Authentication & access control: concepts/auth.md - Assistants: - Overview: concepts/assistants.md - - cloud/how-tos/configuration_cloud.md - - Threads: - - Overview: cloud/concepts/threads.md - - cloud/how-tos/use_threads.md - - Runs: - - Overview: cloud/concepts/runs.md - - cloud/how-tos/background_run.md - - cloud/how-tos/same-thread.md - - cloud/how-tos/cron_jobs.md - - cloud/how-tos/stateless_runs.md - - cloud/how-tos/configurable_headers.md - - Streaming: - - Overview: cloud/concepts/streaming.md - - cloud/how-tos/streaming.md - - Human-in-the-loop: cloud/how-tos/add-human-in-the-loop.md - - Breakpoints: cloud/how-tos/human_in_the_loop_breakpoint.md - - Time travel: cloud/how-tos/human_in_the_loop_time_travel.md - - MCP: concepts/server-mcp.md - - Double-texting: - - Overview: concepts/double_texting.md - - cloud/how-tos/interrupt_concurrent.md - - cloud/how-tos/rollback_concurrent.md - - cloud/how-tos/reject_concurrent.md - - cloud/how-tos/enqueue_concurrent.md - - Webhooks: - - Overview: cloud/concepts/webhooks.md - - cloud/how-tos/webhooks.md - - Cron jobs: - - Overview: cloud/concepts/cron_jobs.md - - cloud/how-tos/cron_jobs.md - - Server customization: - - how-tos/http/custom_lifespan.md - - how-tos/http/custom_middleware.md - - how-tos/http/custom_routes.md + - Threads: cloud/concepts/threads.md + - Runs: cloud/concepts/runs.md + - Double-texting: concepts/double_texting.md + - Webhooks: cloud/concepts/webhooks.md + - Cron jobs: cloud/concepts/cron_jobs.md - Deployment: - Overview: concepts/deployment_options.md - Data plane: concepts/langgraph_data_plane.md - Control plane: concepts/langgraph_control_plane.md - Deployment options: - - Cloud SaaS: - - Overview: concepts/langgraph_cloud.md - - Deploy Cloud SaaS: cloud/deployment/cloud.md - - Self-Hosted Data Plane: - - Overview: concepts/langgraph_self_hosted_data_plane.md - - Deploy Self-Hosted Data Plane: cloud/deployment/self_hosted_data_plane.md - - Self-Hosted Control Plane: - - Overview: concepts/langgraph_self_hosted_control_plane.md - - Deploy Self-Hosted Control Plane: cloud/deployment/self_hosted_control_plane.md - - Standalone Container: - - Overview: concepts/langgraph_standalone_container.md - - Deploy Standalone Container: cloud/deployment/standalone_container.md - - Scalability & resilience: concepts/scalability_and_resilience.md - - Plans & pricing: concepts/plans.md - + - Cloud SaaS: concepts/langgraph_cloud.md + - Self-Hosted Data Plane: concepts/langgraph_self_hosted_data_plane.md + - Self-Hosted Control Plane: concepts/langgraph_self_hosted_control_plane.md + - Standalone Container: concepts/langgraph_standalone_container.md + - LangGraph Platform: + - Overview: concepts/langgraph_platform.md + - Components: + - Overview: concepts/langgraph_components.md + - LangGraph Server: concepts/langgraph_server.md + - LangGraph CLI: concepts/langgraph_cli.md + - LangGraph Studio: concepts/langgraph_studio.md + - LangGraph SDK: concepts/sdk.md + - Plans & pricing: concepts/plans.md + - Application structure: concepts/application_structure.md + - Scalability & resilience: concepts/scalability_and_resilience.md + + - Guides: + - Prebuilt agents: + - agents/run_agents.md + - LangGraph APIs: + - Use the Graph API: how-tos/graph-api.ipynb + - Use the Functional API: how-tos/use-functional-api.md + - Models: + - Basic implementation: agents/models.md + - Streaming: + - Basic implementation: agents/streaming.md + - Custom implementation: how-tos/streaming.md + - Production-ready implementation: cloud/how-tos/streaming.md + - Persistence: how-tos/persistence.ipynb + - Context: + - Basic implementation: agents/context.md + - Memory: + - Basic implementation: agents/memory.md + - Custom implementation: how-tos/memory.ipynb + - Human-in-the-loop: + - Basic implementation: agents/human-in-the-loop.md + - Custom implementation: how-tos/human_in_the_loop/add-human-in-the-loop.md + - Production-ready implementation: + - cloud/how-tos/add-human-in-the-loop.md + - cloud/how-tos/human_in_the_loop_time_travel.md + - Breakpoints: + - Custom implementation: how-tos/human_in_the_loop/breakpoints.ipynb + - Production-ready implementation: cloud/how-tos/human_in_the_loop_breakpoint.md + - Tools: + - Basic implementation: agents/tools.md + - Custom implementation: how-tos/tool-calling.ipynb + - Subgraphs: how-tos/subgraph.ipynb + - Multi-agent: + - Basic implementation: agents/multi-agent.md + - Custom implementation: how-tos/multi_agent.ipynb + - MCP: + - Basic implementation: agents/mcp.md + - Production-ready implementation: concepts/server-mcp.md + - Deployment: + - Basic deployment: agents/deployment.md + - Deploy to production: + - Cloud SaaS: cloud/deployment/cloud.md + - Self-Hosted Data Plane: cloud/deployment/self_hosted_data_plane.md + - Self-Hosted Control Plane: cloud/deployment/self_hosted_control_plane.md + - Standalone Container: cloud/deployment/standalone_container.md + - Evaluation: + - Basic implementation: agents/evals.md + - Commercial-only capabilities: + - LangGraph Studio: + - Quickstart: cloud/how-tos/studio/quick_start.md + - cloud/how-tos/invoke_studio.md + - cloud/how-tos/studio/manage_assistants.md + - cloud/how-tos/threads_studio.md + - cloud/how-tos/iterate_graph_studio.md + - cloud/how-tos/clone_traces_studio.md + - cloud/how-tos/datasets_studio.md + - Authentication & access control: + - how-tos/auth/custom_auth.md + - how-tos/auth/openapi_security.md + - Assistants: + - cloud/how-tos/configuration_cloud.md + - Threads: cloud/how-tos/use_threads.md + - Runs: + - cloud/how-tos/background_run.md + - cloud/how-tos/same-thread.md + - cloud/how-tos/cron_jobs.md + - cloud/how-tos/stateless_runs.md + - cloud/how-tos/configurable_headers.md + - Double-texting: + - cloud/how-tos/interrupt_concurrent.md + - cloud/how-tos/rollback_concurrent.md + - cloud/how-tos/reject_concurrent.md + - cloud/how-tos/enqueue_concurrent.md + - Webhooks: cloud/how-tos/webhooks.md + - Cron jobs: cloud/how-tos/cron_jobs.md + - Server customization: + - how-tos/http/custom_lifespan.md + - how-tos/http/custom_middleware.md + - how-tos/http/custom_routes.md + - Data management: + - Add semantic search: cloud/deployment/semantic_search.md + - Add TTLs: how-tos/ttl/configure_ttl.md + - Reference: - reference/index.md - LangGraph: @@ -273,9 +262,19 @@ nav: - Environment variables: cloud/reference/env_var.md - Examples: + - LangGraph basics: + - concepts/why-langgraph.md + - Build a basic chatbot: tutorials/get-started/1-build-basic-chatbot.md + - tutorials/get-started/2-add-tools.md + - tutorials/get-started/3-add-memory.md + - Add human-in-the-loop: tutorials/get-started/4-human-in-the-loop.md + - tutorials/get-started/5-customize-state.md + - tutorials/get-started/6-time-travel.md + - Template applications: concepts/template_applications.md # TODO: make tutorial - Agentic RAG: tutorials/rag/langgraph_agentic_rag.ipynb - Agent Supervisor: tutorials/multi_agent/agent_supervisor.ipynb - SQL agent: tutorials/sql-agent.ipynb + - Prebuilt chat UI: agents/ui.md - Graph runs in LangSmith: how-tos/run-id-langsmith.ipynb - LangGraph Platform: - Authentication: @@ -290,11 +289,12 @@ nav: - Integrate LangGraph into a React app: cloud/how-tos/use_stream_react.md - Implement generative UI with LangGraph: cloud/how-tos/generative_ui_react.md - - Resources: - - concepts/faq.md - - Template applications: concepts/template_applications.md # TODO: make tutorial - - llms.txt: llms-txt-overview.md + - Additional resources: - agents/prebuilt.md # NOTE: prebuilt.md is auto-generated by `make build-prebuilt` + - LangGraph Academy course: https://academy.langchain.com/courses/intro-to-langgraph + - Case studies: adopters.md + - concepts/faq.md + - llms.txt: llms-txt-overview.md - Troubleshooting: - Errors: - troubleshooting/errors/index.md @@ -305,9 +305,7 @@ nav: - troubleshooting/errors/INVALID_CHAT_HISTORY.md - troubleshooting/errors/INVALID_LICENSE.md - LangGraph Studio: troubleshooting/studio.md - - Learn: - - LangGraph Academy course: https://academy.langchain.com/courses/intro-to-langgraph - - Case studies: adopters.md + markdown_extensions: - abbr diff --git a/docs/uv.lock b/docs/uv.lock index d284ffa35..bcb28e07a 100644 --- a/docs/uv.lock +++ b/docs/uv.lock @@ -2660,6 +2660,8 @@ dev = [ { name = "dataclasses-json" }, { name = "mypy" }, { name = "numpy" }, + { name = "pandas" }, + { name = "pandas-stubs", specifier = ">=2.2.2.240807" }, { name = "pytest" }, { name = "pytest-asyncio" }, { name = "pytest-mock" },