context.agents.run(...)，為伺服器端的工作流程加入多步推理。另有互動式 CLI 可驅動並檢視同一批 agent。
定義 agent
在設定至少宣告一個[[agents]] 區段之前，agents 都是關閉的：
上表未列出的鍵都會直接傳遞給生成，因此
temperature、top_p 等設定可照寫。
agent 定義會在啟動時驗證，而不是等到第一次執行：未知的 buttress/ 模型、找不到的提示檔案、格式錯誤的工具名稱或重複的 agent 名稱，都會讓伺服器直接報錯停止，而不是默默略過該 agent。
全域選項
[agents_options] 會套用到每個 agent：
模型
model 的格式是 provider/model-id，以第一個斜線切分，因此 model id 本身可以含有斜線。
buttress/<repo_id> 指向這台伺服器已經載入的模型。該 id 必須對應到某個已設定的 ggml-llm 或 mlx-llm [[generators]] 項目的 repo_id，伺服器會在啟動時檢查。流量透過行程內的 loopback 抵達 generator — 不經過 socket，也不需要額外設定。你不需要啟用 [openai_compat]；該鍵仍然只管外部的 HTTP 路由。
anthropic/…、openai/…、google/… — 並以該供應商慣用的環境變數（ANTHROPIC_API_KEY、OPENAI_API_KEY 等）進行驗證。請在 [env] 或行程環境中設定。
不支援以 OAuth 登入供應商。使用雲端供應商時，環境中必須有 API key。
工具
tools 必須逐一列出本地函式名稱。每次工具呼叫都會走一般的函式執行器，因此工具會取得與透過 HTTP 或 MCP 呼叫時相同的延遲重新載入、暫存目錄、行程追蹤與 meta.timeout 期限 — 而模型看到的參數結構就是該函式的 meta.parameters JSON Schema。
中止一次執行時，會一併中止進行中的工具呼叫，以及這些呼叫所產生的行程。
若列出的函式並不存在，該次執行會直接失敗，而不是讓無人值守的自動化流程繞過缺少的能力自行發揮。
MCP 伺服器
[agents.mcp_servers.<name>] 可在本地函式之外，額外加入某個 MCP 伺服器的工具。每個伺服器只能指定 url（Streamable HTTP）或 command（stdio）其中一項：
mcp__github__create_issue — 因此不會與本地函式名稱衝突。伺服器會在第一次需要它的執行時延遲連線；若某個伺服器無法連線，該次執行會直接失敗，除非它標記了 optional = true，此時 agent 會在沒有該伺服器工具的情況下繼續執行。
執行 agent
從本地函式
這是主要的使用介面。每個已設定的 agent 都可透過context.agents 取用：
一次執行會沿用呼叫端函式的生命週期與期限：
context.signal — 函式的 meta.timeout 到期，或呼叫端斷線 — 會中止該次執行及其工具呼叫。agent 迴圈比一般函式呼叫慢得多，因此請調高 meta.timeout，或把工作移到沒有期限的 daemon。
agent 的進度會映射到函式自己的 SSE 串流上，成為 agent 事件，因此函式的 SSE 呼叫端不需額外接線就能看到 agent 的執行過程。
若伺服器沒有設定任何 [[agents]]，上述每個方法都會拋出例外。
透過 HTTP
AGENT_RUN_FAILED，並附上 sessionId，因此仍然可以取得逐字記錄。被中止的執行回應 499，其他失敗回應 500。找不到的 agent 與 session 回應 404 NOT_FOUND。
串流回應攜帶的是精簡過的 agent 事件：不含部分完成的助理訊息與完整工具結果，因為那會讓串流負載過於龐大。需要完整記錄時，請改從 sessions 端點取得逐字記錄。
從 CLI
bricks-buttress agent 是一個串流式聊天用戶端，用來連線執行中伺服器上的 agent。只要指向伺服器所使用的同一份設定檔，它就會自行找出連接埠與本機 token：
聊天過程會即時串流文字、思考內容與工具呼叫。在聊天中，
/exit 可離開，/new 可開始新的 session，Ctrl+C 會中止目前的執行 — 再按一次 Ctrl+C 則離開。
執行結果
context.agents.run 與 POST /agents/<name>/run 都會回傳：
stopReason 為 end_turn（agent 已作答）、max_turns、token_budget、aborted 或 error 其中之一。除 end_turn 外，都應視為未完成的回答。
Sessions
每次執行都屬於某個 session。省略sessionId 就會開啟新的 session；把它傳回則接續該對話；若同時加上 fork: true，則會分支出一個新的 session 並記下其來源，原本的 session 維持不變。
session 是 sessions_dir 底下的 JSONL 檔案，以 agent 名稱區分範圍，並在執行串流的同時寫入 — 因此被中止或逾時的執行仍會留下可接續的逐字記錄。
同一個 session 上的執行會依序排隊；不同 session 則平行執行。
清理機制會依存留時間（session_max_age）與數量（session_max_count，以每個 agent 計）清除舊的 session。
session 是以 agent 的
name 區分範圍。重新命名 agent 會讓既有的 session 失去歸屬 — 檔案仍留在磁碟上，但更名後的 agent 不會列出或接續它們。安全性
/agents 的驗證方式與本地函式介面相同，而非比照開放的推論端點：
- 已繫結的伺服器需要 workspace 存取 token。請參閱工作區繫結。
- 未繫結的伺服器會完全拒絕遠端呼叫，除非設定
[agents_options] allow_unauthenticated = true。 - 跨站的瀏覽器請求一律遭到拒絕。
sessions_dir 旁寫入一個臨時的執行階段 token 檔案 runtime-token，權限為 0600。同一台主機上的工具 — 例如上述 CLI — 會讀取它並自動完成驗證，無論伺服器是否已繫結。
agent 定義屬於受信任的輸入，與設定檔和函式檔案一樣。agent 的安全性取決於你交給它的函式與 MCP 伺服器：決定何時呼叫它們的是模型，因此請只給 agent 完成工作所需的最小工具清單。
已繫結的伺服器無法為自己簽發 workspace token — 連向 buttress/ 模型的 loopback 改以內部 token 授權，絕不使用 workspace 憑證。
範例
伺服器套件內附config/function-samples/run-agent.ts，這是一個驅動已設定 agent 並回傳其結論、session id、輪數與停止原因的本地函式。config/sample.toml 中也帶有一段註解掉的 [[agents]] 區塊。其餘範例請參閱本地函式。
後續步驟
本地函式
撰寫 agent 要當作工具使用的函式。
設定
完整的 TOML 參考，包含 agent 執行所依賴的 generator。