Skip to content

Example Guide

이 문서는 example app들이 각각 어떤 패턴을 보여주는지 비교합니다.

Which Example Should You Start From?

Example Human review Primary purpose Start here if...
autonomous_digest disabled simplest autonomous agent wiring 사람 개입 없이 자동 실행되는 흐름부터 보고 싶을 때
langchain_digest disabled LangChain-backed AgentEngine wiring LangChain이 어디에 들어가는지 end-to-end로 보고 싶을 때
langchain_repo_triage enabled agentic triage with observations and review LangChain + external API + human review를 같이 보고 싶을 때
github_repo_review enabled real HTTP API-backed review flow 실제 외부 REST API를 읽는 adapter 예제가 필요할 때
streamlit_review_demo optional browser UI on top of the same workflow CLI 대신 GUI로 plan/review/result를 확인하고 싶을 때
operational_change enabled review-heavy operational workflow review packet과 action-level review가 중요한 도메인을 보고 싶을 때
mock_api enabled fake external API integration 외부 시스템 실행을 시뮬레이션하는 adapter 구조를 보고 싶을 때

autonomous_digest

보여주는 것:

  • requires_human_review=False
  • 가장 작은 AgentEngine 구현
  • 가장 작은 ActionExecutor 구현
  • autonomous flow에서도 동일한 domain/workflow를 사용하는 방식

읽기 순서:

  1. examples/autonomous_digest/autonomous_digest_demo/models.py
  2. examples/autonomous_digest/autonomous_digest_demo/adapters.py
  3. examples/autonomous_digest/autonomous_digest_demo/bootstrap.py
  4. examples/autonomous_digest/tests/integration/test_autonomous_digest_flow.py

실행:

PYTHONPATH=src:examples/autonomous_digest ./.venv/bin/python -m pytest -q examples/autonomous_digest/tests

operational_change

보여주는 것:

  • review-enabled flow
  • higher-risk request shape
  • human review가 필요한 operational domain의 request modeling

읽기 순서:

  1. examples/operational_change/operational_change_demo/models.py
  2. examples/operational_change/operational_change_demo/adapters.py
  3. examples/operational_change/operational_change_demo/bootstrap.py
  4. examples/operational_change/tests/integration/test_operational_change_flow.py

실행:

PYTHONPATH=src:examples/operational_change ./.venv/bin/python -m pytest -q examples/operational_change/tests

langchain_digest

보여주는 것:

  • LangChainAgentEngine wiring
  • LangChain runnable이 structured output을 반환하는 방식
  • tool 이름 검증과 autonomous execution path
  • 외부 provider 없이 deterministic한 local demo

읽기 순서:

  1. examples/langchain_digest/langchain_digest_demo/models.py
  2. examples/langchain_digest/langchain_digest_demo/adapters.py
  3. examples/langchain_digest/langchain_digest_demo/bootstrap.py
  4. examples/langchain_digest/tests/integration/test_langchain_digest_flow.py

실행:

PYTHONPATH=src:examples/langchain_digest ./.venv/bin/python -m pytest -q examples/langchain_digest/tests

mock_api

보여주는 것:

  • fake API client
  • review 이후 external side effect처럼 보이는 실행 시뮬레이션
  • adapter 경계가 infrastructure concern을 어떻게 숨기는지

읽기 순서:

  1. examples/mock_api/mock_api_demo/client.py
  2. examples/mock_api/mock_api_demo/models.py
  3. examples/mock_api/mock_api_demo/adapters.py
  4. examples/mock_api/mock_api_demo/bootstrap.py
  5. examples/mock_api/tests/integration/test_mock_api_flow.py

실행:

PYTHONPATH=src:examples/mock_api ./.venv/bin/python -m pytest -q examples/mock_api/tests

github_repo_review

보여주는 것:

  • 실제 HTTP API를 읽는 ContextProvider
  • review-enabled flow와 external context collection
  • simulated action execution과 external read path의 분리

읽기 순서:

  1. examples/github_repo_review/github_repo_review_demo/client.py
  2. examples/github_repo_review/github_repo_review_demo/adapters.py
  3. examples/github_repo_review/github_repo_review_demo/bootstrap.py
  4. examples/github_repo_review/tests/integration/test_github_repo_review_flow.py

실행:

PYTHONPATH=src:examples/github_repo_review ./.venv/bin/python -m pytest -q examples/github_repo_review/tests

langchain_repo_triage

보여주는 것:

  • LangChain-based AgentEngine
  • external API observations
  • review packet에 observation이 드러나는 흐름
  • 승인된 write action만 실행되는 agentic triage 시나리오

읽기 순서:

  1. examples/langchain_repo_triage/langchain_repo_triage_demo/client.py
  2. examples/langchain_repo_triage/langchain_repo_triage_demo/adapters.py
  3. examples/langchain_repo_triage/langchain_repo_triage_demo/bootstrap.py
  4. examples/langchain_repo_triage/tests/integration/test_langchain_repo_triage_flow.py

실행:

PYTHONPATH=src:examples/langchain_repo_triage ./.venv/bin/python -m pytest -q examples/langchain_repo_triage/tests

streamlit_review_demo

보여주는 것:

  • same graph를 Streamlit UI에서 실행하는 방법
  • graph 설정을 바꿔 렌더링과 실행을 같이 바꾸는 방법
  • browser 기반 review surface
  • Mermaid workflow 시각화와 결과 확인

읽기 순서:

  1. examples/streamlit_review_demo/streamlit_review_demo/app.py
  2. examples/streamlit_review_demo/tests/unit/test_streamlit_demo.py

실행:

cd examples/streamlit_review_demo
uv sync
uv run streamlit run streamlit_review_demo/app.py

Suggested Progression

처음 보면 이 순서가 가장 이해하기 쉽습니다.

  1. autonomous_digest
  2. langchain_digest
  3. langchain_repo_triage
  4. github_repo_review
  5. streamlit_review_demo
  6. operational_change
  7. mock_api

이 순서가 좋은 이유:

  • 먼저 가장 단순한 autonomous path를 본다
  • 그 다음 review-enabled path를 본다
  • 마지막으로 external adapter 구조를 본다