2-01 · Python·MCP·Agent 역할 구분하기
1. 실습 목표
Python 함수, MCP Tool과 Agent가 각각 무슨 일을 하고 어디에서 오류가 날 수 있는지 구분합니다. Agent에는 모델뿐 아니라 작업 지시, 사용할 수 있는 Tool과 실행을 멈출 기준도 필요합니다.
2. 시작 지점
- 시작 체크포인트:
student/05-day1-complete - 첫 과정 API·SQLite·화면:
30 / 29 / 21 / 8 / 1 - 이 단계에서는 코드를 작성하지 않습니다. 현재
practice/workspace의 첫 과정 코드를 살펴보고 다음 실습에서 추가할 MCP Tool, 마지막에 추가할 Agent와 어떤 차이가 있는지 표로 정리합니다.
브라우저에서 첫 과정 집계 30 / 29 / 21 / 8 / 1과 사례 상세를 기준 결과로 확인한 뒤, 이번 실습의 Python 함수·MCP Tool·Skill·Agent 역할 표를 작성합니다.
3. 구현 범위 및 요구사항
| 실행 방법 | 하는 일 | 모델 설정 | 오류가 나는 경우 |
|---|---|---|---|
| Python 직접 호출 | 정확한 CSV 연결·규칙·조회 계산 | 불필요 | 파일·스키마·계산 오류 |
| MCP 직접 호출 | 함수를 이름·입력 스키마가 있는 읽기 Tool로 공개 | 불필요 | 서버 연결·Tool 입력·권한 오류 |
| Agent 실행 | 모델이 허용 Tool을 요청하고 결과를 설명 | 필요 | 설정·모델·Tool·단계 제한 오류 |
Agent, Tool, Skill, MCP
- Agent: 모델 호출과 Tool 사용 순서를 조정하고 최종 설명을 만듭니다.
- Tool: 한 번 호출하는 경계가 분명한 함수/API입니다.
- Skill: 반복할 작업 순서·검증·중단 조건입니다.
- MCP: Tool을 발견하고 호출하는 연결 규약입니다.
- 별도 Memory나 범용 Agent 프레임워크는 이번 과정에 필요하지 않습니다.
flowchart LR P["Python 함수<br/>정확한 계산"] --> M["MCP Tool<br/>읽기 전용 공개"] M --> A["Agent<br/>Tool 선택과 설명"] A --> H["담당자 검토<br/>최종 결론"]
Agent 실행을 멈추는 경우
마지막 실습에서 만드는 Agent는 모델을 호출하기 전에 사용 권한부터 확인합니다. 권한이 있으면 get_case_evidence를 한 번만 호출하고 모델 처리는 최대 3단계에서 끝냅니다. 환경 설정이 없거나, 권한이 없거나, Tool 또는 모델에서 오류가 나면 실행을 멈춥니다. Agent 실행으로 입력 자료나 담당자의 최종 검토 결과가 바뀌어서는 안 됩니다.
4. 실습 프롬프트
현재 앱을 기준으로 Python, MCP Tool과 Agent의 역할과 데이터 흐름을 비교해 주세요. 코드는 수정하지 마세요.
현재 앱에는 입력 처리, 규칙 판정, SQLite 저장과 검토 화면이 구현되어 있습니다. `backend/app/main.py`, 실행 명령과 실제 입출력 경로를 살펴보고 각 기능이 어디에서 시작해 어디에 결과를 남기는지 확인해 주세요.
설명이 끝나면 기존 Python 코드와 앞으로 사용할 MCP Tool·Agent의 차이, 그리고 담당자가 계속 맡아야 할 판단을 구분할 수 있어야 합니다.
- Python, MCP Tool과 Agent의 시작 주체와 실행 흐름 비교
- 각 방식의 입력·출력, 권한, 저장 위치와 실패 시 중단 지점 정리
- Tool, Skill, MCP와 Agent에 대한 각각 한 문장의 정의
- 규칙 계산, Agent 초안과 담당자 최종 판단의 책임 구분
- 저장소에 없는 기능이나 자동화에 대한 추정 금지
답변은 비교표, 용어 정의, 책임 경계와 확인한 파일만 간단히 제공해 주세요.5. 예상 결과
Success
- Python 계산, MCP 연결, 모델 실행 실패를 서로 구분함
- Tool 후보: 모집단, 지정 표본, 사례 근거 조회 3개
- Agent가 R-01–R-04 결과를 바꾸거나 담당자 대신 최종 결론을 내리지 않음
- 출력 검토 자료:
output/day-2/working-paper.json- 첫 과정 기준 집계
30 / 29 / 21 / 8 / 1과 역할 표의 입력·출력·실패 책임이 일치함
6. 대표 실패 사례 및 복구
Failure
- MCP가 파일 쓰기나 최종 검토 결과까지 담당함
- Skill과 Tool을 같은 것으로 설명함
- 없는 Excel 실습 경로를 필수 단계로 안내함
Info
Python 함수·MCP Tool·Agent가 같은 일을 한다고 정리했다면 표를 다시 확인합니다. 일관된 결과가 보장되어야 하는 경우 Python 함수, 외부에서 호출할 수 있게 연결하는 일은 MCP Tool, 필요한 Tool을 선택하고 결과를 설명하는 일은 Agent가 맡습니다.
7. 다음 실습
모의 ERP에서 근거 조회하기에서 Python 함수를 MCP Tool로 공개합니다.