斜線指令
bot 註冊一個根指令,除非你設了 discord.rootCommand,否則就是 /roundtable。
所有有指令的功能,都把子指令加在這個根指令底下,所以指令清單集中在一處。
根指令在伺服器裡,以及與 bot 的私訊裡都能用。
它的描述,英文是 <name> control panel (owner only),其中 <name> 是設定裡的 name。
locale: "zh-TW" 時,下面的描述是繁體中文。
核心註冊的指令
Section titled “核心註冊的指令”核心註冊一個子指令群組:schedule。
| 指令 | 描述 | 誰能用 |
|---|---|---|
/roundtable schedule list |
List the schedules of every channel | owner |
/roundtable schedule cancel id:<schedule> |
Cancel a schedule | owner |
群組本身的描述是 Schedules,cancel 的 id 選項的描述是 The schedule to cancel。
id 選項是必填,輸入時會自動補全,每個排程列成 #<id> <title> (<recurrence>)。
schedule list
Section titled “schedule list”list 顯示每個頻道的所有排程。
每一筆會列出排程的 id、標題、頻道、目標、重複的方式、下次執行的時間、設定的人,以及上次執行的時間和結果。
沒有排程時,它回答 No schedules right now.
頁尾說明,排程是由 bot 在對話裡建立和修改的,這個指令是用來檢視和取消排程。
schedule cancel
Section titled “schedule cancel”cancel 刪除選到的排程,並在標題 Schedule cancelled 底下再顯示它一次。
如果值不是數字,它回答 Pick a schedule from the list.
如果沒有任何排程有那個 id,它回答 There is no schedule #<id>.
要建立或修改排程,請對 agent 說;見排程與背景工作。
只有 owner(任何一位)能用 /roundtable,以 Discord 使用者 id 檢查。
每個回應都只有執行指令的那個人看得到。
其他人會得到一個標題為 Owner only 的面板,內容說 /roundtable 是 assistant 的 owner 的控制面板,後面接著你在 discord.refusalHint 設定的文字。
自動補全不會給非 owner 任何選項。
核心的指令只給 owner 用;admin 和 member 是在各自的頻道裡跟 agent 說話。
見存取層級。
不是指令的按鈕
Section titled “不是指令的按鈕”Discord 裡有三種東西會回應點擊,但不是斜線指令:
- 被擱置的動作和
ask_user問題的卡片。它們的按鈕是Run和Cancel,或是回答的選項。一組問題放在同一張卡片上:每題一個選單,加上寫答案/備註…(開啟表單寫答案和備註)和送出(旁邊有取消),選項有預覽時還有預覽。取消會告訴 agent 你不回答這個問題,它不會再問。誰能回應,見存取層級。 - 執行到時間上限(內建 runtime 的預算,預設 10 分鐘,或上限,預設 30 分鐘,由
turnLimits設定)的那一輪的卡片:寫出是哪個上限、這一輪正在做什麼和到目前為止用過的工具,附繼續(再給一次完整預算)和取消。在turnLimits.cardSeconds(預設 5 分鐘)內沒有回答,這一輪就會被中止。 - 長時間的一輪上的
Stop按鈕。只有 owner 能按。它回答Stopped.;那一輪已經結束時回答Nothing is running right now.;對其他人則回答Only <name>'s owner can stop it.
外掛用 setup 裡的 commands.add,在根指令底下加自己的子指令,也可以另外加自己的最上層指令。
名稱重複,或外掛自己註冊根指令,會讓啟動停下來,訊息會指出那個指令。
見外掛能新增什麼。
agent 面板預設不會註冊。
pi-roundtable/discord 匯出 agentPanel,它建出一個 agent 的面板,給想為它加子指令的外掛使用。