langgraph

[langgraph] 상태(state)에 pydantic 모델을 사용하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/state-model/StateGraph는 초기화 시 state_schema 인자를 받아들여 그래프의 노드들이 접근하고 업데이트할 수 있는 상태의 "형태"를 지정한다.예시에서는 보통 상태 스키마로 Python-native TypedDict를 사용하지만 (MessageGraph의 경우 리스트를 사용), state_schema는 어떤 타입도 될 수 있다.여기서는 Pydantic BaseModel을 state_schema로 사용하여 입력에 대한 런타임 검증을 추가하는 방법..

2024. 12. 3. 07:32

langgraph

[langgraph] 서브 그래프(subgraph)의 입/출력값을 변환하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/subgraph-transform-state/서브그래프 상태가 부모 그래프 상태와 완전히 독립적일 수 있다. 즉, 두 그래프 간에 중복된 채널(키)이 없을 수 있다. 예를 들어, 여러 개의 ReAct 에이전트를 활용하여 보고서를 작성해야 하는 감독(supervisor) 에이전트가 있을 수 있다. ReAct 에이전트 서브그래프는 메시지 목록을 추적할 수 있지만, 감독자는 사용자 입력과 최종 보고서만 상태에 저장하고 메시지는 추적할 필요가 없다.이러한 경우 서브그래프를 ..

2024. 12. 3. 07:31

langgraph

[langgraph] 서브 그래프(subgraph)에서 상태를 조회하고 업데이트하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/subgraphs-manage-state/영속성을 추가하면 서브그래프의 상태를 언제든지 쉽게 조회하고 업데이트할 수 있다. 이것으로 인해 많은 사람이 개입하는 상호작용 패턴을 가능하게 한다.사용자에게 중단 시 상태를 표시하여 작업을 수락하도록 할 수 있다.서브그래프를 되돌려 문제를 재현하거나 피할 수 있다.사용자가 작업을 더 잘 제어할 수 있도록 상태를 수정할 수 있다.이 가이드는 이를 수행하는 방법을 보여준다.준비우선, 필요한 패키지를 설치하자.pip install..

2024. 12. 3. 07:30

langgraph

[langgraph] 서브 그래프(subgraph)를 추가하고 사용하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/subgraph/서브그래프는 그래프로 구성된 여러 컴포넌트를 가진 복잡한 시스템을 구축할 수 있게 해준다. 서브그래프를 사용하는 일반적인 사례는 다중 에이전트 시스템을 구축하는 것이다.서브그래프를 추가할 때 가장 중요한 질문은 부모 그래프와 서브그래프가 어떻게 통신하는지, 즉 그래프 실행 중 상태를 어떻게 서로 전달하는지이다. 여기에 두 가지 시나리오가 있다.부모 그래프와 서브그래프가 스키마 키를 공유하는 경우: 이 경우, 컴파일된 서브그래프를 포함하는 노드를 추가할..

2024. 12. 3. 07:27

langgraph

[langgraph] 많은 수의 도구(tool)를 처리하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/many-tools/사용 가능한 도구 호출의 하위 집합은 일반적으로 모델의 재량에 달려 있다(많은 제공자들이 사용자에게 도구 선택을 지정하거나 제한할 수 있는 기능을 제공하기도 한다). 사용 가능한 도구의 수가 증가함에 따라, LLM이 선택할 수 있는 도구의 범위를 제한하려는 경우가 있을 수 있다. 이는 토큰 소비를 줄이고 LLM 추론에서 발생할 수 있는 오류의 원천을 관리하는 데 도움이 된다.여기서는 모델이 사용할 수 있는 도구를 동적으로 조정하는 방법을 보여준다...

2024. 12. 2. 07:03

langgraph

[langgraph] 도구에 구성(config) 전달하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/recursion-limit/런타임에서, 애플리케이션 로직에 의해 설정되어야 하는 값(예: 사용자 ID)을 도구에 전달해야 할 수 있다. 보안상의 이유로 LLM이 제어해서는 안된다. LLM은 오직 의도된 파라미터만 관리해야 한다.LangChain 도구는 Runnable 인터페이스를 사용하며, invoke와 같은 메서드는 RunnableConfig 인수를 통해 런타임 정보를 받는다.다음 예제에서는 사용자의 즐겨 찾는 애완동물을 관리하는 에이전트를 설정한다. 엔트리 추가..

2024. 12. 2. 07:00

langgraph

[langgraph] 도구(tool)에 런타임 값을 전달하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/pass-run-time-values-to-tools/가끔은 도구 호출 LLM이 도구 함수의 일부 인수만 채우고, 나머지 인수는 런타임에서 제공하도록 하고 싶을 수 있다. LangChain 스타일의 도구를 사용하는 경우, 이를 처리하는 쉬운 방법은 함수 파라미터에 InjectedArg를 주석으로 추가하는 것이다. 이 주석은 해당 파라미터를 LLM에 표시되지 않도록 한다.LangGraph 애플리케이션에서는 런타임에서 그래프 상태나 공유 메모리(스토어)를 도구에 전달하고..

2024. 12. 2. 06:58

langgraph

