AgentScope 2.0은 복잡한 에이전트 작업을 맡기는 개발팀을 위해 계획·상태 관리 기능을 묶은 하네스를 주된 개발 진입점으로 내세웠다. 서버는 작업을 조율하고 격리된 샌드박스는 도구를 실행하는 구조로, 개발팀이 공통 기반을 재사용하면서 업무 도구와 결과 판단에 집중하도록 한다.

1. 하네스가 복잡한 작업의 기본 진입점

알리바바 클라우드 커뮤니티가 2026년 11월 11일 공개한 글은 자바 구현을 중심으로 AgentScope 2.0의 하네스 구조를 소개한다. 프레임워크가 모델과 도구 같은 구성 요소를 제공한다면, 하네스는 정보를 모델에 전달하고 과업을 진행하며 도구를 호출하고 진행 상태를 저장하는 작업 방식까지 엮는다.

이전 버전이 모델의 판단과 도구 호출을 반복하는 흐름, 에이전트 간 협업에 초점을 뒀다면 이번에는 장기 과업에 필요한 작업 방식을 기본 구성으로 묶었다. 개발자는 하네스를 바로 쓰거나 구성 요소와 실행 과정을 맞춤화할 수 있다.

2. 서버 조율과 격리 실행을 나누다

도구를 격리 환경에서 실행하는 Tool-In-Sandbox 구조에서는 모델의 판단과 도구 호출을 이어가는 흐름, 모델 호출과 컨텍스트 구성을 서비스 쪽에서 진행한다. 파일 작업이나 명령·코드 실행처럼 격리가 필요한 동작은 도구 인터페이스를 통해 샌드박스에서 수행하고, 결과와 산출물을 하네스로 돌려보낸다. 운영자는 하네스를 중앙에서 관리하면서 사용자나 세션별 실행 환경을 구성하고, 조율 서비스와 샌드박스 자원을 따로 확장할 수 있다.

이 구조는 여러 사업팀에 에이전트를 서비스로 제공하려는 조직을 겨냥한다. 플랫폼팀은 상태 관리, 격리 환경, 권한과 관측 기능을 공통 기반으로 제공하고, 사업팀은 도메인 지식과 도구, 결과 수용 기준을 맡는 식이다. 중복 구현을 줄일 수 있지만, 상태와 권한, 실행 환경을 운영하는 책임도 플랫폼 설계에 모인다.

3. 과업·정보·행동을 이어 붙이는 방식

글은 하네스의 역할을 과업, 정보, 행동의 세 층으로 설명한다. 과업 층은 계획과 진행 상태, 하위 에이전트 협업을 다루고, 정보 층은 모델에 전달할 자료와 작업 공간을 구성한다. 행동 층은 도구 실행 권한을 확인하고 실행 결과를 다음 판단의 근거로 돌려준다.

계획 모드에 들어가면 일반 수정 도구는 차단하고 읽기 전용 도구와 계획·협업용으로 허용한 도구를 남긴다. 영향이 큰 변경에서는 먼저 탐색해 계획을 세우고 사람의 확인을 거쳐 실행하는 방식이다. 다음은 원문의 자바 예시에서 하네스를 구성하는 부분이다.

HarnessAgent agent = HarnessAgent.builder()
        .name("remediation-agent")
        .model(model)
        .workspace(workspace)
        .enablePlanMode()
        .enableTaskList()
        .planFileDirectory("plans")
        .build();

원문이 든 결제 서비스의 의존성 취약점 수정 사례에 적용하면, 계획은 수정 범위를 정하고 테스트 결과는 다음 수정의 근거가 된다. 목표와 현재 진행 상태, 검증 결과를 따로 관리해 긴 대화 속에서 무엇을 마쳤는지 다시 추측하는 일을 줄이는 방식이다.

4. 도입 때 업무 경계도 함께 설계

도입 대상은 여러 단계를 거치며 정보가 계속 누적되고, 실행 중에 다음 경로를 찾아야 하는 일이다. 경로가 정해진 짧은 질의나 구조화 정보 추출에는 가벼운 호출과 작업 조율이 적합할 수 있다고 글은 설명한다.

취약점 수정 업무라면 애플리케이션은 검사할 코드 버전과 테스트, 보안 점검, 제출 문서의 수용 기준을 정한다. 샌드박스에는 코드 수정과 테스트에 필요한 권한을 주고, 운영 환경 배포는 별도 업무 도구로 다루는 식으로 실행 경계를 설계할 수 있다.

5. 구현 언어와 실행 환경에 맞춰 적용

함께 확인한 AgentScope 공개 저장소는 파이썬 구현을 안내하며 Python 3.11 이상을 요구한다. 로컬 환경 외에 애플리케이션을 격리해 실행하는 단위인 컨테이너와 외부 샌드박스 연동을 지원하고, 여러 사용자와 세션을 처리하는 에이전트 서비스도 제공한다. 자바 소개 글과 별개로 파이썬 적용 경로를 확인할 수 있는 자료다.

자바 예시의 계획 기능 활성화만으로 작업이 계획 모드에서 시작되지는 않으므로, 계획 선행이 필요한 애플리케이션은 모드 진입을 명시해야 한다. 업무 결과의 자동 수용도 기본 제공되는 것이 아니어서 검사 대상과 기준, 검증 절차는 호출자가 구성해야 한다.

AgentScope 2.0의 변화는 에이전트 조립을 넘어 장기 과업의 작업 방식을 기본 하네스로 묶은 데 있으며, 그 편의의 대가는 업무 권한과 결과 수용 기준을 명확히 설계하는 책임이다.