pip install langchain langchain-community langgraph openai

from langchain_openai import ChatOpenAI
from langchain_community.tools import DuckDuckGoSearchResults, WikipediaQueryRun
from langchain_community.utilities import WikipediaAPIWrapper
...

class AgentState(TypedDict):
    task: str
    search_results: List[str]
...

def search_agent(state: AgentState):
    results = search_tool.invoke({"query": state["task"]})
    return {"search_results": [r["snippet"] for r in results]}
...

def supervisor(state: AgentState):
    if not state["search_results"]:
        return Command(update=search_agent(state), goto="search_agent")
...

initial_state = {"task": "해안 도시의 기후 변화 영향", 
                 "search_results": [], 
                 "wiki_content": "", 
...```

이 코드는 다음을 수행합니다:

1. “해안 도시의 기후 변화 영향”에 대해 검색합니다.
2. 주요 주제에 대한 Wikipedia (위키피디아) 콘텐츠를 가져옵니다.
3. 두 소스를 합성하여 간결한 보고서를 작성합니다.

여러분의 API 키를 사용하여 **오늘 바로** 실행해 볼 수 있습니다. 환경 변수에서 `OPENAI_API_KEY`만 교체하세요.

## 프로덕션 환경 준비하기 (Making It Production-Ready)

위의 예시는 최소한의 프로토타입 (Prototype)입니다. 이를 확장하려면 다음이 필요합니다:

- **에이전트 추가**: 예: 보고서를 검증하기 위한 “비평가 (critic)” 에이전트 추가 [2][4].
- **LangSmith 사용**: 실행 흐름을 추적 (Trace)하고 지연 시간 (Latency)을 모니터링 [2].
- **에러 핸들링 (Error handling) 구현**: 실패한 도구 호출 (Tool calls)을 재시도하거나, 대체 도구로 폴백 (Fallback) [2].
- **상태 유지 (Persist state)**: 감사 가능성 (Auditability)을 위해 중간 결과물을 데이터베이스에 저장 [2].

LangGraph의 `Command` 라우팅 (Routing)을 사용하면 관리자 (Supervisor)의 결정에 따라 에이전트를 동적으로 전환할 수 있어, 시스템을 유연하고 탄력적 (Resilient)으로 만들 수 있습니다 [6].

## 오늘 바로 구축을 시작하세요

멀티 에이전트 (Multi-agent) AI는 먼 미래의 이야기가 아닙니다. 지금 바로 사용할 수 있으며, LangChain은 모든 수준의 개발자가 이에 접근할 수 있도록 돕습니다. 전체 스택을 다시 구축할 필요는 없습니다. 그저 **두세 개의 특화된 에이전트**로 시작하여, 각각을 개별적으로 테스트한 다음 관리자 (Supervisor)로 연결하세요 [2].

여러분의 첫 번째 시스템은 단순할 수 있습니다: 데이터를 찾는 연구원, 이를 형식에 맞춰 작성하는 작가, 그리고 정확성을 확인하는 비평가로 구성될 수 있습니다. 하지만 이들이 어떻게 협업하는지 확인하는 순간, 이것이 AI가 확장되는 방식임을 깨닫게 될 것입니다.

**시도해 볼 준비가 되셨나요?**

1. 위의 코드를 `multi_agent.py` 파일에 복사합니다.
2. `OPENAI_API_KEY`를 설정합니다.
3. `python multi_agent.py`를 실행하고 에이전트들이 협업하는 모습을 지켜보세요.
4. 결과를 Dev.to에 공유하고 저를 태그해 주세요. 여러분이 무엇을 만들었는지 정말 보고 싶습니다!

AI의 미래는 하나의 거대한 모델이 아닙니다. 그것은 함께 작동하는 똑똑하고 특화된 에이전트들의 팀입니다. 그리고 여러분은 이제 그 팀을 구축할 준비가 되었습니다.

_이 내용이 도움이 되었다면, [저에게 커피 한 잔을 선물해 주세요 ☕](https://ko-fi.com/qingluan) — 여러분의 후원이 이 글들을 계속 쓸 수 있는 힘이 됩니다!_

_또한 저의 AI 도구 모음도 확인해 보세요: [AI 次元世界](https://ai.xn--4ds5cia.xn--rhqv96g/) — 개발자를 위한 무료 AI 도구들입니다._