Docs

AI 代理

AI 代理是在工作區中反覆使用的一套身份、能力和執行配置。

AI 代理是 Multica 工作區中的協作者。你可以把任務分配給它、在評論中 @它,或直接和它對話。它會透過繫結的執行時呼叫 AI 程式設計工具,並把進度和結果寫回工作區。

AI 代理不會一直在後臺執行。它儲存的是一套可以反覆使用的身份和配置,收到工作時才產生具體的執行。

AI 代理的配置項

配置作用
名稱、頭像和描述讓團隊知道它是誰、適合做什麼。描述只用於展示,不會進入執行提示。
指令規定它的職責、工作方式、邊界和交付要求。每次執行都會使用。
對話開場建議提供最多三條針對該 AI 代理的示例,出現在別人與該 AI 代理開始新對話時。選擇後只會填入輸入框,不會傳送。
Skills提供可以重複使用的方法、參考資料和支援檔案。
執行時、模型和思考強度決定在哪個執行時、用哪款 AI 程式設計工具和哪個模型執行;部分工具(如 Codex)還可選擇速度檔。
Access決定哪些成員可以執行它。
執行配置包括併發上限、環境變數、CLI 引數、MCP 和外部整合。

更換模型或修改指令不會建立新 AI 代理,過去的任務、評論和執行記錄也不會丟失。

AI 代理、執行時和執行

概念職責
AI 代理決定誰來做、按什麼方式做
執行時決定在哪臺電腦、用哪款 AI 程式設計工具執行
執行記錄這一次執行的過程和結果

一個執行時可以承載多個 AI 代理;一個 AI 代理也可以先後完成多次執行。執行時離線時,AI 代理的身份和歷史仍在,但新的執行需要等待執行時恢復。

參與工作的方式

  • 負責任務:把 AI 代理設為負責人,執行入隊後開始處理。
  • 處理一條評論:在評論中 @ AI 代理,不改變任務的負責人。
  • 繼續討論:回覆 AI 代理的評論,新的資訊會進入後續執行。
  • 直接對話:開始一段不依附於任務的對話。
  • 參與專案和小隊:AI 代理可以成為專案 lead,也可以擔任小隊隊長或小隊成員。
  • 透過自動化執行:按時間表或外部事件觸發預設工作,也可以手動執行。

AI 代理可以建立任務、發表評論和修改工作狀態,但它沒有收件箱,也不會收到 @all。對 AI 代理的 @提及是一次執行觸發,不是通知。

權限與 Access

每個 AI 代理都有一名 owner 和一個 Access 設定(介面上叫"訪問權限")。Access 決定誰可以執行它,也就是把任務分配給它、在評論中 @它或和它對話:

Access誰可以執行
僅自己(Only me)只有 AI 代理 owner。
整個工作區(Entire workspace)工作區中的所有成員。
指定成員(Specific people)AI 代理 owner 和指定的成員。

新建 AI 代理預設使用 僅自己。下面的演示從"僅自己"開始,依次切到另外兩檔,同時列出每位成員在負責人選擇器和 @提及選單裡看到的結果。

動手試試Ops helper · Access
Who can run this agent
Who can run this agent
What each member sees
  • YouAgent owner
    Assignee picker
    Can pick
    @mention
    Starts a run
  • Lei LiMember
    Assignee picker
    Not listed
    @mention
    Not listed
  • Meimei HanMember
    Assignee picker
    Not listed
    @mention
    Not listed
You own Ops helper, and right now only you can run it.

工作區 owner 和 admin 可以檢視並管理所有 AI 代理,但不能繞過 Access 執行別人的"僅自己"AI 代理。

執行之外的操作按下表劃分:

操作誰可以
在 AI 代理列表和選擇器中看到它AI 代理 owner、工作區 owner 和 admin,以及 Access 授權的成員
修改配置AI 代理 owner、工作區 owner 和 admin
修改 Access只有 AI 代理 owner

環境變數和 MCP 等可能包含憑據的配置有更嚴格的讀取規則,見建立和配置 AI 代理。

線上、離線和工作狀態

AI 代理列表會同時展示兩類狀態:

  • 可用性來自執行時,例如線上、離線或不穩定。
  • 工作負載來自執行,例如處理中、排隊中或空閒。

"離線"不表示 AI 代理被刪除。已經入隊的執行會等待執行時恢復;"已歸檔"才表示它不能再接收新工作。

歸檔和恢復

不再使用的 AI 代理可以歸檔。歸檔後,它不再出現在選擇器中,也不能被分配或 @提及;歷史記錄保留,之後可以恢復。

歸檔會取消該 AI 代理所有尚未結束的執行,包括排隊中和進行中的執行。

AI 代理 owner 和工作區 owner、admin 都可以歸檔或恢復 AI 代理。

接下來

本頁目錄