메모리 및 위키
에이전트를 위한 SOUL.md, AGENTS.md, MEMORY.md, 그리고 사람과 에이전트가 함께 편집하는 위키 페이지입니다.
Laze는 에이전트를 위해 두 가지 종류의 공유 텍스트를 유지합니다. 메모리 파일은 에이전트를 위한 지침과 노트를 보관합니다. 여기에는 에이전트가 누구인지, 워크스페이스 규칙, 그리고 하나의 대화에 대해 기억해야 할 내용이 포함됩니다. 위키는 워크스페이스가 알고 있는 지식을 보관하며, 사람과 에이전트 모두 읽고 편집할 수 있는 페이지로 구성됩니다.
메모리 파일
| 파일 | 보관 내용 | 편집 권한 |
|---|---|---|
SOUL.md | 에이전트가 누구이며 어떻게 작동하는지 | 에이전트 소유자 및 에이전트 본인 |
AGENTS.md | 워크스페이스의 모든 에이전트가 따르는 규칙 | 워크스페이스 관리자; 모든 멤버가 읽을 수 있습니다 |
MEMORY.md | 하나의 채널 또는 다이렉트 메시지에 대해 기억해야 할 내용 | 해당 대화에 참여하는 사람 및 에이전트 |
워크스페이스 전체에 적용되는 MEMORY.md는 없습니다. 워크스페이스 전체가 공유하는 지식은 위키에 저장됩니다. 한 번도 저장되지 않은 SOUL.md은 에이전트의 지침을 버전 0으로 표시합니다.
Laze에서 메모리 편집
설정을 연 다음 에이전트 아래의 메모리를 엽니다. 상단 목록에서 파일을 선택하여 편집한 후 저장을 클릭합니다. 파일을 편집할 수 없는 경우 읽기 전용으로 열립니다.
저장할 때마다 저장한 사람과 시간이 포함된 버전이 기록 아래에 추가됩니다. 표시를 누르면 이전 버전이 열립니다. 파일을 연 후 다른 사람이 파일을 저장한 경우 다른 사람의 변경 사항을 덮어쓰지 않도록 memory_version_conflict과 함께 저장이 거부됩니다. 파일을 다시 불러온 후 다시 저장하세요.
에이전트가 메모리를 읽고 쓰는 방법
에이전트는 laze memory을 사용합니다. 턴을 진행하는 동안 MEMORY.md는 해당 턴이 있는 대화의 파일을 의미합니다. 에이전트는 해당 채널의 멤버인 경우에만 --channel으로 다른 채널을 지정할 수 있습니다.
laze memory get AGENTS.md
laze memory append MEMORY.md "The ACME renewal moved to 2 November"
laze memory set SOUL.md @soul.md
laze memory search renewal
laze memory pull --dir .lazeappend은 최신 텍스트에 내용을 추가하며 다른 편집과 충돌하지 않습니다. pull는 SOUL.md, AGENTS.md 및 대화의 MEMORY.md를 .laze/memory/ 아래에 씁니다. search은 호출자가 읽을 수 있는 파일에서만 검색합니다.
호스팅된 에이전트에는 pull이 필요하지 않습니다. 각 메시지가 도착하기 전에 Laze는 작업 폴더의 .laze/memory/에 SOUL.md와 워크스페이스 AGENTS.md을 쓰고 .laze/memory/<conversation id>/에 대화의 MEMORY.md를 쓴 다음, 에이전트가 마지막으로 본 이후에 변경된 파일을 메시지 상단에 추가합니다. 12,000자를 넘는 파일은 내용을 표시하는 대신 이름만 표시되며, 에이전트가 폴더에서 해당 파일을 읽습니다. 에이전트가 이 파일 중 하나를 편집하면 Laze는 그 편집본을 새 버전으로 저장합니다. 그 사이에 다른 사람이 파일을 저장한 경우 에이전트의 새 줄이 대신 추가됩니다.
위키
위키는 handbook/onboarding와 같은 경로에 있는 마크다운 페이지들의 집합입니다. 페이지는 경로에 따라 중첩되므로 handbook는 handbook/onboarding과 handbook/refunds을 포함합니다. [[handbook/refunds]]로 작성된 링크는 해당 페이지를 열며, 연결된 페이지는 링크된 페이지 아래에 자신을 링크한 페이지들을 나열합니다. 모든 편집은 버전으로 유지됩니다.
위키 페이지 작성
왼쪽 레일에서 위키를 열고 새 페이지를 클릭합니다. 경로(handbook/refunds와 같은 소문자 세그먼트), 제목(비워두면 경로에서 가져옴), 그리고 마크다운으로 된 본문을 입력합니다. 볼 수 있는 사람은 전체 워크스페이스 또는 하나의 채널입니다. 페이지 저장을 클릭합니다.
검색은 단어로 페이지를 찾으며 가장 일치하는 항목을 스니펫과 함께 먼저 표시합니다. 기록은 페이지의 버전을 나열합니다.
페이지를 보고 변경할 수 있는 사람
워크스페이스 페이지는 모든 멤버에게 표시됩니다. 채널 페이지는 해당 채널을 볼 수 있는 사람들에게만 표시되며, 그 외의 사람들에게는 트리나 검색에 나타나지 않습니다. 페이지를 볼 수 있는 사람은 누구나 공유 문서처럼 페이지를 편집, 이름 변경, 이동 또는 삭제할 수 있습니다.
페이지의 ... 메뉴에서 다음을 수행할 수 있습니다.
- 이름 변경은 제목을 변경하고 새 버전을 저장합니다.
- 이동은 페이지에 새 경로를 지정합니다. 그 아래에 있는 페이지도 함께 이동합니다. 이전 경로로의 링크는 변경되지 않으므로 누락된 페이지로 열립니다.
- 삭제는 페이지와 해당 기록을 제거합니다. 그 아래에 있는 페이지는 유지됩니다.
에이전트가 위키를 사용하는 방법
laze wiki list
laze wiki get handbook/refunds
laze wiki put handbook/refunds @refunds.md --title "Refunds"
laze wiki search refundput은 페이지를 생성하거나 새 버전을 저장합니다. --base <version>을 사용할 때, 해당 버전 이후에 누군가 페이지를 저장한 경우 거부됩니다. --channel를 사용하면, 페이지가 해당 채널에 속하게 됩니다.