파이프라인 시각화

파이프라인 시각화 (Visualizing Pipelines)

파이프라인을 그래프로 시각화하면 컴포넌트들이 어떻게 연결되어 있는지 더 잘 이해할 수 있어요.

출처: 공식문서

Haystack 파이프라인에는 draw()와 show() 메서드가 있어서, Mermaid 그래프를 사용해 파이프라인을 그래프로 시각화할 수 있어요.

데이터 프라이버시 주의 — 파이프라인 시각화를 쓸 때 민감한 데이터는 주의하세요. 이 기능은 Mermaid 그래프 웹 서비스를 기반으로 하는데, 이 서비스는 데이터 보존 기간이나 프라이버시 정책이 명확하지 않아요.

Mermaid 그래프를 사용하려면 인터넷 연결이 필요해요. Mermaid 그래프 렌더러인 https://mermaid.ink 에 연결해야 하기 때문이에요.

파이프라인의 show() 메서드를 사용하면 Jupyter 노트북에서 다이어그램을 표시할 수 있어요.

my_pipeline.show()

파이프라인의 draw() 메서드에 다이어그램을 저장할 경로와 형식을 전달하면 돼요. 가능한 형식은 mermaid-text와 mermaid-image(기본값)예요.

my_pipeline.draw(path=local_path)

다이어그램에서 SuperComponents를 블랙박스 컴포넌트로 두는 대신 내부 구조를 보여주고 싶다면, super_component_expansion 파라미터를 True로 설정하세요.

my_pipeline.show(super_component_expansion=True)
# or my_pipeline.draw(path=local_path, super_component_expansion=True)

인터넷 연결이 없거나 파이프라인 데이터를 원격 https://mermaid.ink 로 보내고 싶지 않다면, 로컬 mermaid.ink 서버를 설치해서 파이프라인을 렌더링할 수 있어요.

로컬 서버가 실행되고 있으면, show()나 draw() 메서드를 호출할 때 URL을 지정해 로컬 mermaid.ink 서버로 이미지를 렌더링하면 돼요.

my_pipeline.show(server_url="http://localhost:3000")
# or my_pipeline.draw("my_pipeline.png", server_url="http://localhost:3000")

파이프라인 그래프는 이런 모습일 수 있어요. RAG 파이프라인 플로우차트로, 쿼리에서부터 retriever, prompt builder, language model, answer builder 컴포넌트를 거치는 데이터 흐름을 보여줘요.

Haystack 파이프라인을 Haystack Enterprise Platform으로 가져와서 파이프라인을 시각적으로 계속 구축할 수 있어요. 그렇게 하려면 Haystack Enterprise Platform 문서에 설명된 단계를 따라 하세요.