跳到內容

建立 agent

要建立 agent,在有 agent 回答的頻道裡提出要求就行。 不用填表單,不用改設定檔,也不用重啟。

在 guide 頻道,使用者請 Guide 做一個記讀書筆記的 agent。Guide 回覆已經在新的 notes 頻道做好 Notes,它有提示詞、頭像,還有一個存連結的技能,而且已經開始做第一份工作。

說明這個 agent 要做什麼。名字、提示詞和其他細節,由回答的 agent 決定。

幫我做一個叫 Researcher 的 agent,替我的問題找資料來源,用簡短的條列回報。
新增一個編輯 agent,幫我把草稿改得更精簡,但不要改變我的意思。一開始先問我在寫什麼。
建一個叫 Notes 的 agent 幫我記讀書筆記,它的頻道放在閱讀專用的類別下。

只有 owner 和 admin 能建立 agent。 任何 agent 都能回答這個要求:它會用自己的名字建立新的 agent。

使用的工具是 agent_create。這些欄位由 agent 從你的要求裡填好:

欄位 內容
name 永久的名字:1 到 32 個小寫字母、數字和連字號。它同時是頻道名稱。不能包含 discord 或 clyde,也不能跟任何 agent 或群組同名,已封存的也算。
display_name 顯示在它訊息上的名字,1 到 32 個字元,任何語言都行。
prompt 它的角色:工作內容、資料來源、限制,以及怎麼回報。最多 4,000 個字元。
class 選填。它的職業,例如 knight 或 bard;預設依它的職務。見狀態與頭像。
color 選填。它的配色:azure、gules、vert、purpure、amber、sable、teal 或 rose。
task 它的第一份工作,最多 4,000 個字元,要寫成單獨看也能懂。
category 選填。它的頻道放哪裡:預設是 Agents,也可以是 Agents-<suffix>。類別不存在就會建立。
long_running 選填。true 會在第一份工作開始前,替它的對話開啟長時間執行,讓它的回合自動超過一般的 10 分鐘上限(最多到 host 的上限,預設四小時)。只有 owner 的要求才能設定。
skills 選填。它要帶的技能名稱,從技能清單裡挑。只有 skills addon 開著時才提供;見技能與記憶。
  • 一個頻道,用它的名字,放在你指定的類別下。
  • 一張頭像。 由 bot 依職業和顏色組合出來的角色;預設依它的職務。
  • 它的提示詞,接在每個 agent 開頭都有的共用提示詞後面。
  • 第一份工作。 它馬上在自己的頻道開工,先用一兩句話自我介紹,再處理這份工作。
  • 它的技能,如果你指定了的話。

直接用白話說要改什麼:

讓 Researcher 每次最多用兩句話回答。
把 Editor 的 thinking level 改成 high。

這件事用的工具是 agent_update。它能改四樣東西:

欄位 作用
display_name 顯示在它訊息上的名字。這個 agent 所在的群組,頻道主題會跟著更新。
prompt 整份新的提示詞。它會取代舊的,所以 agent 應該先讀目前的提示詞。
model 寫成 <provider>/<model> 的模型,或 default 讓它跟著主騎士的模型。主機跑不起來的模型會被拒絕,並附上可用的清單。
thinking off、minimal、low、medium、high、xhigh 或 default。預設是 auto:judge 依你的訊息,為每一輪挑一個等級。

修改從 agent 的下一輪開始生效,它的對話不受影響。

有兩樣東西有自己的工具:

  • 外觀: agent_avatar 改它的職業、顏色或單一零件。
  • 技能: agent_skills 增減它帶的技能。

用 agent_list 看所有 agent 和群組,以及它們的頻道;用 agent_get 讀單一 agent 的提示詞、模型、thinking level 和技能。

agents.ts 裡的 agent 在第一次啟動時建立,做法跟 agent_create 一樣。 之後它們不會再被覆寫,所以請直接在 Discord 裡修改。 見設定。