langgraph

[langgraph] 도구 호출을 리뷰(review)하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/review-tool-calls/사람이 개입하는(Human-in-the-loop, HIL) 상호작용은 에이전트 시스템에서 매우 중요하다. 일반적인 패턴은 특정 도구 호출 후에 사람이 개입하는 단계를 추가하는 것이다. 이러한 도구 호출은 종종 함수 호출이나 정보 저장으로 이어진다. 예를 들면 다음과 같다.SQL을 실행하는 도구 호출, 이 후 도구에 의해 실행됨요약을 생성하는 도구 호출, 이 후 그래프의 상태에 저장됨도구 호출을 사용하는 ..

2024. 11. 30. 22:28

langgraph

[langgraph] 그래프의 과거 상태를 보고 수정하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/time-travel/그래프에서 체크포인트를 사용하면 언제든지 에이전트의 상태를 가져오거나 업데이트할 수 있다. 이것으로 몇 가지 작업을 가능하다.중단 시 상태를 사용자에게 표시하여 액션을 수락하게 할 수 있다.그래프를 되감아 문제를 재현하거나 방지할 수 있다.상태를 수정하여 에이전트를 더 큰 시스템에 통합하거나 사용자가 에이전트의 행동을 더 잘 제어할 수 있게 할 수 있다.이 기능을 위해 사용되는 주요 메서드는 다음과 같다.get_s..

2024. 11. 30. 22:26

langgraph

[langgraph] 사용자 입력을 대기하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/wait-user-input/사람이 개입하는(Human-in-the-loop, HIL) 상호작용은 에이전트 시스템에서 매우 중요하다. 사용자 입력을 기다리는 것은 일반적인 HIL 상호작용 패턴으로, 에이전트가 사용자에게 명확한 질문을 하고 입력을 기다린 후 계속 진행할 수 있게 한다.LangGraph에서는 이를 중단점을 사용하여 구현할 수 있다. 중단점을 사용하면 그래프 실행을 특정 단계에서 중지시킬 수 있다. 이 중단점에서 사용자 입..

2024. 11. 30. 22:23

langgraph

[langgraph] 그래프 상태를 수정하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/edit-graph-state/사람이 개입하는 (HIL) 상호작용은 에이전트 시스템에서 매우 중요하다. 그래프 상태를 수동으로 업데이트하는 것은 일반적인 HIL 상호작용 패턴으로, 사람이 행동을 수정할 수 있도록 한다 (예: 어떤 도구가 호출되는지 또는 어떻게 호출되는지).우리는 LangGraph에서 이를 중단점을 사용하여 구현할 수 있다. 중단점은 특정 단계 전에 그래프 실행을 중단할 수 있게 해주며, 이 중단점에서 그래프 상태를 수..

2024. 11. 30. 22:19

langgraph

[langgraph] 동적 중단 지점을 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/dynamic_breakpoints/사람이 개입하는(HIL) 상호작용은 에이전트 시스템에서 매우 중요하다. 브레이크포인트는 HIL 상호작용의 일반적인 패턴으로, 그래프가 특정 단계에서 멈추고 진행하기 전에 사용자 승인을 요청할 수 있도록 한다(예: 민감한 작업에 대해).LangGraph에서는 노드가 실행되기 전이나 후에 중단 지점을 추가할 수 있다. 그러나 특정 조건에 따라 주어진 노드 내부에서 동적으로 그래프를 중단시키는 것이 유용할..

2024. 11. 30. 22:16

langgraph

[langgraph] 중단 지점(breakpoint) 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/human_in_the_loop/breakpoints/사람이 개입하는(Human-in-the-loop, HIL) 상호작용은 에이전트 시스템에서 매우 중요하다. 중단 지점은 일반적인 HIL 상호작용 패턴으로, 그래프가 특정 단계에서 멈추고 진행하기 전에 사람의 승인을 요청하도록 한다(예: 민감한 작업의 경우).중단 지점은 LangGraph 체크포인트를 기반으로 만들어진다. 체크포인트는 각 노드 실행 후 그래프의 상태를 저장하며, 그래프 상태를 보존하는 스레드에 저장된다..

2024. 11. 30. 22:14

langgraph

[langgraph] 대화 이력을 요약하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/memory/add-summary-conversation-history/영속성의 가장 일반적인 사용 사례 중 하나는 대화 기록을 추적하는 것이다. 즉, 대화를 쉽게 이어갈 수 있게 한다. 그러나 대화가 길어지면 대화 기록이 쌓여서 컨텍스트 공간을 점점 더 많이 차지하게 된다. 이는 간혹 의도하지 않게 동작하며, LLM에 대한 호출이 더 비싸지고 길어지며, 오류가 발생할 수도 있다. 이를 해결하는 방법 중 하나는 지금까지의 대화 요약을 작성하고, 그것을 지난 N개의 메..

2024. 11. 29. 17:28

langgraph

[langgraph] 메시지 삭제하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/memory/delete-messages/그래프에서 일반적인 상태 중 하나는 메시지 목록이다. 일반적으로 상태에 메시지를 추가만 한다. 그러나 때때로 메시지를 제거할 때도 있다(상태를 직접 수정하거나 그래프의 일환으로). 이를 위해 RemoveMessage 수정자를 사용할 수 있다. 이 가이드에서는 이를 수행하는 방법을 다룬다.핵심 아이디어는 각 상태 키가 리듀서 키를 가진다는 것다. 이 키는 업데이트를 상태에 적용하는 법을 지정한다. 기본 MessagesState에..

