跳到內容

存取層級

每一則開啟一輪的訊息,都來自一位說話的人(speaker),每位 speaker 都有一個層級。 層級共有三個,由信任程度高到低是 owner、admin 和 member。 三個都不屬於的人,就是無關的人:bot 不回答,也不開啟任何一輪。

access 底下沒有 admins 或 members 時,只有 owner 能跟 agent 說話。 owner 是列在 access.owners 的人;roundtable init 會把你寫成第一位,用你的 Discord 使用者 id。 其他 bot 的訊息會被忽略。agent 伺服器不擁有的頻道也一樣:只有 agent 和群組的頻道會得到回答。

在 roundtable.config.ts 的 access 底下列出人。 每個層級可以填身分、角色,或所有人:

export default {
// ...
access: {
owners: [
{
name: "Ada",
principal: env("OWNER_ID"),
identities: [`discord:${env("OWNER_ID")}`],
},
],
admins: { identities: ["discord:<user id>"] },
members: { roles: ["discord:role:<role id>"] },
},
} satisfies RoundtableConfig;
欄位 型別 作用
identities 字串清單 寫成 <provider>:<subject> 的帳號,例如 discord:<user id>。
roles 字串清單 寫成 <surface>:role:<name> 的角色,例如 discord:role:<role id>。擁有其中一個角色的人都符合。
everyone true、false,或 surface 的清單 true 讓每個 surface 上的每個人都符合;清單(例如 ["discord"])則只限那些 surface。

一個人會得到他符合的最高層級:先看 owner,再看 admins,最後是 members。 everyone 在 admins 和 members 底下都能用。 放在 admins 底下,會讓每個在 agent 頻道裡寫字的人都成為 admin,所以最多只放在 members。 用 roundtable principal link 把幾個帳號連到同一個 principal,它們就是同一個人,只有一個層級。

0.8 的寫法,也就是 owner 加上以 Discord 使用者與身分組 id 寫的 speakers,仍然可用,但會印出棄用警告。 roundtable upgrade 會把它改寫成 access;兩種寫法不能混用。

只有在 speaker 的層級不低於工具的最低層級時,這個工具才會提供給他。 下表是核心和內建 addon 宣告的層級。 每個工具和它的層級,完整列在 agent 工具參考。

層級 能用
member 跟 agent 說話,並回答它們提出的問題。讀附件。列出和讀取 agent(agent_list、agent_get)、讀取頻道(channel_read)、傳訊息給 agent(message_agent)。使用記憶(memory_add、memory_search、memory_remove),以及列出排程(schedule_list)。
admin member 能做的一切,加上建立與修改 agent 和群組、封存它們、整理頻道、修改技能與 agent 的技能、建立與修改排程,以及委派任務。
owner 其餘的一切:shell 和檔案工具、notify、discord_* 管理工具、所有沒有宣告較低層級的外掛工具,以及 /roundtable 斜線指令。

另外有幾點:

  • 每位 speaker 有自己的記憶,由所有 agent 共用。member 的 memory_add 不會寫進 owner 的記憶。
  • 執行很久的那一輪會出現停止按鈕,只有 owner 按了有效。
  • 被擱置的動作,例如具破壞性的 shell 指令,會在一張卡片上等待核准。預設由讓它暫緩的那一輪的 speaker 核准,只要他的層級仍足以執行這個呼叫;在共用對話裡,owner 也可以在卡片上或用確認訊息核准。私人對話裡別人都不能核准,高於 speaker 層級的呼叫在那裡也不會被核准。
  • agent 用 ask_user 提出的問題,那一輪的 speaker 可以回答,在共用對話裡 owner 也可以。一組問題放在同一張卡片上,誰能回答也一樣;卡片上的「預覽」按鈕只是顯示預覽,所以看得到卡片的人都能按。送出旁邊的取消按鈕讓能回答的人取消這個問題:agent 會被告知它被取消了,不會再問。

toolTiers 用工具名稱,設定能使用該工具的最低層級:

export default {
// ...
toolTiers: {
delegate_task: "member",
memory_remove: "admin",
},
} satisfies RoundtableConfig;

這個設定的優先權高於其他一切。 沒有它的時候,工具需要外掛宣告的層級;外掛沒宣告,就用核心的預設;都沒有人指定的工具,則需要 owner。 每個值必須是 "owner"、"admin" 或 "member"。

其他 speaker 看到什麼:guest prompt

Section titled “其他 speaker 看到什麼:guest prompt”

owner 以外的每位 speaker(admin 和 member 都算)拿到的是 guest prompt,不是共用提示詞。 agent 也會多收到一段文字,寫明這位 speaker 的名字、Discord 使用者 id 和層級,並告訴 agent 要稱呼他、採用他的回答和核准,以及高於他層級的工具在這一輪無法使用。 他們的訊息送到 agent 時,前面會加上 (Message from <name>, at the <tier> tier.)。

guest prompt 用檔案路徑設定,跟共用提示詞並排:

export default {
// ...
prompts: {
shared: "./persona/shared.md",
guest: "./persona/guest.md",
},
} satisfies RoundtableConfig;

兩個檔案都只在啟動時讀一次。 檔案讀不到或是空的,啟動就會停下並指出是哪個鍵,例如 config prompts.guest: <path> is empty. Write the prompt in it.

沒有設 prompts.guest 時,使用套件附帶的 guest prompt。 它告訴 agent:對方是這個伺服器的訪客,agent 不代表 owner 發言,owner 的私人事實仍屬於 owner,而存進記憶的內容只屬於這位訪客。