에이전트에게 메모리를 주기

튜토리얼 · 읽는 시간 5분

에이전트 메모리는 당신의 Skilnu 계정에 연결된 짧고 비공개적인 메모다——선호, 제약, 다시 설명할 가치가 없는 사실——연결하는 어떤 MCP 클라이언트든 저장할 수 있고, 나중에 연결하는 어떤 MCP 클라이언트든 다시 찾을 수 있다. 이것은 녹음도 스킬도 아니다——무언가가 명시적으로 저장하지 않으면 아무것도 기억되지 않으며, 여기서 저장한 것은 버전 관리되거나 조합되거나 공개되지 않는다. 이것은 Pro/Team 기능이다. 무료 계정은 조용히 실패하는 대신 명확한 업그레이드 오류를 받는다.

1. 기억할 가치가 있는 것을 저장하기

앱에서 계정 메뉴를 열고 Memories을 클릭한다. 모든 에이전트가 이미 알았으면 하는 것을 적는다——「배포는 main 브랜치에서 GitHub Actions를 통해 이루어지며, 수동으로는 절대 하지 않는다」는 유용하다. 「화요일에 CI에 대해 길게 이야기했다」는 그렇지 않다——행동으로 옮길 것이 아무것도 없기 때문이다. 나중에 주제별로 찾고 싶다면 쉼표로 구분한 태그를 몇 개 추가하고, 그런 다음 저장한다.

내용은 4,000자로 제한된다——이것은 메모이지 문서가 아니다. 저장하려는 내용이 그보다 길다면 그것은 아마 메모리가 아니라 스킬일 것이다——대신 공개하면 조용히 잘리는 대신 버전 관리되고 공유될 수 있다.

2. 다시 찾기

검색은 가능할 때 의미적으로 순위를 매긴다——「이 사람이 리뷰를 어떻게 받고 싶어 하는지」를 검색하면 「변수 이름을 지나치게 지적하지 말아 달라」고 적어둔 메모리가 나타날 수 있다. 두 문장이 거의 단어를 공유하지 않아도 같은 의미이기 때문이다. 의미적 일치가 기준을 넘지 못하면 내용과 태그에 대한 단순 키워드 일치로 돌아가므로, embedding 단계가 실행되지 않았다는 이유만으로 검색 결과가 비어 있는 일은 없다.

검색창을 비워두면 모든 것을 최신순으로 둘러볼 수 있다.

3. 잘못되었거나 오래되었으면 삭제하기

어떤 메모리든 「삭제」를 클릭하고 확인한다. 되돌릴 수 없다——이 플랫폼에서 다른 것을 삭제할 때와 마찬가지다. 잘못된 것이 된 메모리(더는 가지고 있지 않은 선호, 더는 사실이 아닌 것)는 나중에 에이전트가 그것을 신뢰하게 두는 대신 삭제할 가치가 있다.

에이전트에서 하는 방법

같은 네 가지 동작이 네 개의 MCP 도구이며, 에이전트는 대화 중간에 앱을 전혀 열지 않고도 메모리를 저장하고 불러올 수 있다:

save_memory(content="Deploys happen via GitHub Actions on main.", tags=["ci", "deploy"])
  -> { memory_id, content, tags, created_at }

search_memories(query="how are deploys triggered")
  -> { items: [...], total, limit, offset }

list_memories(limit=20)
  -> { items: [...], total, limit, offset }

forget_memory(memory_id="...")
  -> { deleted: true, memory_id }

네 가지 모두 선택적인 publisher_id를 받는다. 이것은 연결이 여러 publisher에 연결되어 있을 때만 필요하며, 대부분의 연결은 그렇지 않으므로 대부분의 호출자는 이것을 생략할 수 있다.

무언가를 저장할 가치가 있는지 판단하는 것은 에이전트가 잘 해내야 할 몫이다. 당신이 웹 폼을 채울 때 스스로 내리는 판단과 마찬가지다——스쳐 지나가는 모든 말에 save_memory을 호출하는 도구는 모든 것을 붙여넣는 메모 파일과 똑같이 쓸모없는 더미를 만들어낼 뿐이다.

비용

메모리를 저장하고, 목록을 보고, 검색하고, 삭제하는 데는 Pro 또는 Team 구독 자체 외에 추가 비용이 들지 않는다——스킬을 컴파일할 때 있는 호출당 쿼터 같은 것이 없다. 유일한 제한은 계정당 2,000개의 메모리 상한이며, 이를 초과하면 save_memory는 가장 오래된 항목을 조용히 삭제하는 대신 그 한도를 명시하는 명확한 오류를 반환한다.

무엇을 저장해야 하고, 무엇을 저장하지 말아야 하는가

좋은 메모리는 다음을 위한 지시처럼 읽힌다——안정적인 선호, 고정된 제약, 세션이 바뀌어도 변하지 않는 사실. 좋지 않은 메모리는 이번 세션에 대한 일기처럼 읽힌다——무엇을 해야 하는지에 대한 안내가 아니라 무슨 일이 있었는지에 대한 요약이다. 입사 첫날 새 동료에게 반복하고 싶지 않은 것이라면, 여기에 저장할 가치도 없을 것이다.