跳到內容

斜線指令

bot 註冊一個根指令,除非你設了 discord.rootCommand,否則就是 /roundtable。 所有有指令的功能,都把子指令加在這個根指令底下,所以指令清單集中在一處。 根指令在伺服器裡,以及與 bot 的私訊裡都能用。

它的描述,英文是 <name> control panel (owner only),其中 <name> 是設定裡的 name。 locale: "zh-TW" 時,下面的描述是繁體中文。

核心註冊一個子指令群組: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>)。

list 顯示每個頻道的所有排程。 每一筆會列出排程的 id、標題、頻道、目標、重複的方式、下次執行的時間、設定的人,以及上次執行的時間和結果。 沒有排程時,它回答 No schedules right now. 頁尾說明,排程是由 bot 在對話裡建立和修改的,這個指令是用來檢視和取消排程。

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 說話。 見存取層級。

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 的面板,給想為它加子指令的外掛使用。