Files
2026-07-13 12:58:18 +08:00

50 lines
1.6 KiB
Markdown

LangGraph — wired via `@copilotkit/runtime/langgraph`. Supports LangGraph Platform
deployments and self-hosted LangGraph servers.
## Install
`LangGraphAgent` (and `LangGraphHttpAgent` for self-hosted AG-UI LangGraph servers)
ship with `@copilotkit/runtime` — no separate install needed.
## Minimal wire-up
```typescript
import {
CopilotRuntime,
createCopilotRuntimeHandler,
} from "@copilotkit/runtime/v2";
import { LangGraphAgent } from "@copilotkit/runtime/langgraph";
const runtime = new CopilotRuntime({
agents: {
default: new LangGraphAgent({
deploymentUrl: process.env.LANGGRAPH_URL!,
graphId: "agent",
langsmithApiKey: process.env.LANGSMITH_API_KEY, // optional
}),
},
});
const handler = createCopilotRuntimeHandler({
runtime,
basePath: "/api/copilotkit",
});
export default { fetch: handler };
```
## Config fields
| Field | Notes |
| ----------------- | --------------------------------------------------------------------- |
| `deploymentUrl` | Base URL of the LangGraph Platform deployment (or self-hosted server) |
| `graphId` | The graph name registered with the deployment (e.g. `"agent"`) |
| `langsmithApiKey` | Optional — enables LangSmith tracing |
## Gotcha — `deploymentUrl` is NOT the CopilotKit runtime URL
The most common mistake is setting `deploymentUrl` to `/api/copilotkit`. That is the
frontend↔runtime URL, not the LangGraph server. Use the actual LangGraph deployment URL.
Source: `docs/content/docs/integrations/langgraph/quickstart.mdx:355`.