Skip to content

Commit 44bfc4b

Browse files
committed
LangGraph Server --> Agent Server
1 parent 31a26de commit 44bfc4b

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+214
-206
lines changed

src/docs.json

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -865,7 +865,7 @@
865865
{
866866
"group": "Releases & changelogs",
867867
"pages": [
868-
"langsmith/langgraph-server-changelog",
868+
"langsmith/agent-server-changelog",
869869
"langsmith/release-versions"
870870
]
871871
},
@@ -1187,7 +1187,7 @@
11871187
"group": "Deployment components",
11881188
"pages": [
11891189
"langsmith/components",
1190-
"langsmith/langgraph-server",
1190+
"langsmith/agent-server",
11911191
"langsmith/data-plane",
11921192
"langsmith/control-plane"
11931193
]
@@ -1670,6 +1670,14 @@
16701670
{
16711671
"source": "oss/javascript/langchain/OUTPUT_PARSING_FAILURE",
16721672
"destination": "oss/javascript/langchain/errors/OUTPUT_PARSING_FAILURE"
1673+
},
1674+
{
1675+
"source": "/langsmith/langgraph-server",
1676+
"destination": "/langsmith/agent-server"
1677+
},
1678+
{
1679+
"source": "/langsmith/langgraph-server-changelog",
1680+
"destination": "/langsmith/agent-server-changelog"
16731681
}
16741682
]
16751683
}

src/langsmith/add-auth-server.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -270,7 +270,7 @@ You've successfully built a production-ready authentication system for your Lang
270270
271271
1. Set up an authentication provider (Supabase in this case)
272272
2. Added real user accounts with email/password authentication
273-
3. Integrated JWT token validation into your LangGraph server
273+
3. Integrated JWT token validation into your Agent Server
274274
4. Implemented proper authorization to ensure users can only access their own data
275275
5. Created a foundation that's ready to handle your next authentication challenge 🚀
276276

src/langsmith/add-human-in-the-loop.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ To review, edit, and approve tool calls in an agent or workflow, use LangGraph's
133133
</Tabs>
134134

135135
<Accordion title="Extended example: using `interrupt`">
136-
This is an example graph you can run in the LangGraph API server.
136+
This is an example graph you can run in the Agent Server.
137137
See [LangSmith quickstart](/langsmith/deployment-quickstart) for more details.
138138

