Eve
파일 시스템을 저작 인터페이스로 쓰는 지속형 에이전트 프레임워크
npm install eve에이전트의 핵심 능력이 정해진 위치의 파일로 존재합니다. 지시문은 항상 켜져 있는 시스템 프롬프트이고, 도구는 타입이 붙은 함수 파일, 스킬은 필요할 때 불러오는 절차 문서, 채널은 메시지 통로, 예약은 주기 작업입니다. 폴더를 열면 그 에이전트가 무엇을 할 수 있는지 그대로 보입니다. 살펴보고 늘리고 운영하기 쉽게 만드는 것이 이 구조의 목적입니다. 배경 작업 도구가 지속되는 작업 흐름으로 실행되고 기다리는 도구에서 하위 에이전트를 바로 부릅니다. 작업 흐름 안의 호출에는 재생해도 같은 결과가 나오도록 고정 키를 요구합니다.
판단
이럴 때 씁니다
- 에이전트 구성을 파일로 드러내고 싶을 때
- 예약 작업과 채널이 함께 필요할 때
- 오래 도는 작업을 안정적으로 다시 실행해야 할 때
이럴 땐 쓰지 마세요
- 타입스크립트가 아니면 쓸 수 없습니다
- 판이 0.5x 대라 규격이 움직입니다
- 간단한 한 번짜리 호출에는 과합니다
차별점
- 에이전트 구성이 정해진 위치의 파일로 드러납니다.
- 지시문과 도구, 스킬, 채널, 예약이 각각 별도 폴더입니다.
- 배경 작업이 지속되는 작업 흐름으로 실행됩니다.
- 기다리는 작업 흐름에서 하위 에이전트를 바로 부릅니다.
워크플로
- 01패키지를 설치합니다.
- 02정해진 폴더 구조로 에이전트를 만듭니다.
- 03지시문과 도구, 스킬을 파일로 씁니다.
- 04채널과 예약 작업을 붙입니다.
- 05지속되는 작업 흐름으로 실행합니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install eve | 설치합니다. |
npx create-eve | 새 에이전트 프로젝트를 만듭니다. |
함정
설치 전에 확인하세요
- 작업 흐름 안의 에이전트 호출에는 재생해도 같은 결과가 나오도록 고정 키를 넘겨야 합니다. 없으면 거부됩니다.
- 폴더와 파일 이름이 규약입니다. 위치를 바꾸면 인식되지 않습니다.
- 패키지 판이 구성 요소마다 따로 붙습니다. 저장소 태그만 보면 헷갈립니다.
- 판이 0.5x 대입니다. 규약이 바뀔 수 있습니다.
비교
코드로 에이전트를 정의하는 프레임워크는 구성이 코드 안에 흩어져 나중에 파악하기 어렵습니다. 이쪽은 파일 구조 자체를 인터페이스로 삼아 폴더만 열면 능력이 보입니다. 대신 규약을 벗어나면 인식되지 않습니다.
최근 변경
배경 작업 도구가 그 작업의 지속되는 실행으로 돌게 됐고 기다리는 작업 흐름과 샌드박스에서 하위 에이전트를 바로 부를 수 있습니다. 작업 흐름 안의 에이전트 호출은 이제 재생해도 안정적인 키를 요구합니다.