modelscope/ms-agent

MS‑Agent – 자율형 AI 에이전트를 위한 가벼우면서 확장 가능한 프레임워크

무엇인가요 – MS‑Agent는 장기간에 걸쳐 여러 단계를 거치는 AI 에이전트를 구축, 실행, 관리할 수 있는 오픈소스 파이썬 기반 프레임워크입니다. 모델 호출, 도구 실행, 권한 검사, 피드백 루프를 조율하는 하네스를 제공하며, 컨텍스트 압축, 메모리 계층, 스케줄링을 처리합니다. 동일한 에이전트 로직은 웹 UI, 터미널 UI, CLI, 또는 공유 SDK를 통해 다른 파이썬 애플리케이션에 내장할 수 있습니다.

주요 기능

• 사용자 정의 가능한 하네스 – 에이전트의 계획, 검증, 단계 실행 방식을 조정하기 위해 라이프사이클 콜백, 후크, 정책 검사를 삽입할 수 있습니다.
• 컨텍스트 및 메모리 관리 – 세션, 활성 컨텍스트, 프로젝트 전체 메모리 저장소를 분리; 자동 정리 및 LLM 기반 요약을 통해 토큰 사용량을 제어합니다.
• 자율적 협업 – 리더 에이전트가 전문가 하위 에이전트를 생성하거나 DAG 스타일 워크플로우를 실행할 수 있으며, 각 역할에 다른 모델, 도구, 스킬을 할당할 수 있습니다.
• 재사용 가능한 스킬 – 도메인 특화된 절차를 스킬로 패키징하여 필요 시 로드할 수 있습니다. 실행 트레이스를 기반으로 평가 기반의 "스킬 진화" 워크플로우가 스킬을 개선합니다.
• 오픈 에코시스템 – 다양한 모델 제공업체, ModelScope의 MCP 도구 프로토콜, ACP/A2A 통합, 그리고 로컬 또는 원격 ModelScope 리포지토리 간에 에이전트, 스킬, 메모리를 동기화하는 에이전트 허브를 지원합니다.
• 다중 모달 입력 – 이미지, 동영상 등 다양한 모달리티를 에이전트에 제공 가능 (v1.6.0).
• 내장형 애플리케이션 – 리서치 (DeepResearch/Agentic Insight), 코드 생성 (Code Genesis), 동영상 제작 (Singularity Cinema), 금융 분석 (FinResearch), 문서 리서치 등 즉시 사용 가능한 파이프라인 제공.

시작 방법

1. Python SDK 설치 (Python 3.12 이상 필요). 패키지는 PyPI에서 ms-agent로 제공됩니다.
2. 인터페이스 선택:
   • WebUI – 리포지토리 복제 후 ms-agent ui 실행; 브라우저 워크스페이스에서 프로젝트 생성, 에이전트와 대화, 도구 활동 확인, 파일 편집 가능.
   • TUI / CLI – 터미널 기반 상호작용 또는 스크립트 작업에는 ms-agent chat 또는 ms-agent run … 사용.
   • SDK – 자신의 코드에서 ms_agent를 가져와 사용자 정의 에이전트를 구성하고, 스킬을 정의하며, 하네스를 프로그래밍 방식으로 호출 가능.
3. WebUI 설정 → 모델 패널에서 ModelScope(또는 기타) API 키 추가.

일반적인 사용 사례

• 심층 리서치 – 자율적 문헌 검색, 요약, 보고서 생성 (Agentic Insight v2).
• 소프트웨어 개발 – Code Genesis 스킬 세트를 활용한 다단계 코드 생성, 디버깅, 문서화.
• 콘텐츠 제작 – Singularity Cinema를 통한 동영상 생성 파이프라인.
• 금융 분석 – Akshare/Baostock에서의 데이터 수집 및 다에이전트 리서치 워크플로우.
• 일반 RAG / 지식 검색 – 로컬 코드베이스 및 문서에서 통합된 Sirchmunk 검색.

문서 및 커뮤니티

• 공식 사이트: https://modelscope.github.io/ms-agent/
• 문서 (영어 및 중국어): https://ms-agent-en.readthedocs.io
• 지원을 위한 Discord 및 WeChat 그룹.
• 프로젝트는 Apache-2.0 스타일 라이선스를 따릅니다 (LICENSE 참조).

왜 중요한가 – 도구 호출, 메모리 처리, 워크플로우 오케스트레이션의 복잡한 부분을 추상화함으로써 MS‑Agent는 개발자가 에이전트의 논리에 집중할 수 있도록 합니다. 모듈식 설계, 다중 모달 지원, 내장형 애플리케이션 덕분에 연구 보조자, 코드 코파일럿, 기타 자율형 AI 시스템의 실용적인 기반을 제공합니다.