ErnOS 에이전트 업데이트: Echo 툴링 전면 개편

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

로컬 에이전트 Echo는 대형 파일과 코드베이스 처리 안정성을 위해 파일 크기·행 수 기반의 페이지네이션과 청크 읽기 API를 도입했고, 프로젝트 디렉터리를 작업공간으로 링크해 내부에서 빌드와 테스트(run_command로 예: make prove)를 직접 실행하도록 했다. 또한 세션 목록을 통해 과거 대화를 식별하고 전사를 불러올 수 있게 세션 메모리 기능을 확장했으며 내부 연상성 메모리 동작을 사용자 허가 없이 자체적으로 관리하도록 변경해 상시 기억 활용이 가능해졌다. 도구 라우팅 정책을 개선해 입력 의도에 맞는 도구 호출을 선택적으로 수행하며 모든 처리는 로컬에서 이루어지고 링크된 디렉터리의 비밀은 차단된다고 명시되어 있다. 이 업데이트로 로컬 워크플로와 대용량 코드 탐색 신뢰성이 향상되었지만 자동 기억 동작의 통제와 감사 방식은 추가 검증이 필요하다.

실용적 조언

링크된 프로젝트 디렉터리를 Echo 작업공간에 연결할 때는 상대 경로 기반 명령 실행의 이점을 활용할 수 있다. 링크 후에는 run_command를 통해 내부 빌드와 테스트 명령을 직접 실행할 수 있으므로 반복적인 경로 입력을 줄이고 CI·테스트 루틴을 로컬 에이전트 워크플로에 통합할 수 있다. 연결 시 보안 요구사항을 확인해 링크된 디렉터리 내 비밀이 차단되는지 검증해야 한다.
대형 파일이나 코드베이스를 조사할 때는 페이지네이션과 청크 읽기 API를 우선적으로 사용해야 메모리·I/O 병목을 피할 수 있다. codebase_read와 codebase_read_range는 파일 크기와 행 수를 보고 적절한 청크를 반환하므로 검색어 기반 탐색이나 RAG 전처리 파이프라인에 해당 엔드포인트를 연결하면 안정적인 처리 결과를 얻을 수 있다. 또한 run_command 출력이 크기 주석과 페이징으로 제공되므로 출력 후처리 로직에서 페이징 경계를 인식해 결과를 순차적으로 병합하면 된다.

섹션별 상세

대형 코드베이스와 긴 파일을 다룰 때 기존 도구가 전체 파일을 한꺼번에 반환하거나 무시해 탐색이 불가능한 병목이 발생했다. codebase_read는 파일 크기와 행 수를 먼저 보고 페이지 단위로 파일을 반환하며, codebase_read_range는 파일을 청크 단위로 순회해 특정 범위를 읽는 입력→처리→출력 흐름을 구현한다. 본문은 이 변경으로 Echo가 큰 파일에서 키워드를 찾고 내부적으로 처리 중단 없이 결과를 제공할 수 있게 됐다고 기술했다. 이로 인해 로컬 코드 검색과 RAG 기반 문서 검색의 신뢰성이 개선됐다.

프로젝트 링크 기능은 사용자가 특정 디렉터리를 Echo의 작업공간에 연결하면 해당 경로를 기준으로 상대 경로가 해석되고 run_command를 통해 그 내부에서 빌드나 테스트를 실행할 수 있도록 했다. 예로 make prove 같은 명령을 링크된 리포지토리에서 직접 실행하는 입력을 받아 run_command가 명령을 실행하고 출력 크기를 주석으로 표시하며 페이지네이션 방식으로 결과를 전달한다. 본문은 링크된 디렉터리에서 빌드/테스트를 수행할 수 있게 되어 긴 경로 재입력을 줄이고 워크플로 효율을 높였다고 명시했다. 보안 측면에서는 링크된 디렉터리 내 비밀은 차단되어 링크가 데이터 유출 우회가 되지 않도록 설계됐다.

bash

make prove

링크된 프로젝트 디렉터리 안에서 테스트나 빌드를 실행하는 예시 명령행이다.

세션 메모리는 과거 대화의 메타데이터와 메시지 수, 모델 정보, 시간 등을 열거하는 list_sessions API로 구현되어 과거 대화를 식별하고 다시 읽는 흐름을 제공한다. Echo는 세션 목록을 반환한 뒤 사용자가 선택한 대화 ID를 기반으로 해당 대화 전사를 읽어 복원할 수 있으며 이는 상태 기반 작업 재개와 회귀 디버깅에 사용된다. 본문은 list_sessions가 id, title, model, message count, time을 새로 표시한다고 설명했고 이를 통해 Echo가 이전 컨텍스트를 참조해 작업을 계속할 수 있게 됐다고 밝혔다. 이 기능은 장기 작업 추적과 반복적 코드 수정 워크플로에서 유용하다.

도구 라우팅 개선은 Echo가 입력 의도를 분류하여 어떤 툴을 호출해야 하는지 판단하는 내부 정책을 강화한 결과물이다. Echo는 주어진 사용자의 요청을 분석해 사용 가능한 도구들 중 의도에 적합한 도구를 선택하고, 선택한 도구에 대해 run_command 등 구체적 API 호출을 수행해 결과를 집계해 반환한다. 본문은 이 변경으로 Echo가 더 이상 도달 가능한 툴을 포기하지 않는다고 밝혔으며 이는 명령 실행 실패율 감소와 더 나은 자동화 성능으로 이어진다고 서술했다. 실무적으로는 복합 작업에서 중간 포기 없이 적절한 툴 연결이 가능해졌다.

용어 해설

검색 증강 생성(RAG): — 검색 증강 생성은 외부 문서나 인덱스에서 관련 컨텍스트를 찾아 모델 입력으로 결합해 응답 정확도를 높이는 기법이다. 문서 검색과 랭킹, 컨텍스트 주입 단계를 거쳐 모델이 장기 기억이나 로컬 데이터에 접근하게 한다. 이 게시물에서는 RAG 검색 결과의 페이지네이션과 대형 파일 단위 처리와 연계되어 검색된 컨텍스트를 효율적으로 다루는 방식으로 중요하다.
페이지네이션(Pagination): — 페이지네이션은 대용량 텍스트나 출력 결과를 일정 크기 블록으로 나누어 순차적으로 전달하는 처리 방식이다. 큰 파일을 파일 크기와 행 수 기준으로 분할해 각 페이지를 읽고 탐색하는 입력→처리→출력 흐름으로 I/O와 메모리 병목을 완화한다. 본문에서는 codebase_read와 run_command 출력, RAG 검색 결과에 페이지네이션을 적용해 대형 데이터 탐색 안정성을 확보한 사례로 등장한다.
세션 메모리(Session Memory): — 세션 메모리는 개별 대화 기록의 메타데이터와 메시지 목록을 인덱싱하여 필요시 불러오는 저장소 기능이다. 세션 목록 조회, 특정 대화 읽기, 메시지 수·시간·모델 정보 제공 같은 입출력 인터페이스로 동작하며 장기간 대화 추적과 재현 가능한 컨텍스트 제공에 유용하다. 게시물에서는 list_sessions API로 과거 대화를 식별하고 다시 읽을 수 있게 한 점이 핵심이다.

언급된 도구

run_command추천

로컬 환경에서 명령을 실행하고 출력 크기를 주석으로 달며 페이지 단위로 결과를 반환하는 내부 API

make중립

링크된 프로젝트 디렉터리 내에서 빌드와 테스트를 실행하는 전통적 빌드 도구로 예시 명령어가 본문에 등장함

언급된 리소스

문서ErnOS Agent Update — Tooling Overhaul