AgentScope
관찰과 디버깅을 전제로 설계한 에이전트 프레임워크
pip install agentscope모델이 스스로 추론하고 도구를 고르는 쪽에 무게를 두고 만든 에이전트 프레임워크입니다. 프롬프트로 행동을 강하게 묶는 대신 필요한 추상만 제공해서, 모델이 좋아질수록 코드를 덜 고치도록 설계했습니다. 여러 에이전트를 정해진 흐름으로 묶는 파이프라인과 터미널에서 바로 시험하는 콘솔이 들어 있고, 원격 A2A 에이전트와도 대화합니다. 만든 에이전트를 서비스로 띄워 딩톡과 라크, 디스코드 같은 메신저에 붙이는 채널 기능이 있어 배포까지 한 저장소에서 해결합니다. MCP 와 스킬을 허브에서 골라 작업 공간에 넣는 경로도 제공합니다.
판단
이럴 때 씁니다
- 에이전트가 무엇을 왜 했는지 추적하며 만들어야 할 때
- 여러 에이전트를 정해진 순서로 묶어 하나의 이벤트 흐름으로 다뤄야 할 때
- 만든 에이전트를 메신저 채널에 붙여 서비스로 띄우려 할 때
이럴 땐 쓰지 마세요
- 파이썬 3.11 미만 환경에서는 설치되지 않습니다
- 단발성 호출 몇 번이면 프레임워크가 과합니다
- 2.0 에서 구조가 크게 바뀌어 이전 판 예제가 그대로 통하지 않습니다
차별점
- 실시간 중단과 재개를 지원하는 추론 실행 루프가 기본 블록으로 들어 있습니다.
- 파이썬 함수와 MCP 서버, 스킬을 한 툴킷에서 함께 관리합니다.
- 만든 에이전트를 딩톡과 라크, 디스코드 채널에 붙이는 배포 경로가 저장소에 있습니다.
- 원격 A2A 에이전트와 규약으로 대화합니다.
워크플로
- 01패키지를 설치합니다.
- 02ReAct 같은 기본 블록으로 에이전트를 조립합니다.
- 03툴킷에 파이썬 함수와 MCP 서버, 스킬을 등록합니다.
- 04콘솔로 터미널에서 동작을 확인합니다.
- 05필요하면 파이프라인으로 여러 에이전트를 묶고 채널에 붙여 배포합니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install agentscope | PyPI 에서 설치합니다. 파이썬 3.11 이상이 필요합니다. |
uv pip install -e . | 저장소를 받아 수정 가능한 모드로 설치합니다. |
함정
설치 전에 확인하세요
- 파이썬 3.11 이상이 필수입니다. 그 아래에서는 설치 단계에서 막힙니다.
- 2.0 에서 설계 방향이 바뀌었습니다. 프롬프트로 행동을 묶던 이전 판 예제를 그대로 옮기면 맞지 않습니다.
- 맥락 관리에 자동 압축과 도구 결과 분리가 들어 있습니다. 어떤 기준으로 잘라 내는지 모르고 쓰면 사라진 맥락을 찾느라 헤매게 됩니다.
- 빌드는 빠른 편이지만 릴리스마다 수백 건이 들어갑니다. 판을 올릴 때 변경 폭을 확인해야 합니다.
비교
에이전트 프레임워크는 대체로 실행 루프를 얼마나 촘촘히 정해 주느냐로 갈립니다. 이쪽은 모델의 판단을 믿고 추상을 얇게 두는 대신, 관찰과 디버깅 도구를 두껍게 얹었습니다. 콘솔과 채널, 허브까지 한 저장소에 있어 만든 다음 어디에 붙일지를 따로 고민하지 않아도 됩니다.
최근 변경
A2A 규약을 지원해 원격 에이전트와 대화할 수 있게 됐고, 여러 에이전트를 고정된 흐름으로 묶는 파이프라인이 들어갔습니다. 터미널에서 시험하는 콘솔과 딩톡 채널 연동도 추가됐습니다.