Role
Roleを使うと、1つのAnyy Profile内に複数のアシスタントのアイデンティティを持てます。人格や既定の作業スタイルを変えますが、別ユーザーやデータ空間は作りません。
RoleとProfileの境界
Profile内の全Roleは次を共有します。
- Workspaceとデータベース。
USER.mdとMEMORY.mdのメモリ。- モデル、Tools、Skill、MCP設定。
- ChannelとCronジョブ。
- セッション履歴の境界。
Roleはツール名、ツール権限、Codemodeモードを選びません。ToolsとSessionツール選択で管理します。
話し方や作業方法を変えるならRoleを使います。Home、メモリ、認証情報、設定、履歴を独立させるならProfileを使います。
Roleを作成する
- Dashboard → Rolesを開きます。
- New Roleを選びます。
scribeなど恒久的なRole IDを入力します。- 任意で
Scribeなどの表示名を入れます。 - Create roleを選びます。
Role IDは小文字英字か数字で始め、小文字、数字、ハイフン、アンダースコアを使います。保存パスの一部となり、後で改名できません。表示名は変更できます。
作成後はSoulエディターが開きます。セットアップがpendingかactiveの間に空でないSoulを保存すると、基本のdefaultRoleも含めオンボーディングが完了します。
初回Role会話でも設定を終えられます。Anyyは通常のツール呼び出しで現在セッションのRole SOUL.mdを保存し、会話を続けます。このツールは他Roleや表示名を編集できず、オンボーディング完了／スキップ後は公開されません。
オンボーディング状態はdefaultを含め再起動後も残ります。直接ファイル編集やCLI Soul更新は保存状態を再計算しません。Soulを消しても完了／スキップ済みの設定は再開しません。終了済み設定は再開や別結果への変更ができません。古い完了要求はSoulを変えずに拒否されます。通常のSoul編集は引き続き使えます。
Soulを書く
SoulはRoleのアイデンティティと既定の作業スタイルを定義するMarkdownです。安定した具体的な指示にします。
# 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.
有用な内容は次です。
- Roleの目的。
- 口調や伝え方の好み。
- 継続する優先事項。
- 作業原則。
- タスクをまたいで適用する境界。
一度限りの依頼、パスワード、APIキー、シークレットはSoulに置きません。一時指示は会話で送ります。
Roleの働き方を変える最小限の持続的指示を書きます。長いチェックリストは毎ターンのコンテキストを消費し、一貫性の維持も難しくなります。
Roleを選択・編集する
Roleを開くと次ができます。
- UseでProfileの既定Roleにする。
- Soulの編集。
- 表示名の変更。
- ID、オンボーディング状態、Soulパスの確認。
新セッションが別Roleを明示要求しない場合、選択Roleを使います。既存セッションは自分のRoleを保持します。
基本のdefaultRoleは常にあります。Soulは編集できますが、改名や削除はできません。
Roleを削除する
基本以外のRoleは、選択中でなく、参照するセッションやスケジュールがない場合だけ削除できます。先に別Roleへ切り替え、参照を削除または更新します。
削除はRole記録をアーカイブしてアクティブ選択から除き、Soulファイルは残します。anyy role list --include-archivedで確認できます。共有Profileメモリ、Workspace、Channel、Skill、他Roleは保持します。
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を使います。
トラブルシューティング
| 問題 | 対処 |
|---|---|
| Role IDが拒否される | 小文字英字／数字で始め、英数字、-、_を使う |
| オンボーディングがpending／active | Dashboardで空でないSoulを保存 |
| Roleを削除できない | 別Roleを選び、セッション／Cron参照を削除 |
| 新チャットが別のアイデンティティを使う | 選択Roleを確認するか、作成時に--role ROLE_IDを指定 |
| 非公開のメモリや認証情報が必要 | 別Roleではなく別Profileを作成 |
Roleが共有する個人コンテキストはメモリへ進んでください。