langgraph 이미지 표시 관련 draw_mermaid_png... - 인프런

LangGraph를 활용한 AI Agent 개발 (feat. MCP)

3.3 LangGraph에서 도구(tool) 활용 방법

langgraph 이미지 표시 관련 draw_mermaid_png() TimeoutError 관련

작성

222

안녕하세요..

langgraph 에서 graph_builder를 이용하여 노드와 엣지를 추가한 후에 compile한 후에 생성된 구조를 이미지로 표현하는 부분에서 오류가 발생합니다.
혹시 이 오류가 왜 발생하는지, 어떻게 수정해야 하는지 알려주시면 좋겠습니다

from IPython.display import Image, display

display(Image(graph.get_graph().draw_mermaid_png()))

이 부분을 실행하게 되면 다음과 같은 오류가 발생합니다.
TimeoutError Traceback (most recent call last) File ~/Workspace/pythonprj/langgraphtutorial/.venv/lib/python3.12/site-packages/urllib3/connectionpool.py:534, in HTTPConnectionPool._make_request(self, conn, method, url, body, headers, retries, timeout, chunked, response_conn, preload_content, decode_content, enforce_content_length)533 try: --> 534response = conn.getresponse() 535 except (BaseSSLError, OSError) as e:
.......
ValueError: Failed to reach https://mermaid.ink/ API while trying to render your graph after 1 retries.

이미지를 생성하는데 다른 사이트로 요청을 하는 것 같은데..timeout 오류가 발생하네요..

프롬프트엔지니어링 llm ai-agent langgraph mcp

답변 2

강병진

지식공유자

안녕하세요! 제보 감사합니다. 검색해보니 mermaid에 버그가 있나봐요 ㅠㅠ 조금 많이 못생겼지만 아래 방법으로 확인하실 수 있습니다

grandalf 패키지↗ 설치 -> maintain되는 서비스는 아닌 것 같아요

!uv add grandalf # uv사용 안하시면 pip install grandalf

아래 명령어로 확인 가능합니다

graph.get_graph().print_ascii()

Screenshot 2025-05-13 at 10.55.53 AM.png

강병진

지식공유자

덕분에 저도 해당 내용을 자주묻는 질문에 추가했습니다. 감사합니다!

산마로

질문자

안녕하세요.. 많은 인터넷 서치를 해봤는데, 뚜렷한 해결책을 못찾았는데, 방법을 알게 된 것 같습니다.
맞는 건지 모르겠지만, 저렇게 했더니, 이미지가 나오기는 합니다.

uv add pyppeteer 를 설치한후에..아마 mermaid 관련 사이트로 안가고, pyppeteer를 이용해서 로컬에서 이미지를 생성하는 방법이라는 것 같습니다.

from IPython.display import Image, display
from langchain_core.runnables.graph import  MermaidDrawMethod
display(Image(graph.get_graph().draw_mermaid_png(draw_method=MermaidDrawMethod.PYPPETEER,)))

강병진

지식공유자

공유 감사합니다! 스택오버플로우 보니까 mermaid관련 에러가 3월부터 안고쳐지는 것 같네요 ㅠㅠ

인프런 AI 인턴

안녕하세요, 인프런 AI 인턴입니다. 산마로님.

draw_mermaid_png() 기능을 사용하여 LangGraph의 이미지를 생성할 때 발생하는 TimeoutError는 외부 서비스(현재의 경우 mermaid.ink 웹사이트)를 통해 이미지를 생성하려고 할 때 서버에 연결하지 못해서 발생하는 문제입니다. 이 문제는 주로 인터넷 연결 문제나 해당 외부 서비스의 일시적인 문제로 인해 발생할 수 있습니다.

해결 방법

인터넷 연결 확인
- 인터넷 연결 상태를 확인해 주세요. 연결이 원활하지 않다면, 안정적인 네트워크 환경에서 다시 시도해 보세요.
외부 서비스의 가용성 확인
- mermaid.ink 서비스가 일시적으로 다운되었거나 사용량이 많아 요청을 처리하지 못할 수도 있습니다. 몇 분 후에 다시 시도하시거나 다른 시간대에 시도해 보세요.
타임아웃 설정 늘리기
- 요청을 보낼 때의 타임아웃을 늘려서 서비스가 응답할 수 있는 시간을 더 주어 보세요. requests 모듈을 사용하는 경우, 타임아웃을 조정할 수 있는 옵션이 있습니다.

import requests

response = requests.get('https://mermaid.ink', timeout=10)  # 10초로 타임아웃 설정

대체 서비스 이용
- 만약 mermaid.ink가 지속적으로 문제를 일으킨다면, 다른 머메이드 랜더링 서비스를 고려해 보세요. 로컬에서 머메이드 렌더러를 사용하는 방법도 가능할 수 있습니다.
차선책: 수동 다운로드
- 만약 코드 내에서 자동으로 해결되지 않는다면, 랩탑 등에서 외부 브라우저로 직접 리소스를 수동으로 다운로드하여 사용할 수도 있습니다.

위 방법들을 통해 문제 해결에 도움이 되길 바랍니다. 여전히 문제가 해결되지 않을 경우 더 많은 오류 메시지나 환경 설정 정보와 함께 추가 질문을 주시면, 추가로 도와드릴 수 있습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.

인프런 커뮤니티 질문&답변

langgraph 이미지 표시 관련 draw_mermaid_png() TimeoutError 관련

해결 방법