역할
역할을 사용하면 Anyy 프로필 하나에 여러 비서 정체성을 둘 수 있습니다. 역할은 Anyy의 페르소나와 기본 작업 방식을 바꾸지만 별도 사용자나 데이터 공간을 만들지 않습니다.
역할과 프로필 경계
프로필의 모든 역할은 다음을 공유합니다.
- 워크스페이스와 데이터베이스.
USER.md와MEMORY.md메모리.- 모델, 도구, 스킬, MCP 구성.
- 채널과 Cron 작업.
- 세션 이력 경계.
역할은 도구 이름, 도구 권한, Codemode 모드를 선택하지 않습니다. 도구와 세션 도구 선택으로 관리하세요.
다른 말투나 작업 방식이 필요하면 역할을 사용하세요. 독립 홈, 메모리, 자격 증명, 구성, 이력이 필요하면 프로필을 사용하세요.
역할 만들기
- Dashboard → Roles를 엽니다.
- New Role을 선택합니다.
scribe같은 영구 역할 ID를 입력합니다.- 선택적으로
Scribe같은 표시 이름을 입력합니다. - Create role을 선택합니다.
역할 ID는 소문자나 숫자로 시작하며 소문자, 숫자, 하이픈, 밑줄을 사용합니다. ID는 역할 저장 경로의 일부가 되며 나중에 이름을 바꿀 수 없습니다. 표시 이름은 바꿀 수 있습니다.
생성 후 Dashboard가 Soul 편집기를 엽니다. 온보딩이 대기 또는 활성 상태일 때 비어 있지 않은 Soul을 저장하면 기본 default 역할을 포함해 온보딩이 완료됩니다.
첫 사용 역할 대화에서도 설정을 마칠 수 있습니다. Anyy는 일반 도구 호출로 현재 세션 역할의 SOUL.md를 저장하고 대화를 계속합니다. 이 도구는 다른 역할이나 표시 이름을 편집할 수 없습니다. 온보딩이 완료되거나 건너뛰어지면 더 이상 노출되지 않습니다.
default를 포함해 온보딩 상태는 재시작 후에도 유지됩니다. 직접 파일 편집이나 CLI Soul 업데이트는 저장된 상태를 재계산하지 않습니다. Soul을 비워도 완료되거나 건너뛴 온보딩은 다시 열리지 않습니다. 완료한 설정을 재시작하거나 다른 결과로 바꿀 수 없습니다. 오래된 완료 요청은 Soul을 바꾸지 않고 거부되며 일반 Soul 편집은 계속 가능합니다.
Soul 작성
Soul은 역할의 정체성과 기본 작업 방식을 정의하는 Markdown입니다. 좋은 Soul 지침은 안정적이고 구체적입니다.
# Scribe
You turn rough notes into concise, structured writing.
- Preserve the author's meaning.
- Ask before inventing missing facts.
- Prefer short headings and concrete language.
유용한 내용에는 다음이 포함됩니다.
- 역할의 목적.
- 말투와 소통 선호.
- 반복되는 우선순위.
- 작업 원칙.
- 여러 작업에 적용할 경계.
일회성 요청, 비밀번호, API 키, 다른 비밀정보는 Soul에 넣지 마세요. 임시 지침은 대화로 보내세요.
이 역할의 작업 방식을 바꿀 최소한의 영속 지침만 작성하세요. 긴 체크리스트는 매 턴 컨텍스트를 소모하며 일관되게 유지하기 어렵습니다.
역할 선택과 편집
역할을 열면 다음을 할 수 있습니다.
- Use를 선택해 프로필의 기본 역할로 지정.
- Soul 편집.
- 표시 이름 변경.
- ID, 온보딩 상태, Soul 경로 확인.
새 세션이 다른 역할을 명시적으로 요청하지 않으면 선택된 역할을 사용합니다. 기존 세션은 자체 역할 정체성을 유지합니다.
기본 default 역할은 항상 존재합니다. Soul은 편집할 수 있지만 이름 변경이나 삭제는 불가능합니다.
역할 삭제
기본 역할 외의 역할은 선택되지 않았고 세션이나 일정이 더 이상 참조하지 않을 때만 삭제할 수 있습니다. 먼저 다른 역할로 전환한 뒤 참조를 제거하거나 업데이트하세요.
삭제는 역할 레코드를 보관 처리하고 활성 선택에서 제거합니다. Soul 파일은 남습니다. 보관 레코드는 anyy role list --include-archived로 확인합니다. 공유 프로필 메모리, 워크스페이스, 채널, 스킬, 다른 역할은 유지됩니다.
대응 CLI
anyy role list
anyy role get scribe
anyy role create scribe --display-name "Scribe"
anyy role update scribe --soul-file ./SCRIBE.md
anyy role use scribe
anyy role delete scribe
특정 Anyy 홈에는 --home PATH, 스크립트에는 --json을 사용하세요.
문제 해결
| 문제 | 해결 |
|---|---|
| 역할 ID 거부 | 소문자나 숫자로 시작하고 소문자, 숫자, -, _ 사용 |
| 온보딩이 대기 또는 활성 | Dashboard에서 비어 있지 않은 Soul 저장 |
| 역할 삭제 불가 | 다른 역할 선택 후 세션 또는 Cron 참조 제거 |
| 새 채팅이 잘못된 정체성 사용 | 선택 역할 확인 또는 세션 생성 시 --role ROLE_ID 전달 |
| 비공개 메모리나 자격 증명이 필요함 | 다른 역할 대신 별도 프로필 생성 |
역할이 공유하는 개인 컨텍스트 관리는 메모리로 이어가세요.