LangChain/LangGraph Q&A Agent은 LangChain AI 의 공식 도큐먼트, 테디노트의 위키독스, 튜토리얼 등의 자료를 모은 MCP 서버인 langchain-dev-docs 를 사용하는 ReAct 에이전트입니다.
본 Repository 는 쉽게 구동하고 누구나가 개인화된 LangChain/LangGraph Q&A Agent 를 구동할 수 있도록 Docker Image 로 배포하였습니다.
다음의 명령어로 프로젝트를 다운로드 받습니다.
git clone https://github.com/teddynote-lab/langgraph-qna-agent.git
cd langgraph-qna-agent.env.example파일을.env파일로 복사하고 필요한 API 키를 추가합니다.
아래는 필요한 API 키 목록입니다.
ANTHROPIC_API_KEY=your_anthropic_api_key
LANGSMITH_API_KEY=your_langsmith_api_key
(참고) 여기서는 Anthropic 의 Claude Sonnet 3.7 Latest 모델을 사용하였습니다.
- Anthropic API 발급하기: https://console.anthropic.com/settings/keys
- LangSmith API 발급하기: https://smith.langchain.com
- 도커 설치
다음의 링크에 접속하여 Docker Desktop 을 다운로드 받아 설치합니다.
- 도커 실행
다음의 명령어로 Docker Desktop 을 실행합니다.
docker compose up -d다음은 채팅 인터페이스로 활용하고 있는 teddyflow.com 에 연결하는 방법입니다.
- teddyflow.com 에서 회원가입을 합니다.
회원가입시 "베타 키" 에 teddynote-youtube 를 입력하면 승인 없이 바로 가입이 가능합니다.
- 로그인 후 "새로운 앱 연결" 버튼을 클릭합니다.
- 앱 이름을 입력하고 "연결" 버튼을 클릭합니다.
- 탭에서 "LangGraph" 를 선택한 뒤 다음의 정보를 입력합니다.
- Endpoint:
http://localhost:7777 - Graph:
agent
-
연결 설정이 완료되면 "저장" 버튼을 클릭합니다.
-
"앱 연결하기" 버튼을 눌러 저장합니다.
다음의 명령어로 연결을 종료할 수 있습니다.
docker compose downFastAPI로 구현된 간단한 헬스 체크 서버입니다. /health 엔드포인트에 접속하면 200 상태 코드와 함께 건강 상태 정보를 반환합니다.
- Python 3.10 이상
- uv 패키지 매니저 (설치되어 있지 않은 경우 setup.sh 스크립트가 자동으로 설치합니다)
- setup.sh 스크립트에 실행 권한을 부여합니다:
chmod +x setup.sh- setup.sh 스크립트를 실행하여 가상환경을 생성하고 필요한 패키지를 설치합니다:
./setup.sh이 스크립트는 다음 작업을 자동으로 수행합니다:
- uv 패키지 매니저가 설치되어 있지 않다면 설치
.venv가상환경 생성- 필요한 의존성 패키지(FastAPI, Uvicorn 등) 설치
- start.sh 스크립트에 실행 권한을 부여합니다:
chmod +x start.sh- 이미 Docker 서비스가 7777 포트를 사용 중이라면 먼저 중지합니다:
docker compose down- 헬스 체크 서버를 실행합니다:
./start.sh서버는 7777 포트에서 실행됩니다.
GET /health: 200 OK 상태 코드와 함께 JSON 형식의 건강 상태 정보를 반환합니다GET /: /health 엔드포인트와 동일한 200 OK 응답을 반환합니다 (루트 경로 접속 시)GET /docs: Swagger UI 문서 (FastAPI에서 자동으로 제공)
서버가 실행되면 다음 명령어로 헬스 체크 엔드포인트를 테스트할 수 있습니다:
curl -i http://localhost:7777/health예상 응답:
HTTP/1.1 200 OK
content-length: 58
content-type: application/json
date: Mon, 01 Jan 2024 00:00:00 GMT
server: uvicorn
{"status":"healthy","service":"health-check-server"}
만약 서버 실행 시 "address already in use" 오류가 발생한다면, 다음 명령어로 Docker 서비스를 중지한 후 다시 시도해보세요:
docker compose down이렇게 하면 7777 포트를 사용 중인 Docker 컨테이너가 종료됩니다.
도커 이미지 링크: https://hub.docker.com/r/teddylee777/langgraph-qna-agent
MIT License