langchain-ai/agents-from-scratch

무엇인가요?

Agents From Scratch는 AI 에이전트를 처음부터 구축하는 과정을 안내하는 튜토리얼 스타일의 저장소입니다. 최종 목표는 Gmail API에 연결하여 이메일을 관리할 수 있는 "앰비언트" 에이전트를 만드는 것입니다. 프로젝트는 4단계로 나뉘며, 각 단계에는 노트북(대화형 레슨)과 함께 제공되는 코드가 있습니다. 또한 설정 지침, 테스트 스위트, 배포 노트도 제공됩니다.

어떻게 구성되어 있나요?

1. 서문 – LangGraph 101: LangGraph(에이전트 구축용 프레임워크)에 대한 빠른 입문서로, 채팅 모델, 도구 호출, 에이전트와 워크플로우, 노드와 엣지 같은 기본 개념을 다룹니다.
2. 에이전트 구축: 이메일 분류 단계(메시지 정렬)와 응답 초안을 작성하는 에이전트를 결합한 이메일 어시스턴트로 시작합니다. 이것이 핵심 구현입니다.
3. 평가: 샘플 이메일 데이터셋을 사용하여 에이전트의 동작을 테스트하는 방법을 배웁니다. 테스트는 LLM-as-a-judge 접근 방식과 LangSmith 추적을 사용하여 응답 품질, 도구 호출, 분류 결정을 확인합니다.
4. 인간 참여(Human-in-the-loop): 에이전트가 작업(이메일 보내기, 회의 일정 잡기 등)을 실행하기 전에 인간이 검토하고 승인할 수 있는 기능을 추가합니다. 이를 위해 Agent Inbox라는 인터페이스가 제공됩니다.
5. 메모리: 어시스턴트에 메모리를 추가하여 사용자 피드백에서 학습하고 시간이 지남에 따라 선호도를 기억할 수 있게 합니다. LangGraph의 Store를 사용하여 장기 지속성을 구현합니다.

최종 완전 기능 버전(email_assistant_hitl_memory_gmail.py)은 실제 Gmail과 통합되며 LangGraph 플랫폼에 배포할 수 있습니다.

실행에 필요한 것은 무엇인가요?

• Python 3.11 이상 (LangGraph 호환성에 필요)
• API 키: OpenAI(모델용) 및 LangSmith(추적 및 평가용)에서 발급
• 패키지 설치 – 저장소는 편집 가능 모드로 설치해야 합니다(pip install -e . 또는 uv sync --extra dev). 노트북이 올바르게 작동하려면 필요합니다.
• Gmail 통합의 경우: src/email_assistant/tools/gmail/README.md의 특정 지침에 따라 Google API 자격 증명을 설정하세요.

핵심 요점

이 저장소는 실용적이고 점진적인 가이드입니다. 절대적인 기본부터 시작하여 실제 이메일을 처리할 수 있는 배포 가능하고 메모리 지원 에이전트까지 구축합니다. 그 과정에서 에이전트를 평가하고 개선하는 방법, 인간의 감독을 추가하는 방법, 장기 메모리를 부여하는 방법을 보여줍니다. 이러한 원칙은 여러분이 구축하는 모든 에이전트에 적용할 수 있습니다.