Repolode
제출하기
agentscope-ai

agentscope-ai/agentscope-java

이벤트 스트리밍, 도구 권한, 미들웨어, 샌드박스 실행을 지원하는 장기 실행 분산 에이전트 구축용 Java 프레임워크입니다.

GitHub에서 보기웹사이트
스타
6,276
포크
1,575
열린 이슈
972
마지막 커밋
어제

어떤 프로젝트인가요?

AgentScope Java는 Java로 LLM 기반 에이전트를 구축하기 위한 프레임워크로, 장시간 실행되고 많은 사용자를 처리하며 재시작 후에도 상태를 유지하는 에이전트를 목표로 합니다. ReAct 추론·실행 코어와 더불어, 그 위에 메모리, 스킬, plan mode, 서브에이전트 위임 기능을 더하는 HarnessAgent 계층을 제공합니다.

이 프레임워크는 프로덕션 환경에서 필요한 런타임 기능을 다룹니다. 도구 호출을 허용하거나 사용자 승인을 받도록 보류하거나 거부할 수 있으며, 통합 이벤트 스트림을 통해 모델 출력, 텍스트 델타, 도구 실행을 실시간으로 확인할 수 있습니다. 도구는 로컬 서브프로세스, Docker, Kubernetes 또는 E2B 클라우드 샌드박스에서 실행할 수 있습니다. 세션 상태는 인메모리 저장소, JSON 파일, MySQL, Redis 또는 PostgreSQL에 저장할 수 있어 롤링 배포 중에도 대화가 유실되지 않습니다.

모델 제공업체는 DashScope, OpenAI, Anthropic, Gemini, Ollama 등을 포함한 별도의 확장 모듈로 제공됩니다. JDK 17 이상이 필요하며 Maven Central을 통해 배포됩니다.

핵심 기능

  • 01실시간 렌더링과 휴먼 인 더 루프를 지원하는 타입 지정 이벤트 기반 통합 스트림입니다.
  • 02도구 호출 권한을 허용, 승인 필요, 거부 상태로 설정할 수 있습니다.
  • 03추론·실행 루프를 확장할 수 있는 미들웨어 훅을 제공합니다.
  • 04로컬, Docker, Kubernetes 또는 E2B 샌드박스에서 도구를 실행할 수 있습니다.
  • 05복제본 간 복구를 위해 Redis, MySQL, PostgreSQL 및 기타 저장소에 세션과 메모리를 저장할 수 있습니다.
  • 06agent_spawn 및 agent_send를 통해 서브에이전트를 생성하고 메시지를 주고받을 수 있습니다.

활용 사례

  • 다중 턴의 장기 실행 작업을 에이전트가 처리해야 하는 Java 백엔드 서비스.
  • 민감한 에이전트 작업에 대한 도구 승인과 감사가 필요한 엔터프라이즈 애플리케이션.
  • 세션 격리와 샌드박스 코드 실행이 필요한 멀티테넌트 SaaS 배포 환경.
  • 롤링 배포를 지원하면서 기존 Java 시스템에 에이전트 워크플로를 통합하는 경우.

빠른 시작

  1. 1

    agentscope-harness의 Maven 종속성을 추가합니다(JDK 17 이상).

  2. 2

    DashScope와 같은 모델 제공자 확장을 추가합니다.

  3. 3

    DASHSCOPE_API_KEY를 설정하고 Hello AgentScope 예제를 실행합니다.

사용 전 알아둘 점

  • JDK 17 이상이 필요합니다.
  • 모델 제공자는 별도로 추가해야 하는 확장 모듈입니다.
  • Hello 예제를 실행하려면 DashScope API 키가 필요합니다.

포함된 컬렉션

멀티 에이전트 오케스트레이션 프레임워크오픈소스 AI 에이전트 프레임워크와 앱마이크로서비스 프레임워크와 서비스 인프라

토픽

#agent#llm#java#agent-framework#multi-agent#sandbox#human-in-the-loop#distributed-systems#adk#agentic

자주 묻는 질문

agentscope-java은(는) 무엇인가요?
이벤트 스트리밍, 도구 권한, 미들웨어, 샌드박스 실행을 지원하는 장기 실행 분산 에이전트 구축용 Java 프레임워크입니다. AgentScope Java는 Java로 LLM 기반 에이전트를 구축하기 위한 프레임워크로, 장시간 실행되고 많은 사용자를 처리하며 재시작 후에도 상태를 유지하는 에이전트를 목표로 합니다. ReAct 추론·실행 코어와 더불어, 그 위에 메모리, 스킬, plan mode, 서브에이전트 위임 기능을 더하는 HarnessAgent 계층을 제공합니다.
agentscope-java은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
agentscope-java은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
agentscope-java은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. agentscope-java의 마지막 커밋은 2026년 11월 6일입니다.
agentscope-java은(는) 어디에 사용할 수 있나요?
다중 턴의 장기 실행 작업을 에이전트가 처리해야 하는 Java 백엔드 서비스. 민감한 에이전트 작업에 대한 도구 승인과 감사가 필요한 엔터프라이즈 애플리케이션. 세션 격리와 샌드박스 코드 실행이 필요한 멀티테넌트 SaaS 배포 환경. 롤링 배포를 지원하면서 기존 Java 시스템에 에이전트 워크플로를 통합하는 경우.
agentscope-java는 어떻게 설치하나요?
agentscope-harness의 Maven 종속성을 추가합니다(JDK 17 이상). DashScope와 같은 모델 제공자 확장을 추가합니다. DASHSCOPE_API_KEY를 설정하고 Hello AgentScope 예제를 실행합니다.
agentscope-java은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/agentscope-ai/agentscope-java

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트