LangGraph JS/TS SDK

LangGraph JS/TS SDK (@langchain/langgraph-sdk)

LangGraph REST API와 상호작용하기 위한 JS/TS SDK 참조 문서야.

이 저장소는 LangGraph REST API와 상호작용하기 위한 JS/TS SDK를 포함하고 있어.

퀵 스타트 (Quick Start)

JS/TS SDK를 시작하려면 패키지를 설치해:

pnpm add @langchain/langgraph-sdk

실행 중인 LangGraph API 서버가 필요해. langgraph-cli로 로컬에서 서버를 실행한다면 SDK가 자동으로 http://localhost:8123을 가리켜. 그렇지 않으면 클라이언트를 만들 때 서버 URL을 지정해야 해.

import { Client } from "@langchain/langgraph-sdk";

const client = new Client();

// List all assistants
const assistants = await client.assistants.search({
  metadata: null,
  offset: 0,
  limit: 10,
});

// We auto-create an assistant for each graph you register in config.
const agent = assistants[0];

// Start a new thread
const thread = await client.threads.create();

// Start a streaming run
const messages = [{ role: "human", content: "what's the weather in la" }];

const streamResponse = client.runs.stream(
  thread["thread_id"],
  agent["assistant_id"],
  {
    input: { messages },
  }
);

for await (const chunk of streamResponse) {
  console.log(chunk);
}

문서 생성하기 (Documentation)

문서를 생성하려면 다음 명령을 실행해:

pnpm typedoc

여러 문서 파일을 하나의 마크다운 파일로 통합:

npx concat-md --decrease-title-levels --ignore=js_ts_sdk_ref.md --start-title-level-at 2 docs > docs/js_ts_sdk_ref.md

js_ts_sdk_ref.md를 MkDocs 디렉터리로 복사:

cp docs/js_ts_sdk_ref.md ../../docs/docs/cloud/reference/sdk/js_ts_sdk_ref.md

참조 문서 (Reference Documentation)

참조 문서는 여기에서 볼 수 있어. 더 많은 사용 예시는 여기에서 찾을 수 있어.

변경 로그 (Change Log)

새 버전의 변경 로그는 여기에서 볼 수 있어.

모듈 목록 (Modules)

@langchain/langgraph-sdk 참조 문서의 주요 섹션은 다음과 같아:

Client — LangGraph API 클라이언트와 실행(runs), 스레드(threads), 어시스턴트(assistants) 상호작용
Auth — 인증 및 인가 관련 타입·유틸리티
React — React SDK 컴포넌트/훅 통합
React Ui — React UI 서버 및 클라이언트 컴포넌트
Logging — SDK 로깅 설정

출처: 문서