2024. 11. 29. 17:27

langgraph

[langgraph] 대화 이력을 관리하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/memory/manage-conversation-history/영속성의 가장 일반적인 사용 사례 중 하나는 대화 기록을 추적하는 것이다. 즉, 대화를 쉽게 이어갈 수 있게 한다. 그러나 대화가 길어지면 대화 기록이 쌓여서 컨텍스트 공간을 점점 더 많이 차지하게 된다. 간혹 의도하지 않게 동작하며, LLM에 대한 호출이 더 비싸지고 길어지며, 오류가 발생할 수도 있다. 이런 일이 발생하지 않도록 하려면 대화 기록을 적절하게 관리해야 한다.참고: 이 가이드는 LangGr..

2024. 11. 29. 17:27

langgraph

[langgraph] Postgres 영속성 체크포인터 사용하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/persistence_postgres/LangGraph 에이전트를 생성할 때, 에이전트가 상태를 지속하도록 설정할 수도 있다. 이렇게 하면 에이전트와 여러 번 대화하고 이전 대화 내용을 기억하게 할 수 있다.이 가이드에서는 langgraph-checkpoint-postgres 라이브러리를 사용하여 Postgres를 백엔드로 설정하고 체크포인트 상태를 지속하는 방법을 보여준다.예시를 위해 사전 구축된 React 에이전트에 영속성을 추가한다.일반적으로, 이렇게 하면 자신..

2024. 11. 29. 17:25

langgraph

[langgraph] 그래프에 여러 스레드 간 영속성을 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/cross-thread-persistence/이전 가이드에서는 단일 스레드에서 여러 상호작용에 걸쳐 그래프 상태를 유지하는 방법을 알아봤다. LangGraph는 또한 여러 스레드에 걸쳐 데이터를 유지할 수 있다. 예를 들어, 사용자의 이름이나 선호도와 같은 정보를 공유 메모리에 저장하고 새로운 대화 스레드에서 재사용할 수 있다.이 가이드에서는 Store 인터페이스를 사용하여 구현된 공유 메모리를 가진 그래프를 구성하고 사용하는 방법을 보여준다.준비필요한 패키지를 설치..

2024. 11. 29. 17:23

langgraph

[langgraph] 서브그래프에 스레드 수준 영속성을 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/subgraph-persistence/이 가이드는 서브그래프를 사용하는 그래프에 스레드 수준 영속성을 추가하는 방법을 보여준다.준비필요한 패키지를 설치한다.pip install --quiet -U langgraph영속성이 있는 그래프 정의서브그래프가 있는 그래프에 영속성을 추가하려면, 부모 그래프를 컴파일할 때 체크포인터(checkpointer)를 전달하기만 하면 된다. LangGraph는 체크포인터를 자동으로 자식 서브그래프에 전달한다.Note: 서브그래프를 컴파일..

2024. 11. 29. 17:22

langgraph

[langgraph] 그래프에 스레드 수준 영속성 추가하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/persistence/많은 AI 애플리케이션은 상호작용 시 컨텍스트를 공유하기 위해 메모리가 필요하다. LangGraph에서는 스레드 수준 영속성을 사용하여 메모리를 모든 StateGraph에 추가할 수 있다.LangGraph 그래프 생성할 때 그래프를 컴파일할 때 체크포인터를 추가하여 상태를 저장하도록 설정할 수 있다.from langgraph.checkpoint.memory import MemorySavercheckpointer = MemorySaver()grap..

2024. 11. 29. 17:21

langgraph

[langgraph] 그래프 재귀 한도(recursion limit)를 제한하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/recursion-limit/그래프를 호출하거나 스트리밍할 때 재귀 한도를 설정할 수 있다. 재귀 한도는 그래프가 오류를 발생시키기 전에 실행할 수 있는 슈퍼스텝의 최대 개수를 설정한다. 재귀 한도의 개념에 대해 더 알아보려면 여기를 참고하자. 간단한 병렬 분기가 있는 그래프를 사용하여 재귀 한도가 어떻게 작동하는지 자세히 이해할 수 있는 예제를 살펴보자.그래프에서 재귀 한도 오류 대신 상태의 마지막 값을 반환하는 방법에 대한 예제를 보고 싶다면, 이 가이드를 참조하..

2024. 11. 29. 17:19

langgraph

[langgraph] map-reduce 브랜치를 병렬 실행하는 방법

LangGraph 공식문서를 번역한 내용입니다. 필요한 경우 부연 설명을 추가하였고 이해하기 쉽게 예제를 일부 변경하였습니다. 문제가 되면 삭제하겠습니다.https://langchain-ai.github.io/langgraph/how-tos/map-reduce/맵리듀스(Map-Reduce) 작업은 작업 분할과 병렬 처리를 효율적으로 수행하기 위해 필수적인 방식이다. 이 접근법은 작업을 더 작은 하위 작업으로 나누고, 각 하위 작업을 병렬로 처리한 후, 모든 하위 작업의 결과를 집계하는 과정을 포함한다.다음과 같은 예를 생각해보자.사용자가 일반적인 주제를 제시하면, 관련 주제 목록을 생성하고, 각 주제에 대한 농담을 만든 다음, 생성된 농담 중 가장 좋은 것을 선택하는 작업이다. 이 디자인 패턴에서는 첫 ..

2024. 11. 29. 17:17