|
| 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. |
0 commit comments