139139
```python {highlight={7,13}}
@@ -171,7 +171,7 @@ To review, edit, and approve tool calls in an agent or workflow, use LangGraph's
171171
2. Any JSON serializable value can be passed to the @[`interrupt`] function. Here, a dict containing the text to revise.
172172
3. Once resumed, the return value of `interrupt(...)` is the human-provided input, which is used to update the state.
173173

174-
Once you have a running LangGraph API server, you can interact with it using
174+
Once you have a running Agent Server, you can interact with it using
175175
[LangGraph SDK](/langsmith/langgraph-python-sdk)
176176

177177
<Tabs>

src/langsmith/langgraph-server-changelog.mdx renamed to src/langsmith/agent-server-changelog.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: LangGraph Server changelog
3-
sidebarTitle: LangGraph Server changelog
2+
title: Agent Server changelog
3+
sidebarTitle: Agent Server changelog
44
---
55

6-
[LangGraph Server](/langsmith/langgraph-server) is an API platform for creating and managing agent-based applications. It provides built-in persistence, a task queue, and supports deploying, configuring, and running assistants (agentic workflows) at scale. This changelog documents all notable updates, features, and fixes to LangGraph Server releases.
6+
[Agent Server](/langsmith/agent-server) is an API platform for creating and managing agent-based applications. It provides built-in persistence, a task queue, and supports deploying, configuring, and running assistants (agentic workflows) at scale. This changelog documents all notable updates, features, and fixes to Agent Server releases.
77

88
<a id="2025-10-31"></a>
99
## v0.5.0

src/langsmith/agent-server.mdx

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: Agent Server
3+
---
4+
5+
LangSmith Deployment's **Agent Server** offers an API for creating and managing agent-based applications. It is built on the concept of [assistants](/langsmith/assistants), which are agents configured for specific tasks, and includes built-in [persistence](/oss/langgraph/persistence#memory-store) and a **task queue**. This versatile API supports a wide range of agentic application use cases, from background processing to real-time interactions.
6+
7+
Use Agent Server to create and manage [assistants](/langsmith/assistants), [threads](/oss/langgraph/persistence#threads), [runs](/langsmith/assistants#execution), [cron jobs](/langsmith/cron-jobs), [webhooks](/langsmith/use-webhooks), and more.
8+
9+
<Tip>
10+
**API reference**<br></br>
11+
For detailed information on the API endpoints and data models, refer to the [API reference docs](https://langchain-ai.github.io/langgraph/cloud/reference/api/api_ref.html).
12+
</Tip>
13+
14+
To use the Enterprise version of the Agent Server, you must acquire a license key that you will need to specify when running the Docker image. To acquire a license key, [contact our sales team](https://www.langchain.com/contact-sales).
15+
16+
You can run the Enterprise version of the Agent Server on the following LangSmith [platform](/langsmith/platform-setup) options:
17+
18+
- [Cloud](/langsmith/cloud)
19+
- [Hybrid](/langsmith/hybrid)
20+
- [Self-hosted](/langsmith/self-hosted)
21+
22+
## Application structure
23+
24+
To deploy an Agent Server application, you need to specify the graph(s) you want to deploy, as well as any relevant configuration settings, such as dependencies and environment variables.
25+
26+
Read the [application structure](/langsmith/application-structure) guide to learn how to structure your LangGraph application for deployment.
27+
28+
## Parts of a deployment
29+
30+
When you deploy Agent Server, you are deploying one or more [graphs](#graphs), a database for [persistence](/oss/langgraph/persistence), and a task queue.
31+
32+
### Graphs
33+
34+
When you deploy a graph with Agent Server, you are deploying a "blueprint" for an [Assistant](/langsmith/assistants).
35+
36+
An [Assistant](/langsmith/assistants) is a graph paired with specific configuration settings. You can create multiple assistants per graph, each with unique settings to accommodate different use cases
37+
that can be served by the same graph.
38+
39+
Upon deployment, Agent Server will automatically create a default assistant for each graph using the graph's default configuration settings.
40+
41+
<Note>
42+
We often think of a graph as implementing an [agent](/oss/langgraph/workflows-agents), but a graph does not necessarily need to implement an agent. For example, a graph could implement a simple
43+
chatbot that only supports back-and-forth conversation, without the ability to influence any application control flow. In reality, as applications get more complex, a graph will often implement a more complex flow that may use [multiple agents](/oss/langchain/multi-agent) working in tandem.
44+
</Note>
45+
46+
### Persistence and task queue
47+
48+
Agent Server leverages a database for [persistence](/oss/langgraph/persistence) and a task queue.
49+
50+
[PostgreSQL](https://www.postgresql.org/) is supported as a database for Agent Server and [Redis](https://redis.io/) as the task queue.
51+
52+
If you're deploying using [LangSmith cloud](/langsmith/cloud), these components are managed for you. If you're deploying Agent Server on your [own infrastructure](/langsmith/self-hosted), you'll need to set up and manage these components yourself.
53+
54+
For more information on how these components are set up and managed, review the [hosting options](/langsmith/platform-setup) guide.
55+
56+
## Learn more
57+
58+
- [Application Structure](/langsmith/application-structure) guide explains how to structure your application for deployment.
59+
- The [API Reference](https://langchain-ai.github.io/langgraph/cloud/reference/api/api_ref.html) provides detailed information on the API endpoints and data models.

src/langsmith/api-ref-control-plane.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Control plane API reference for LangSmith Deployment
33
sidebarTitle: Control plane API
44
---
55

6-
The control plane API is part of [LangSmith Deployment](/langsmith/deployments). With the control plane API, you can programmatically create, manage, and automate your [LangGraph Server](/langsmith/langgraph-server) deployments—for example, as part of a custom CI/CD workflow.
6+
The control plane API is part of [LangSmith Deployment](/langsmith/deployments). With the control plane API, you can programmatically create, manage, and automate your [Agent Server](/langsmith/agent-server) deployments—for example, as part of a custom CI/CD workflow.
77

88
<Card title="API Reference" href="https://api.host.langchain.com/docs" icon="book">
99
View the full Control Plane API reference documentation

src/langsmith/assistants.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,9 @@ Assistants are a [LangSmith](/langsmith/home) concept. They are not available in
1919

2020
Assistants build on the LangGraph open source concept of [configuration](/oss/langgraph/graph-api#runtime-context).
2121

22-
While configuration is available in the open source LangGraph library, assistants are only present in [LangSmith](/langsmith/home). This is due to the fact that assistants are tightly coupled to your deployed graph. Upon deployment, LangGraph Server will automatically create a default assistant for each graph using the graph's default configuration settings.
22+
While configuration is available in the open source LangGraph library, assistants are only present in [LangSmith](/langsmith/home). This is due to the fact that assistants are tightly coupled to your deployed graph. Upon deployment, Agent Server will automatically create a default assistant for each graph using the graph's default configuration settings.
2323

24-
In practice, an assistant is just an _instance_ of a graph with a specific configuration. Therefore, multiple assistants can reference the same graph but can contain different configurations (e.g. prompts, models, tools). The LangGraph Server API provides several endpoints for creating and managing assistants. See the [API reference](https://langchain-ai.github.io/langgraph/cloud/reference/api/api_ref/) and [this how-to](/langsmith/configuration-cloud) for more details on how to create assistants.
24+
In practice, an assistant is just an _instance_ of a graph with a specific configuration. Therefore, multiple assistants can reference the same graph but can contain different configurations (e.g. prompts, models, tools). The LangSmith Deployment API provides several endpoints for creating and managing assistants. See the [API reference](https://langchain-ai.github.io/langgraph/cloud/reference/api/api_ref/) and [this how-to](/langsmith/configuration-cloud) for more details on how to create assistants.
2525

2626
## Versioning
2727

src/langsmith/cicd-pipeline-example.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ The workflow includes:
9393

9494
![Agent Deployment Revision Workflow](./images/cicd-new-lgp-revision.png)
9595

96-
- **Testing and evaluation workflow**: In addition to the more traditional testing phases (unit tests, integration tests, end-to-end tests, etc.), the pipeline includes [offline evaluations](/langsmith/evaluation-concepts#offline-evaluation) and [LangGraph dev server testing](/langsmith/local-server) because you want to test the quality of your agent. These evaluations provide comprehensive assessment of the agent's performance using real-world scenarios and data.
96+
- **Testing and evaluation workflow**: In addition to the more traditional testing phases (unit tests, integration tests, end-to-end tests, etc.), the pipeline includes [offline evaluations](/langsmith/evaluation-concepts#offline-evaluation) and [Agent dev server testing](/langsmith/local-server) because you want to test the quality of your agent. These evaluations provide comprehensive assessment of the agent's performance using real-world scenarios and data.
9797

9898
![Test with Results Workflow](./images/cicd-test-with-results.png)
9999

@@ -207,12 +207,12 @@ Example `langgraph.json`:
207207

208208
### Local development and testing
209209

210-
![LangGraph Studio CLI Interface](./images/cicd-studio-cli.png)
210+
![Studio CLI Interface](./images/cicd-studio-cli.png)
211211

212212
First, test your agent locally using [Studio](/langsmith/studio):
213213

214214
```bash
215-
# Start local development server with LangGraph Studio
215+
# Start local development server with Studio
216216
langgraph dev
217217
```
218218

src/langsmith/cli.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: LangGraph CLI
33
sidebarTitle: LangGraph CLI
44
---
55

6-
**LangGraph CLI** is a command-line tool for building and running the [LangGraph API server](/langsmith/langgraph-server) locally. The resulting server exposes all API endpoints for runs, threads, assistants, etc., and includes supporting services such as a managed database for checkpointing and storage.
6+
**LangGraph CLI** is a command-line tool for building and running the [Agent Server](/langsmith/agent-server) locally. The resulting server exposes all API endpoints for runs, threads, assistants, etc., and includes supporting services such as a managed database for checkpointing and storage.
77

88
## Installation
99

@@ -74,7 +74,7 @@ The LangGraph CLI requires a JSON configuration file that follows this [schema](
7474
| <span style={{ whiteSpace: "nowrap" }}>`dockerfile_lines`</span> | Array of additional lines to add to Dockerfile following the import from parent image. |
7575
| <span style={{ whiteSpace: "nowrap" }}>`checkpointer`</span> | Configuration for the checkpointer. Contains a `ttl` field which is an object with the following keys: <ul><li>`strategy`: How to handle expired checkpoints (e.g., `"delete"`).</li><li>`sweep_interval_minutes`: How often to check for expired checkpoints (integer).</li><li>`default_ttl`: Default time-to-live for checkpoints in **minutes** (integer); applied to newly created checkpoints/threads only (existing data is unchanged). Defines how long checkpoints are kept before the specified strategy is applied.</li></ul> |
7676
| <span style={{ whiteSpace: "nowrap" }}>`http`</span> | HTTP server configuration with the following fields: <ul><li>`app`: Path to custom Starlette/FastAPI app (e.g., `"./src/agent/webapp.py:app"`). See [custom routes guide](/langsmith/custom-routes).</li><li>`cors`: CORS configuration with fields for `allow_origins`, `allow_methods`, `allow_headers`, etc.</li><li>`configurable_headers`: Define which request headers to exclude or include as a run's configurable values.</li><li>`disable_assistants`: Disable `/assistants` routes</li><li>`disable_mcp`: Disable `/mcp` routes</li><li>`disable_meta`: Disable `/ok`, `/info`, `/metrics`, and `/docs` routes</li><li>`disable_runs`: Disable `/runs` routes</li><li>`disable_store`: Disable `/store` routes</li><li>`disable_threads`: Disable `/threads` routes</li><li>`disable_ui`: Disable `/ui` routes</li><li>`disable_webhooks`: Disable webhooks calls on run completion in all routes</li><li>`mount_prefix`: Prefix for mounted routes (e.g., "/my-deployment/api")</li></ul> |
77-
| <span style={{ whiteSpace: "nowrap" }}>`api_version`</span> | _(Added in v0.3.7)_ Which semantic version of the LangGraph API server to use (e.g., `"0.3"`). Defaults to latest. Check the server [changelog](/langsmith/langgraph-server-changelog) for details on each release. |
77+
| <span style={{ whiteSpace: "nowrap" }}>`api_version`</span> | _(Added in v0.3.7)_ Which semantic version of the LangGraph API server to use (e.g., `"0.3"`). Defaults to latest. Check the server [changelog](/langsmith/agent-server-changelog) for details on each release. |
7878
</Tab>
7979
<Tab title="JS">
8080
| Key | Description |
@@ -85,7 +85,7 @@ The LangGraph CLI requires a JSON configuration file that follows this [schema](
8585
| <span style={{ whiteSpace: "nowrap" }}>`node_version`</span> | Specify `node_version: 20` to use LangGraph.js. |
8686
| <span style={{ whiteSpace: "nowrap" }}>`dockerfile_lines`</span> | Array of additional lines to add to Dockerfile following the import from parent image. |
8787
| <span style={{ whiteSpace: "nowrap" }}>`checkpointer`</span> | Configuration for the checkpointer. Contains a `ttl` field which is an object with the following keys: <ul><li>`strategy`: How to handle expired checkpoints (e.g., `"delete"`).</li><li>`sweep_interval_minutes`: How often to check for expired checkpoints (integer).</li><li>`default_ttl`: Default time-to-live for checkpoints in **minutes** (integer); applied to newly created checkpoints/threads only (existing data is unchanged). Defines how long checkpoints are kept before the specified strategy is applied.</li></ul> |
88-
| <span style={{ whiteSpace: "nowrap" }}>`api_version`</span> | _(Added in v0.3.7)_ Which semantic version of the LangGraph API server to use (e.g., `"0.3"`). Defaults to latest. Check the server [changelog](/langsmith/langgraph-server-changelog) for details on each release. |
88+
| <span style={{ whiteSpace: "nowrap" }}>`api_version`</span> | _(Added in v0.3.7)_ Which semantic version of the LangGraph API server to use (e.g., `"0.3"`). Defaults to latest. Check the server [changelog](/langsmith/agent-server-changelog) for details on each release. |
8989
</Tab>
9090
</Tabs>
9191

@@ -281,7 +281,7 @@ The LangGraph CLI requires a JSON configuration file that follows this [schema](
281281

282282
_(Added in v0.3.7)_
283283

284-
You can pin the API version of the LangGraph server by using the `api_version` key. This is useful if you want to ensure that your server uses a specific version of the API.
284+
You can pin the API version of the Agent Server by using the `api_version` key. This is useful if you want to ensure that your server uses a specific version of the API.
285285
By default, builds in Cloud deployments use the latest stable version of the server. This can be pinned by setting the `api_version` key to a specific version.
286286

287287
```json
@@ -314,7 +314,7 @@ The LangGraph CLI requires a JSON configuration file that follows this [schema](
314314

315315
_(Added in v0.3.7)_
316316

317-
You can pin the API version of the LangGraph server by using the `api_version` key. This is useful if you want to ensure that your server uses a specific version of the API.
317+
You can pin the API version of the Agent Server by using the `api_version` key. This is useful if you want to ensure that your server uses a specific version of the API.
318318
By default, builds in Cloud deployments use the latest stable version of the server. This can be pinned by setting the `api_version` key to a specific version.
319319

320320
```json

0 commit comments

Comments
 (0)