Letta
기억을 스스로 다듬으며 이어 가는 상태 있는 에이전트
npm install -g @letta-ai/letta-code대화가 끝나도 상태가 남아서 시간이 갈수록 배우고 나아지는 에이전트를 만드는 플랫폼입니다. 앞선 이름은 MemGPT 였고, 모델의 맥락 창을 운영체제의 메모리처럼 다뤄 필요한 것만 올려 두는 접근으로 알려졌습니다. 터미널 인터페이스와 앱 서버, 데스크톱과 웹 앱이 함께 제공되고 슬랙과 텔레그램, 디스코드 같은 채널에 붙습니다. 타입스크립트 애플리케이션에 심는 SDK 도 있습니다. 이 저장소는 지금 안내용이고 실제 소스는 다른 저장소로 옮겨 갔으며, 은퇴한 1세대 서버 코드는 별도 브랜치에 보존돼 있습니다.
판단
이럴 때 씁니다
- 대화가 끝나도 상태가 남는 에이전트가 필요할 때
- 맥락 창 한계를 넘어서는 긴 관계를 유지해야 할 때
- 터미널과 데스크톱, 메신저에서 같은 에이전트를 이어 쓸 때
이럴 땐 쓰지 마세요
- 일회성 작업에는 상태 관리가 부담입니다
- 이 저장소에는 소스가 없어 다른 저장소를 찾아가야 합니다
- 1세대 서버 코드는 보존만 돼 있고 지원되지 않습니다
차별점
- 맥락 창을 운영체제 메모리처럼 다루는 접근으로 알려진 계보입니다.
- 터미널과 데스크톱, 웹, 메신저 채널에서 같은 에이전트를 이어 씁니다.
- 기억과 신원, 대화를 기기 사이에서 유지하는 경로를 제공합니다.
워크플로
- 01패키지를 전역으로 설치합니다.
- 02터미널 인터페이스를 띄웁니다.
- 03필요하면 앱 서버를 돌려 자체 호스팅합니다.
- 04에이전트에 기억과 신원을 붙입니다.
- 05데스크톱이나 메신저 채널에서 같은 에이전트를 이어 씁니다.
주요 명령
| 명령 | 설명 |
|---|---|
npm install -g @letta-ai/letta-code | 설치합니다. |
letta | 터미널 인터페이스를 띄웁니다. |
letta server | 로컬이나 자체 호스팅용 앱 서버를 돌립니다. |
함정
설치 전에 확인하세요
- 이 저장소는 지금 안내 페이지입니다. 실제 소스와 최신 설치 안내는 별도 저장소에 있습니다.
- 은퇴한 1세대 서버 코드가 별도 브랜치에 남아 있습니다. 재현 목적이며 보안 수정도 없으니 운영에 쓰면 안 됩니다.
- 샌드박스에서 서버로 도구 결과를 넘길 때 직렬화 방식이 최근에야 안전한 형식으로 바뀌었습니다. 오래된 판을 쓰고 있다면 올려야 합니다.
- 앞선 이름으로 검색하면 옛 구조를 설명한 글이 많이 나옵니다. 현재 구조와 다릅니다.
비교
일반적인 에이전트 라이브러리는 실행이 끝나면 상태가 사라지고 기억은 따로 붙입니다. 이쪽은 상태를 가진 에이전트를 기본 단위로 두고 그 위에 인터페이스를 얹었습니다. 대신 저장소 구조가 여러 번 바뀌어서 어떤 문서가 현재 것인지 확인하는 품이 듭니다.
최근 변경
샌드박스에서 서버로 도구 결과를 넘길 때 파이썬 객체 직렬화 대신 JSON 을 쓰도록 바꾼 보안 수정이 들어갔습니다.