[langgraph] 도구(tool) 호출 시 에러 처리하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/tool-calling-errors/LLM은 도구를 호출하는데 있어 완벽하지 않다. 모델이 존재하지 않는 도구를 호출하거나 요청된 스키마와 일치하지 않는 인수를 반환할 수도 있다. 스키마를 간단하게 유지하고, 한 번에 전달하는 도구의 수를 줄이며, 도구에 대한 좋은 이름과 설명을 제공하는 것과 같은 전략은 이러한 위험을 줄이는 데 도움이 될 수 있지만 완벽한 해결책은 아니다.이 가이드는 이러한 실패 모드를 완화하기 위해 그래프에 오류 처리 기능을 구축하는 방법을 다룬..

2024. 12. 2. 06:53

langgraph

[langgraph] ToolNode를 사용하여 도구(tool)를 호출하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/tool-calling/이 가이드는 LangGraph의 사전 구축된 ToolNode를 도구 호출에 사용하는 방법을 다룬다.ToolNode는 그래프 상태(메시지 목록 포함)를 입력으로 받아 도구 호출 결과를 포함한 상태 업데이트를 출력하는 LangChain Runnable이다. 이 노드는 LangGraph의 사전 구축된 ReAct 에이전트와 잘 작동하도록 설계되었지만, 상태에 적절한 리듀서(예: MessagesState)가 있는 메시지 키가 포함된 모든 StateGra..

2024. 12. 2. 06:50

langgraph

[langgraph] 지원하지 않는 모델에서 스트리밍을 비활성화하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/#human-in-the-loop일부 채팅 모델, 예를 들어 OpenAI의 새로운 O1 모델(이 글을 읽는 시점에 따라 다를 수 있음)은 스트리밍을 지원하지 않는다. 이는 astream_events API를 사용할 때 문제가 될 수 있는데, 이 API는 스트리밍 모드에서 모델을 호출하며, 스트리밍이 정상적으로 작동할 것을 기대하기 때문이다.이 가이드에서는 스트리밍을 지원하지 않는 모델에 대해 스트리밍을 비활성화하는 방법을 알아보자. 이를 통해 이러한 모델이 astre..

2024. 12. 1. 18:16

langgraph

[langgraph] 서브그래프(subgraph)에서 스트리밍하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/streaming-subgraphs/서브그래프를 포함한 그래프를 생성한 경우, 해당 서브그래프 내부에서 발생하는 이벤트를 스트리밍할지 여부를 결정해야 할 수 있다. 이 가이드는 서브그래프에서 스트리밍되는 정보를 제어하는 방법을 설명한다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai서브 그래프 정의이 가이드에서 사용한 동일한 서브그래프를 사용할 예정이다.from typing import Optional, Ann..

2024. 12. 1. 18:14

langgraph

[langgraph] 최종 노드(final node)에서 스트리밍하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/streaming-from-final-node/에이전트에서 스트리밍을 사용할 때 일반적인 사용형태는 최종 노드 내부에서 LLM 토큰을 스트리밍하는 것이다. 여기서는 이를 수행하는 방법을 보여준다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai langchain-community모델과 도구 정의import asynciofrom typing import Literalfrom dotenv import load_dot..

2024. 12. 1. 18:11

langgraph

[langgraph] 도구 내에 이벤트를 스트리밍하는 방법 (LangChain을 사용하지 않고)

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/streaming-events-from-within-tools-without-langchain/이 가이드에서는 LangChain의 채팅 모델이나 도구 호출 기능에 의존하지 않고, 커스텀 ReAct 에이전트에서 사용하는 도구로부터 토큰을 스트리밍하는 방법을 보여준다.채팅 모델 상호작용은 OpenAI 클라이언트 라이브러리를 직접 사용하고, 도구 실행은 처음부터 구현할 것이다.이 예시는 LangGraph가 LangChain의 내장 구성 요소인 채팅 모델이나 도구 없이 독립..

2024. 12. 1. 18:10

langgraph

[langgraph] 도구(tool) 내에 이벤트를 스트리밍하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/streaming-events-from-within-tools/그래프에 LLM을 호출하는 도구(또는 다른 LangChain Runnable 객체들, 예: 다른 그래프, LCEL 체인, 검색기 등)가 포함되어 있다면, 도구 실행 중에 부분 결과를 사용자에게 전달하고 싶을 수 있다. 특히 도구가 실행되는 데 시간이 오래 걸릴 경우 유용하다.일반적인 시나리오는 LLM을 호출하는 도구가 생성한 LLM 토큰을 스트리밍하는 것이지만, 이는 Runnable 객체를 사용하는 모든 ..

2024. 12. 1. 18:09

langgraph

[langgraph] 동시에 여러 스트리밍 모드를 구성하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/stream-multiple/이 가이드는 여러 스트리밍 모드를 동시에 구성하는 방법에 대한 내용이다.준비우선, 필요한 패키지를 설치하자.pip install langgraph langchain-openai langchain-community그래프 정의이 가이드에서는 간단한 ReAct 에이전트를 사용한다.import asynciofrom typing import Literalfrom dotenv import load_dotenvfrom langchain_core.too..

2024. 12. 1. 18:08