AI Agent 개발에 필요한 개념들을 공부하며 정리한 노트입니다.
Study Period: 2025.09 - 2025.11 (Completed)
기준 스택은 아래 업데이트 이력을 참고하세요. 모델명과 패키지 버전은 빠르게 바뀌므로, 예제를 그대로 쓰기 전에 각 공급사 공식 문서를 확인하는 편이 안전합니다.
작성 시점 기준: LangChain 1.3 / LangGraph 1.2 / Python 3.14 / Ubuntu 26.04 LTS / PyTorch 2.13
동작하지 않던 예제 수정
gemini-2.0-flash계열은 서비스가 종료되어gemini-3.6-flash로 교체 (03, 05)AgentExecutor+create_react_agent조합을create_agent로 재작성 (05)from langchain_community.vectorstores import Chroma를langchain_chroma로 이동 (05)graph.set_entry_point(...)를add_edge(START, ...)로 교체 (07, 7곳)FAISS.load_local에allow_dangerous_deserialization인자 추가 (07)
LangChain 1.x 대응 (05)
- 패키지 3분할 설명 추가 (langchain / langchain-core / langchain-classic / langchain-community)
- Agent 섹션을
create_agent기준으로 재작성, 0.x API 대응표 추가 - 미들웨어 섹션 신설 (HumanInTheLoop, Summarization, PII)
ChatOllamaimport 를langchain_ollama로 확정- 모델 선택 가이드를 이름 나열 대신 등급(최상위/중간/경량) 기준으로 재구성
init_chat_model사용법 추가
LangGraph 1.x 대응 (07)
- 0.x 대비 변경점 대응표 추가 (set_entry_point, config_schema, create_react_agent)
MemorySaver를InMemorySaver로 교체TavilySearchResults를langchain_tavily.TavilySearch로 교체
인프라 및 버전 (01, 02, 03, 04)
- Ubuntu 22.04 를 26.04 LTS 로 교체, LTS 선택 기준을 표로 정리
- Python 3.12 를 3.14 로 교체
- Docker apt 키 경로를
/etc/apt/keyrings로 수정 - Compose 파일에서 무시되는
version:키 제거, 이미지를pgvector/pgvector:pg17로 교체 - PyTorch CUDA 예제를 cu118 에서 cu128 로 교체, 버전 선택 기준 추가
netstat대신ss를 기본 예제로 승격
내용 오류 수정
- 가격 기반 계산 예시가 실제 단가의 몇 배로 어긋나 있어, 구체적 단가 대신 계산 구조를 설명하는 방식으로 교체 (05, 07)
- "GPT-4 컨텍스트 128K" 서술을 삭제하고, 컨텍스트 창이 1M 이 된 뒤에도 청킹이 필요한 이유를 추가 (05)
- 출처 없는 채택률 통계 문장을 삭제 (05)
- RNN 섹션에 어텐션이 무엇을 해결했는지 설명 추가 (04)
문서 정리
- 코드 블록 안의
(구버전)/(2026.03.01 수정)주석과 본문 취소선을 모두 제거 - 변경 이력은 이 문서 한 곳으로 모음
- 모델명 갱신: Claude 3.5 Sonnet, gemini-2.0-flash-exp, llama3.1 등
- Python 3.10 을 3.12 로, pgVector 인덱스를 ivfflat 에서 hnsw 로 교체
- Ubuntu 24.04 LTS 사용 가능 여부 표기
- LangChain ChatOllama import 경로 변경 경고 추가
- AgentExecutor 폐기 예정 표기
- ML 섹션에 트랜스포머가 RNN 을 대체했다는 표기 추가