프로젝트 소개

AgentScope.Go는 Go 언어로 구현된 프로덕션 환경용 AI 에이전트 개발 프레임워크로, 현재 버전은 v2.6.0입니다. 이 프레임워크는 ReAct(추론+행동) 패러다임을 채택하여, 대규모 언어 모델 기반 지능형 애플리케이션 구축에 필요한 모든 인프라를 개발자에게 제공합니다. 핵심 기능은 다음과 같습니다: 1. 다중 모델 지원: OpenAI(Chat Completions 및 Responses API), Anthropic Claude, Google Gemini, 알리바바 클라우드 DashScope(통천원), DeepSeek, Moonshot(Kimi), xAI(Grok), vLLM, Ollama 등 주요 모델 제공업체 어댑터가 내장되어 있으며, OpenAI API 형식을 호환하는 모든 서비스는 BaseURL 구성을 통해 연결할 수 있습니다. 2. 메모리 관리 시스템: InMemory, Window, ReMeInMemory, ReMeFile, ReMeVector의 다섯 가지 메모리 구현을 제공하며, 7가지 벡터 백엔드, 하이브리드 검색(BM25+리랭커), Dream 진화, 지식 그래프를 지원합니다. ReMe 장기 메모리는 파일형과 벡터형 두 가지 모드를 지원하며, 개인/작업 메모리를 자동 추출하여 벡터 데이터베이스에 기록하고 통합 검색을 지원합니다. 3. 도구 시스템: 파일 작업(읽기/쓰기/편집/Glob/Grep), Shell, Web, JSON, 멀티모달 도구와 Task, Schedule, Subagent 같은 고급 도구가 내장되어 있습니다. JSON Schema로 매개변수를 정의하는 사용자 정의 FunctionTool을 지원합니다. 4. 다중 에이전트 오케스트레이션: Pipeline(순차 실행), Parallel(동시 실행), Condition(조건 분기), Loop(반복 최적화), MapReduce(긴 문서 요약) 등 다양한 오케스트레이션 모드와 MsgHub 브로드캐스트 메시지 스케줄링을 제공합니다. 5. 거버넌스 플레인: 장기 목표 관리, 할당량 제어, 사용자 게이팅, 증거 검증, 임대 관리, 대시보드 뷰를 지원하며, SQL 영속화를 제공하여 거버넌스-진화 폐루프를 구현합니다. 6. 멀티플랫폼 통합(채널): Webhook, Discord, Feishu 세 플랫폼의 챗봇 연동을 지원하며, 통합 메시지 라우팅 및 응답 메커니즘을 제공합니다. 7. RAG 호스팅 지식베이스: 완전한 문서 처리 파이프라인으로, 텍스트/PDF/PPTX/이미지/Word/Excel 파싱, 청크 분할, 벡터화, 인덱싱, 검색을 지원하며 HTTP API 인터페이스를 제공합니다. 8. 터미널 TUI(콘솔): bubbletea 기반 3-상태 머신 터미널 인터페이스로, HITL(인간-기계 협업) 확인, Ctrl+C 인터럽트, 3단계 이벤트 렌더링을 지원합니다. 9. 허브 마켓: MCP/Skill 카드 탐색 및 설치를 지원하며, FSHub 구현과 zip-slip 보안 방어를 제공합니다. 10. 관측성: OpenTelemetry, LangSmith, Langfuse를 통합하여 에이전트 수명주기 추적과 이벤트 스트림 전달을 지원합니다. 11. ONNX 로컬 추론: 순수 Go로 이미지(CLIP) 및 오디오(Whisper) 전처리 파이프라인을 구현하며, HTTP 프록시로 ONNX Runtime 서비스에 연결하고 CGO 의존성이 전혀 없습니다. 12. A2A 프로토콜: 완전한 에이전트 간 프로토콜 구현으로, AgentCard, Task, SSE, Registry, ShardRouter와 인증, 속도 제한, WebSocket 실시간 통신을 지원합니다. 13. 보안 및 권한: 멀티테넌트 세션 격리, RBAC 역할 권한, 규칙 엔진, Bash 복합 명령 분할, HITL 확인 모드를 제공합니다. 14. 프로덕션 서비스 부트스트랩: gateway.AppConfig + NewApp으로 원클릭 프로덕션 서비스 조립을 제공하며, 자동 도구 주입, 도구 제거, 권한 모드 구성, 임베딩 캐시 등을 지원합니다. 15. 플러그인 시스템: 3단계 수명주기, YAML 구성, Linux .so 동적 로딩을 지원합니다. 16. 메시지 버스: LocalBus, RedisBus, CoordBus의 네 가지 프리미티브(Lock/Registry/Queue/Log)와 TeamBus 크로스 세션 프로젝션을 제공합니다. 17. 자가 진화(Evolver): GEP Gene/Capsule 유형, Run/Reflect/Solidify 프로세스, Skill→Gene 증류를 지원합니다. 프레임워크는 기본 에이전트 사용법부터 프로덕션급 전체 기능 서비스까지 다양한 시나리오를 다루는 풍부한 예제 코드를 제공합니다. A2A 프로토콜, RAG 질의응답, 다중 에이전트 오케스트레이션, 음성 대화, 멀티테넌트 워크스페이스, 컨트롤 플레인, ONNX 추론 등을 포함합니다. 성능 측면에서 임베딩 캐시 히트는 약 550ns/op, 교차 모달 유사도는 약 741ns/op, 벡터 저장소 검색(1000개 노드)은 약 229μs/op, 전체 텍스트 검색(1000개 문서)은 약 97μs/op, 게이트웨이/ReAct 핫 경로는 약 147k req/s입니다. 환경 요구사항: Go 1.25 이상.