diff --git a/docs/docs/agents/deployment.md b/docs/docs/agents/deployment.md index 84880f068..538528549 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 Cloud or self-hosted options. 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](../tutorials/deployment.md) for detailed instructions on all supported deployment models. diff --git a/docs/docs/agents/ui.md b/docs/docs/agents/ui.md index 8ccb8e772..29a8e7cc4 100644 --- a/docs/docs/agents/ui.md +++ b/docs/docs/agents/ui.md @@ -13,7 +13,7 @@ You can use a prebuilt chat UI for interacting with any LangGraph agent through ## Run agent in UI -First, set up LangGraph API server [locally](./deployment.md#launch-langgraph-server-locally) or deploy your agent on [LangGraph Cloud](https://langchain-ai.github.io/langgraph/cloud/quick_start/). +First, set up LangGraph API server [locally](./deployment.md#launch-langgraph-server-locally) or deploy your agent on [LangGraph Platform](https://langchain-ai.github.io/langgraph/cloud/quick_start/). Then, navigate to [Agent Chat UI](https://agentchat.vercel.app), or clone the repository and [run the dev server locally](https://github.com/langchain-ai/agent-chat-ui?tab=readme-ov-file#setup): diff --git a/docs/docs/cloud/concepts/cron_jobs.md b/docs/docs/cloud/concepts/cron_jobs.md index 9431ed8b2..2c97cd9c4 100644 --- a/docs/docs/cloud/concepts/cron_jobs.md +++ b/docs/docs/cloud/concepts/cron_jobs.md @@ -5,11 +5,11 @@ There are many situations in which it is useful to run an assistant on a schedul For example, say that you're building an assistant that runs daily and sends an email summary of the day's news. You could use a cron job to run the assistant every day at 8:00 PM. -LangGraph Cloud supports cron jobs, which run on a user-defined schedule. The user specifies a schedule, an assistant, and some input. After that, on the specified schedule, the server will: +LangGraph Platform supports cron jobs, which run on a user-defined schedule. The user specifies a schedule, an assistant, and some input. After that, on the specified schedule, the server will: - Create a new thread with the specified assistant - Send the specified input to that thread Note that this sends the same input to the thread every time. See the [how-to guide](../../cloud/how-tos/cron_jobs.md) for creating cron jobs. -The LangGraph Cloud API provides several endpoints for creating and managing cron jobs. See the [API reference](../../cloud/reference/api/api_ref.html#tag/runscreate/POST/threads/{thread_id}/runs/crons) for more details. \ No newline at end of file +The LangGraph Platform API provides several endpoints for creating and managing cron jobs. See the [API reference](../../cloud/reference/api/api_ref.html#tag/runscreate/POST/threads/{thread_id}/runs/crons) for more details. \ No newline at end of file diff --git a/docs/docs/cloud/concepts/runs.md b/docs/docs/cloud/concepts/runs.md index b1764f7f4..d1957fc46 100644 --- a/docs/docs/cloud/concepts/runs.md +++ b/docs/docs/cloud/concepts/runs.md @@ -2,4 +2,4 @@ A run is an invocation of an [assistant](../../concepts/assistants.md). Each run may have its own input, configuration, and metadata, which may affect execution and output of the underlying graph. A run can optionally be executed on a [thread](./threads.md). -The LangGraph Cloud API provides several endpoints for creating and managing runs. See the [API reference](../../cloud/reference/api/api_ref.html#tag/thread-runs/) for more details. \ No newline at end of file +The LangGraph Platform API provides several endpoints for creating and managing runs. See the [API reference](../../cloud/reference/api/api_ref.html#tag/thread-runs/) for more details. \ No newline at end of file diff --git a/docs/docs/cloud/concepts/threads.md b/docs/docs/cloud/concepts/threads.md index 0d4fc5965..2eda27c91 100644 --- a/docs/docs/cloud/concepts/threads.md +++ b/docs/docs/cloud/concepts/threads.md @@ -8,4 +8,4 @@ The state of a thread at a particular point in time is called a [checkpoint](../ For more on threads and checkpoints, see this section of the [LangGraph conceptual guide](../../concepts/persistence.md). -The LangGraph Cloud API provides several endpoints for creating and managing threads and thread state. See the [API reference](../../cloud/reference/api/api_ref.html#tag/threads) for more details. \ No newline at end of file +The LangGraph Platform API provides several endpoints for creating and managing threads and thread state. See the [API reference](../../cloud/reference/api/api_ref.html#tag/threads) for more details. \ No newline at end of file diff --git a/docs/docs/cloud/concepts/webhooks.md b/docs/docs/cloud/concepts/webhooks.md index 206b97006..cdbdc474e 100644 --- a/docs/docs/cloud/concepts/webhooks.md +++ b/docs/docs/cloud/concepts/webhooks.md @@ -1,7 +1,7 @@ # Webhooks -Webhooks enable event-driven communication from your LangGraph Cloud application to external services. For example, you may want to issue an update to a separate service once an API call to LangGraph Cloud has finished running. +Webhooks enable event-driven communication from your LangGraph Platform application to external services. For example, you may want to issue an update to a separate service once an API call to LangGraph Platform has finished running. -Many LangGraph Cloud endpoints accept a `webhook` parameter. If this parameter is specified by a an endpoint that can accept POST requests, LangGraph Cloud will send a request at the completion of a run. +Many LangGraph Platform endpoints accept a `webhook` parameter. If this parameter is specified by a an endpoint that can accept POST requests, LangGraph Platform will send a request at the completion of a run. See the corresponding [how-to guide](../../cloud/how-tos/webhooks.md) for more detail. \ No newline at end of file diff --git a/docs/docs/cloud/deployment/cloud.md b/docs/docs/cloud/deployment/cloud.md index aba1122d8..8dfe00a40 100644 --- a/docs/docs/cloud/deployment/cloud.md +++ b/docs/docs/cloud/deployment/cloud.md @@ -4,14 +4,14 @@ Before deploying, review the [conceptual guide for the Cloud SaaS](../../concept ## Prerequisites -1. LangGraph Cloud applications are deployed from GitHub repositories. Configure and upload a LangGraph Cloud application to a GitHub repository in order to deploy it to LangGraph Cloud. -1. [Verify that the LangGraph API runs locally](../../tutorials/langgraph-platform/local-server.md). If the API does not run successfully (i.e. `langgraph dev`), deploying to LangGraph Cloud will fail as well. +1. LangGraph Platform applications are deployed from GitHub repositories. Configure and upload a LangGraph Platform application to a GitHub repository in order to deploy it to LangGraph Platform. +1. [Verify that the LangGraph API runs locally](../../tutorials/langgraph-platform/local-server.md). If the API does not run successfully (i.e. `langgraph dev`), deploying to LangGraph Platform will fail as well. ## Create New Deployment Starting from the LangSmith UI... -1. In the left-hand navigation panel, select `LangGraph Platform`. The `LangGraph Platform` view contains a list of existing LangGraph Cloud deployments. +1. In the left-hand navigation panel, select `LangGraph Platform`. The `LangGraph Platform` view contains a list of existing LangGraph Platform deployments. 1. In the top-right corner, select `+ New Deployment` to create a new deployment. 1. In the `Create New Deployment` panel, fill out the required fields. 1. `Deployment details` @@ -38,7 +38,7 @@ When [creating a new deployment](#create-new-deployment), a new revision is crea Starting from the LangSmith UI... -1. In the left-hand navigation panel, select `LangGraph Platform`. The `LangGraph Platform` view contains a list of existing LangGraph Cloud deployments. +1. In the left-hand navigation panel, select `LangGraph Platform`. The `LangGraph Platform` view contains a list of existing LangGraph Platform deployments. 1. Select an existing deployment to create a new revision for. 1. In the `Deployment` view, in the top-right corner, select `+ New Revision`. 1. In the `New Revision` modal, fill out the required fields. @@ -79,7 +79,7 @@ Starting from the `LangGraph Platform` view... Starting from the LangSmith UI... -1. In the left-hand navigation panel, select `LangGraph Platform`. The `LangGraph Platform` view contains a list of existing LangGraph Cloud deployments. +1. In the left-hand navigation panel, select `LangGraph Platform`. The `LangGraph Platform` view contains a list of existing LangGraph Platform deployments. 1. Select the menu icon (three dots) on the right-hand side of the row for the desired deployment and select `Delete`. 1. A `Confirmation` modal will appear. Select `Delete`. diff --git a/docs/docs/cloud/deployment/setup.md b/docs/docs/cloud/deployment/setup.md index 22c4fc43c..a2e4e3ea9 100644 --- a/docs/docs/cloud/deployment/setup.md +++ b/docs/docs/cloud/deployment/setup.md @@ -1,11 +1,11 @@ # How to Set Up a LangGraph Application with requirements.txt -A LangGraph application must be configured with a [LangGraph configuration file](../reference/cli.md#configuration-file) in order to be deployed to LangGraph Cloud (or to be self-hosted). This how-to guide discusses the basic steps to setup a LangGraph application for deployment using `requirements.txt` to specify project dependencies. +A LangGraph application must be configured with a [LangGraph configuration file](../reference/cli.md#configuration-file) in order to be deployed to LangGraph Platform (or to be self-hosted). This how-to guide discusses the basic steps to setup a LangGraph application for deployment using `requirements.txt` to specify project dependencies. This walkthrough is based on [this repository](https://github.com/langchain-ai/langgraph-example), which you can play around with to learn more about how to setup your LangGraph application for deployment. !!! tip "Setup with pyproject.toml" - If you prefer using poetry for dependency management, check out [this how-to guide](./setup_pyproject.md) on using `pyproject.toml` for LangGraph Cloud. + If you prefer using poetry for dependency management, check out [this how-to guide](./setup_pyproject.md) on using `pyproject.toml` for LangGraph Platform. !!! tip "Setup with a Monorepo" If you are interested in deploying a graph located inside a monorepo, take a look at [this repository](https://github.com/langchain-ai/langgraph-example-monorepo) for an example of how to do so. @@ -130,7 +130,7 @@ graph = workflow.compile() ``` !!! warning "Assign `CompiledGraph` to Variable" - The build process for LangGraph Cloud requires that the `CompiledGraph` object be assigned to a variable at the top-level of a Python module (alternatively, you can provide [a function that creates a graph](./graph_rebuild.md)). + The build process for LangGraph Platform requires that the `CompiledGraph` object be assigned to a variable at the top-level of a Python module (alternatively, you can provide [a function that creates a graph](./graph_rebuild.md)). Example file directory: diff --git a/docs/docs/cloud/deployment/setup_javascript.md b/docs/docs/cloud/deployment/setup_javascript.md index aefc7bdb5..04afa0f34 100644 --- a/docs/docs/cloud/deployment/setup_javascript.md +++ b/docs/docs/cloud/deployment/setup_javascript.md @@ -1,6 +1,6 @@ # How to Set Up a LangGraph.js Application -A [LangGraph.js](https://langchain-ai.github.io/langgraphjs/) application must be configured with a [LangGraph configuration file](../reference/cli.md#configuration-file) in order to be deployed to LangGraph Cloud (or to be self-hosted). This how-to guide discusses the basic steps to setup a LangGraph.js application for deployment using `package.json` to specify project dependencies. +A [LangGraph.js](https://langchain-ai.github.io/langgraphjs/) application must be configured with a [LangGraph configuration file](../reference/cli.md#configuration-file) in order to be deployed to LangGraph Platform (or to be self-hosted). This how-to guide discusses the basic steps to setup a LangGraph.js application for deployment using `package.json` to specify project dependencies. This walkthrough is based on [this repository](https://github.com/langchain-ai/langgraphjs-studio-starter), which you can play around with to learn more about how to setup your LangGraph application for deployment. @@ -157,7 +157,7 @@ export const graph = workflow.compile(); !!! info "Assign `CompiledGraph` to Variable" - The build process for LangGraph Cloud requires that the `CompiledGraph` object be assigned to a variable at the top-level of a JavaScript module (alternatively, you can provide [a function that creates a graph](./graph_rebuild.md)). + The build process for LangGraph Platform requires that the `CompiledGraph` object be assigned to a variable at the top-level of a JavaScript module (alternatively, you can provide [a function that creates a graph](./graph_rebuild.md)). Example file directory: diff --git a/docs/docs/cloud/deployment/setup_pyproject.md b/docs/docs/cloud/deployment/setup_pyproject.md index 3e9a6d35a..f0ed1d704 100644 --- a/docs/docs/cloud/deployment/setup_pyproject.md +++ b/docs/docs/cloud/deployment/setup_pyproject.md @@ -1,6 +1,6 @@ # How to Set Up a LangGraph Application with pyproject.toml -A LangGraph application must be configured with a [LangGraph configuration file](../reference/cli.md#configuration-file) in order to be deployed to LangGraph Cloud (or to be self-hosted). This how-to guide discusses the basic steps to setup a LangGraph application for deployment using `pyproject.toml` to define your package's dependencies. +A LangGraph application must be configured with a [LangGraph configuration file](../reference/cli.md#configuration-file) in order to be deployed to LangGraph Platform (or to be self-hosted). This how-to guide discusses the basic steps to setup a LangGraph application for deployment using `pyproject.toml` to define your package's dependencies. This walkthrough is based on [this repository](https://github.com/langchain-ai/langgraph-example-pyproject), which you can play around with to learn more about how to setup your LangGraph application for deployment. @@ -59,7 +59,7 @@ Example `pyproject.toml` file: [tool.poetry] name = "my-agent" version = "0.0.1" -description = "An excellent agent build for LangGraph cloud." +description = "An excellent agent build for LangGraph Platform." authors = ["Polly the parrot <1223+polly@users.noreply.github.com>"] license = "MIT" readme = "README.md" @@ -138,7 +138,7 @@ graph = workflow.compile() ``` !!! warning "Assign `CompiledGraph` to Variable" - The build process for LangGraph Cloud requires that the `CompiledGraph` object be assigned to a variable at the top-level of a Python module. + The build process for LangGraph Platform requires that the `CompiledGraph` object be assigned to a variable at the top-level of a Python module. Example file directory: diff --git a/docs/docs/cloud/how-tos/cron_jobs.md b/docs/docs/cloud/how-tos/cron_jobs.md index f787c8b9c..72205e46d 100644 --- a/docs/docs/cloud/how-tos/cron_jobs.md +++ b/docs/docs/cloud/how-tos/cron_jobs.md @@ -1,6 +1,6 @@ # Cron Jobs -Sometimes you don't want to run your graph based on user interaction, but rather you would like to schedule your graph to run on a schedule - for example if you wish for your graph to compose and send out a weekly email of to-dos for your team. LangGraph Cloud allows you to do this without having to write your own script by using the `Crons` client. To schedule a graph job, you need to pass a [cron expression](https://crontab.cronhub.io/) to inform the client when you want to run the graph. `Cron` jobs are run in the background and do not interfere with normal invocations of the graph. +Sometimes you don't want to run your graph based on user interaction, but rather you would like to schedule your graph to run on a schedule - for example if you wish for your graph to compose and send out a weekly email of to-dos for your team. LangGraph Platform allows you to do this without having to write your own script by using the `Crons` client. To schedule a graph job, you need to pass a [cron expression](https://crontab.cronhub.io/) to inform the client when you want to run the graph. `Cron` jobs are run in the background and do not interfere with normal invocations of the graph. ## Setup diff --git a/docs/docs/cloud/how-tos/human_in_the_loop_time_travel.md b/docs/docs/cloud/how-tos/human_in_the_loop_time_travel.md index 63c2c95bb..3d87d4dd3 100644 --- a/docs/docs/cloud/how-tos/human_in_the_loop_time_travel.md +++ b/docs/docs/cloud/how-tos/human_in_the_loop_time_travel.md @@ -1,10 +1,10 @@ # How to Replay and Branch from Prior States -With LangGraph Cloud you have the ability to return to any of your prior states and either re-run the graph to reproduce issues noticed during testing, or branch out in a different way from what was originally done in the prior states. In this guide we will show a quick example of how to rerun past states and how to branch off from previous states as well. +With LangGraph Platform you have the ability to return to any of your prior states and either re-run the graph to reproduce issues noticed during testing, or branch out in a different way from what was originally done in the prior states. In this guide we will show a quick example of how to rerun past states and how to branch off from previous states as well. ## Setup -The examples below are executed against a specific deployment on LangGraph Cloud. You will use +The examples below are executed against a specific deployment on LangGraph Platform. You will use the SDK in a similar way, but you will expect to see different results based on the graph you have deployed. ### SDK initialization diff --git a/docs/docs/cloud/how-tos/same-thread.md b/docs/docs/cloud/how-tos/same-thread.md index 79fc63313..643389e1b 100644 --- a/docs/docs/cloud/how-tos/same-thread.md +++ b/docs/docs/cloud/how-tos/same-thread.md @@ -1,6 +1,6 @@ # How to run multiple agents on the same thread -In LangGraph Cloud, a thread is not explicitly associated with a particular agent. +In LangGraph Platform, a thread is not explicitly associated with a particular agent. This means that you can run multiple agents on the same thread, which allows a different agent to continue from an initial agent's progress. In this example, we will create two agents and then call them both on the same thread. diff --git a/docs/docs/cloud/how-tos/stateless_runs.md b/docs/docs/cloud/how-tos/stateless_runs.md index 810fe7e39..e1d45516c 100644 --- a/docs/docs/cloud/how-tos/stateless_runs.md +++ b/docs/docs/cloud/how-tos/stateless_runs.md @@ -1,6 +1,6 @@ # Stateless Runs -Most of the time, you provide a `thread_id` to your client when you run your graph in order to keep track of prior runs through the persistent state implemented in LangGraph Cloud. However, if you don't need to persist the runs you don't need to use the built in persistent state and can create stateless runs. +Most of the time, you provide a `thread_id` to your client when you run your graph in order to keep track of prior runs through the persistent state implemented in LangGraph Platform. However, if you don't need to persist the runs you don't need to use the built in persistent state and can create stateless runs. ## Setup diff --git a/docs/docs/cloud/how-tos/webhooks.md b/docs/docs/cloud/how-tos/webhooks.md index f8d7809a3..cb32da710 100644 --- a/docs/docs/cloud/how-tos/webhooks.md +++ b/docs/docs/cloud/how-tos/webhooks.md @@ -1,6 +1,6 @@ # Using Webhooks -When working with LangGraph Cloud, you may want to use webhooks to receive updates after an API call completes. Webhooks are useful for triggering actions in your service once a run has finished processing. To implement this, you need to expose an endpoint that can accept `POST` requests and pass this endpoint as a `webhook` parameter in your API request. +When working with LangGraph Platform, you may want to use webhooks to receive updates after an API call completes. Webhooks are useful for triggering actions in your service once a run has finished processing. To implement this, you need to expose an endpoint that can accept `POST` requests and pass this endpoint as a `webhook` parameter in your API request. Currently, the SDK does not provide built-in support for defining webhook endpoints, but you can specify them manually using API requests. @@ -71,7 +71,7 @@ curl --request POST \ ## Using a Webhook with a Graph Run -To use a webhook, specify the `webhook` parameter in your API request. When the run completes, LangGraph Cloud sends a `POST` request to the specified webhook URL. +To use a webhook, specify the `webhook` parameter in your API request. When the run completes, LangGraph Platform sends a `POST` request to the specified webhook URL. For example, if your server listens for webhook events at `https://my-server.app/my-webhook-endpoint`, include this in your request: @@ -121,7 +121,7 @@ curl --request POST \ ## Webhook Payload -LangGraph Cloud sends webhook notifications in the format of a [Run](../../cloud/concepts/runs.md). See the [API Reference](https://langchain-ai.github.io/langgraph/cloud/reference/api/api_ref.html#model/run) for details. The request payload includes run input, configuration, and other metadata in the `kwargs` field. +LangGraph Platform sends webhook notifications in the format of a [Run](../../cloud/concepts/runs.md). See the [API Reference](https://langchain-ai.github.io/langgraph/cloud/reference/api/api_ref.html#model/run) for details. The request payload includes run input, configuration, and other metadata in the `kwargs` field. ## Securing Webhooks @@ -140,8 +140,8 @@ You can test your webhook using online services like: - **[Beeceptor](https://beeceptor.com/)** – Quickly create a test endpoint and inspect incoming webhook payloads. - **[Webhook.site](https://webhook.site/)** – View, debug, and log incoming webhook requests in real time. -These tools help you verify that LangGraph Cloud is correctly triggering and sending webhooks to your service. +These tools help you verify that LangGraph Platform is correctly triggering and sending webhooks to your service. --- -By following these steps, you can integrate webhooks into your LangGraph Cloud workflow, automating actions based on completed runs. +By following these steps, you can integrate webhooks into your LangGraph Platform workflow, automating actions based on completed runs. diff --git a/docs/docs/cloud/quick_start.md b/docs/docs/cloud/quick_start.md index 87967e147..b51d21720 100644 --- a/docs/docs/cloud/quick_start.md +++ b/docs/docs/cloud/quick_start.md @@ -16,7 +16,7 @@ This quickstart uses the [pre-built Python ReAct agent template](https://github. ## 1. Create a repository on GitHub -To deploy a LangGraph application to **LangGraph Cloud**, your application code must reside in a GitHub repository. Both public and private repositories are supported. For this quickstart, use the [pre-built Python ReAct agent template](https://github.com/langchain-ai/react-agent) for your application: +To deploy a LangGraph application to **LangGraph Platform**, your application code must reside in a GitHub repository. Both public and private repositories are supported. For this quickstart, use the [pre-built Python ReAct agent template](https://github.com/langchain-ai/react-agent) for your application: 1. Go to the [ReAct Agent](https://github.com/langchain-ai/react-agent) repository. 1. Click the `Fork` button in the top right corner to fork the repository to your GitHub account. diff --git a/docs/docs/cloud/reference/api/api_ref.html b/docs/docs/cloud/reference/api/api_ref.html index 9492f411a..46c39948b 100644 --- a/docs/docs/cloud/reference/api/api_ref.html +++ b/docs/docs/cloud/reference/api/api_ref.html @@ -1,7 +1,7 @@
-