langgraph

[langgraph] checkpointer로 SqlAlchemy 사용

langgraph에서 checkpointer로 저장 시 MemorySaver와 Redis, Postgresql용만 존재한다. 다양한 DB를 제공하기 위해 SqlAlchemy용으로 만들어 보았다.import threadingfrom typing import Any, Optional, Sequence, Tuplefrom langchain_core.runnables import RunnableConfigfrom langgraph.checkpoint.base import ( WRITES_IDX_MAP, BaseCheckpointSaver, ChannelVersions, CheckpointMetadata, CheckpointTuple, get_checkpoint_id, get..

2025. 2. 21. 10:10

langgraph

[langgraph] 처음부터 ReAct 에이전트를 만드는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/react-agent-from-scratch/기본 제공되는 ReAct 에이전트(create_react_agent)를 사용하는 것은 시작하기에 훌륭하지만, 때때로 더 많은 제어와 사용자화가 필요할 수 있다. 그런 경우에는 사용자 정의 ReAct 에이전트를 만들 수 있다. 이 가이드는 LangGraph를 사용하여 ReAct 에이전트를 처음부터 구현하는 방법을 보여준다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai..

2024. 12. 3. 07:56

langgraph

[langgraph] ReAct 에이전트에 사람이 개입하는 프로세스를 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent-hitl/이 가이드는 ReAct 에이전트에 사람이 개입하는 프로세스를 추가하는 방법을 보여준다. ReAct 에이전트를 시작하는 방법에 대한 튜토리얼은 이 링크를 참조하자.도구가 호출되기 전에 중단점을 추가하려면 create_react_agent에 interrupt_before=["tools"]를 전달하면 된다. 이 기능이 작동하려면 체크포인터를 사용해야 한다.준비우선, 필요한 패키지를 설치하자.pip install langgraph ..

2024. 12. 3. 07:55

langgraph

[langgraph] ReAct 에이전트에 사용자 정의 시스템 프롬프트 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent-system-prompt/여기서는 ReAct 에이전트에 사용자 정의 시스템 프롬프트를 추가하는 방법을 보여준다. ReAct 에이전트를 시작하는 방법에 대한 튜토리얼은 이 링크를 참조하자.사용자 정의 시스템 프롬프트는 state_modifier 파라미터에 문자열을 전달함으로써 추가할 수 있다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai코드from dotenv import lo..

2024. 12. 3. 07:54

langgraph

[langgraph] ReAct 에이전트에 메모리 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent-memory/이 가이드는 미리 구축된 ReAct 에이전트에 메모리를 추가하는 방법을 설명한다. 미리 구축된 ReAct 에이전트를 시작하는 방법에 대한 튜토리얼은 이 링크를 참조하라.메모리는 create_react_agent 함수에 체크포인터(checkpointer)를 전달함으로써 에이전트에 추가할 수 있다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai코드# First we i..

2024. 12. 3. 07:53

langgraph

[langgraph] ReAct 에이전트를 사용하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/create-react-agent/여기서는 날씨를 확인할 수 있는 간단한 ReAct 에이전트 앱을 만들 것이다. 이 앱은 에이전트(LLM)와 도구들로 구성된다. 앱과 대화할 때, 먼저 에이전트(LLM)를 호출하여 도구를 사용할지 여부를 결정한다. 그런 다음 다음과 같은 루프를 실행한다.에이전트가 행동을 취하라고 말한 경우(즉, 도구를 호출해야 할 경우), 도구를 실행하고 결과를 에이전트에 전달한다.에이전트가 도구를 실행하라고 하지 않은 경우, 작업을 완료하고 사용자에..

2024. 12. 3. 07:52

langgraph

[langgraph] AutoGen, CrewAI 외 다른 프레임워크와 LangGraph 통합하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/autogen-integration/LangGraph는 에이전트 기반 및 다중 에이전트 애플리케이션을 구축하기 위한 프레임워크이다. 여기에는 다른 에이전트 프레임워크와의 통합도 포함된다.이 가이드는 LangGraph를 다른 프레임워크와 통합하는 방법을 보여준다. 여기서 통합하는 프레임워크는 AutoGen이지만, 다른 프레임워크와도 쉽게 통합할 수 있다.전체적인 흐름은 다른 에이전트를 LangGraph 노드 안에 래핑하는 방식이다. LangGraph의 노드는 임의의 코..

2024. 12. 3. 07:50

langgraph

[langgraph] 재귀 횟수에 도달하기 전에 상태를 리턴하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/return-when-recursion-limit-hits/그래프 재귀 제한을 설정하면 그래프 실행 시간을 제어할 수 있지만, 재귀 제한에 도달하면 그래프가 오류를 반환하게 된다. 모든 사용 사례에서 좋은 방법은 아니다. 대신, 재귀 제한에 도달하기 직전의 상태 값을 반환하도록 설정할 수 있다. 여기서는 이를 구현하는 방법을 보여준다.준비우선, 필요한 패키지를 설치하자.pip install langgraph 상태를 리턴하기 않기이 예제에서는 항상 재귀 제한에 도달하는..

2024. 12. 3. 07:48

langgraph

[langgraph] LangSmith에서 그래프 실행 시 실행 ID(runID), 태그(tag)와 메타데이터(metadata)를 전달하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/run-id-langsmith/그래프 실행을 디버깅하는 것은 IDE나 터미널에서 어려울 수 있다. LangSmith를 사용하면 LangGraph로 구축한 LLM 앱의 실행 데이터를 디버깅, 테스트 및 모니터링할 수 있다. 시작하는 방법에 대한 자세한 내용은 LangSmith 문서를 참조하자.그래프 호출 중 생성된 실행 데이터를 더 쉽게 식별하고 분석할 수 있도록, 실행 시점에 추가 구성 설정을 지정할 수 있다(참조: RunnableConfig).필드타입설명run_na..

2024. 12. 3. 07:47

langgraph

[langgraph] ReAct 스타일 에이전트로 구조화된 출력을 리턴하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/react-agent-structured-output/에이전트의 출력을 구조화된 형식으로 반환해야 할 때가 있을 수 있다. 예를 들어, 에이전트의 출력이 다른 다운스트림 소프트웨어에서 사용되는 경우, 에이전트가 호출될 때마다 동일한 구조화된 형식으로 출력을 제공하도록 하면 일관성을 유지할 수 있다.여기서는 툴 호출 에이전트의 출력을 구조화된 형식으로 강제하는 두 가지 방법을 알아보자. 기본 ReAct 에이전트(모델 노드와 툴 호출 노드)를 사용하며, 마지막에는 사용자..

2024. 12. 3. 07:44

langgraph

[langgraph] 노드 재시도 정책 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/node-retries/API를 호출하거나 데이터베이스를 쿼리하거나 LLM을 호출하는 등 노드에 사용자 정의 재시도 정책을 설정해야 하는 다양한 사용 사례가 있을 수 있다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai langchain-community재시도 정책을 구성하려면 add_node에 retry 매개변수를 전달해야 한다. retry 매개변수는 RetryPolicy라는 named tuple 객체를 받는..

2024. 12. 3. 07:41

langgraph

[langgraph] 그래프에 런타임 구성(configuration)을 하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/configuration/에이전트를 호출하는 시점에 설정할 필요가 있다. 예를 들어, 어떤 LLM을 사용할지 구성하는 경우가 해당된다. 아래에서는 이를 수행하는 예제를 설명한다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain_openai그래프 정의우선, 간단한 그래프를 만들자.import operatorfrom typing import Annotated, Sequencefrom langchain_core.messages i..

2024. 12. 3. 07:39

langgraph

[langgraph] 그래프를 시각화하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/visualization/이 가이드는 생성한 그래프를 시각화하는 방법을 설명한다. 이 방법은 모든 그래프에서 동작한다.준비우선, 필요한 패키지를 설치하자.pip install langgraph 그래프 준비어떤 임의의 그래프, 예를 들어 StateGraph도 시각화할 수 있다. 재미있게 프랙탈을 그려보자.import randomfrom typing import Annotated, Literalfrom typing_extensions import TypedDictfrom..

2024. 12. 3. 07:38

langgraph

[langgraph] 그래프를 비동기로 실행하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/async/비동기 프로그래밍 패러다임을 사용하면 IO 바운드 코드를 동시에 실행할 때 성능이 크게 향상될 수 있다(예: 채팅 모델 제공자에게 동시 API 요청을 보내는 경우).그래프의 동기 구현을 비동기 구현으로 변환하려면 다음과 같은 작업이 필요하다.노드에서 def 대신 async def를 사용하도록 업데이트한다.내부 코드를 적절히 await를 사용하여 업데이트한다.LangChain의 많은 객체들이 Runnable 프로토콜을 구현하고 있으며, 이 프로토콜은 모든 동..

2024. 12. 3. 07:36

langgraph

[langgraph] 노드 간 비공개(private) 상태 전달하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/pass_private_state/일부 경우에는 노드들이 그래프의 주요 스키마에 포함되지 않는 중요한 중간 정보를 교환하고자 할 수 있다. 이 비공개 데이터는 그래프의 전체 입력/출력에는 관련이 없으며, 특정 노드들 간에만 공유되어야 한다.이 가이드에서는 세 개의 노드(node_1, node_2, node_3)로 구성된 순차적 그래프의 예제를 만들어 보자. 여기서 비공개 데이터는 첫 번째 두 단계(node_1, node_2) 간에 전달되고, 세 번째 단계(node_3..

2024. 12. 3. 07:34