跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt

Use this file to discover all available pages before exploring further.

AI 代理是 CTOR 的核心。它可以讀取和寫入檔案、編輯程式碼、執行 shell 指令，以及透過聊天介面搜尋您的專案。 本頁介紹專案工作階段，繫於單一 BRICKS 應用程式。若要進行建立新專案等工作區層級的工作流程，請參閱開始聊天。

​
建立工作階段

  1. 在側邊欄中選取應用程式
  2. 點擊新增工作階段
工作階段會持久儲存，並根據您的第一則訊息自動命名。每個工作階段都有自己的對話歷程和模型選擇。

​
選擇模型

點擊輸入列中的模型選擇器來挑選 AI 模型。模型依服務商分組：
  • Anthropic —Claude Sonnet 4.6、Claude Opus 4.6、Claude Haiku 4.5
  • OpenAI —GPT-5.3 Codex、GPT-5.2 Codex、GPT-5.2、GPT-5.1 Codex Mini
  • OpenAI Codex —GPT-5.3 Codex、GPT-5.2 Codex
  • Google —Gemini 3 Flash、Gemini 3 Pro
  • GitHub Copilot —來自各服務商的多種模型
  • OpenAI Compatible 端點 —具有每個端點模型清單的自訂端點（Ollama、vLLM、LM Studio 等）
清單中只會顯示已設定 API 金鑰的服務商。請參閱設定以設定您的 API 金鑰。

​
設定思考深度

點擊模型選擇器旁邊的思考選擇器，以控制代理的推理深度：
等級預算使用情境
關閉—快速回應、簡單任務
高~16k tokens大多數任務，速度與深度的良好平衡
最大~32k tokens複雜推理、架構決策
最大思考深度僅適用於支援擴展思考的模型：Claude Opus 4.6、GPT-5.3 Codex、GPT-5.2 Codex 和 GPT-5.2。

​
傳送訊息

在輸入列中輸入訊息，然後按 Ctrl+Enter（或點擊傳送按鈕）。使用 Shift+Enter 換行。 代理會即時串流回應。您可以看到：
  • 文字回應，支援完整的 Markdown 渲染和語法醒目標示
  • 思考區塊，顯示模型的推理過程（可展開，需啟用顯示思考內容）
  • 工具呼叫，以可展開的區塊顯示工具名稱和參數
  • 工具結果，顯示每個工具執行的輸出
點擊中止可隨時停止正在執行的回應。

​
提及檔案

在輸入列中輸入 @ 以搜尋專案中的檔案。選取檔案後，其路徑會包含在您的訊息中，讓代理知道要處理哪些檔案。
  • 在資料夾名稱後輸入 / 可瀏覽目錄
  • 使用方向鍵導覽，按 Enter 或 Tab 選取
  • 最多顯示 20 個結果

​
使用技能

在輸入列中輸入 / 以觸發技能指令自動完成。選取技能後，其指示會作為代理的上下文注入。 所選技能會以可移除的標籤顯示在輸入列中。代理會收到技能的內容以及您的訊息。 如需建立和管理技能的詳細資訊，請參閱技能參考。

​
附加圖片

點擊圖片附件按鈕或從剪貼簿貼上圖片。支援格式：PNG、JPG、JPEG、WebP、GIF。 圖片會以 base64 編碼內容的形式連同文字訊息一起傳送給模型。

​
工具呼叫和審核

代理有六個內建工具：read_file、write_file、edit_file、bash、glob 和 grep。 當代理執行 bash 指令時，您會看到審核提示：
  • 點擊執行以執行指令
  • 點擊拒絕以拒絕執行
在設定 > 代理中啟用自動核准 bash 指令，可跳過所有 bash 指令的審核提示。
符合危險指令模式的指令——sudo、rm -rf、改寫歷史的 git、curl ... | sh 等——即使啟用自動核准或專案處於沙箱模式，仍會以紅色邊框和危險指令標籤顯示提示。
如果您已設定 MCP 伺服器，其工具也會與內建工具一起提供給代理使用。

​
工作區設定檔

沙箱模式選擇器旁的標籤會顯示代理目前作用於哪個 BRICKS 工作區。在專案聊天中，此標籤為唯讀——CTOR 會以專案的 workspaceId 比對您已驗證的設定檔，找不到對應時則會退回使用作用中的設定檔。 若要讓代理在不同工作區執行，請先從設定 → 帳號或從主聊天輸入列切換設定檔，再開啟專案。

​
子代理

代理可以將任務委派給專門的子代理。子代理以專注的工具集和指示執行，非常適合程式碼庫探索或程式碼審查等有範圍限制的任務。 您可以從側邊欄管理子代理。如需建立和設定子代理的詳細說明，請參閱子代理參考。

​
本機裝置

點擊輸入列中的本機裝置按鈕，掃描您本機網路上的 BRICKS Foundation 裝置與 BRICKS Buttress 伺服器。對話框會以平行方式進行兩種掃描，其中一邊失敗不會清空另一邊的清單。 Foundation 裝置列會顯示位址、版本與下列標記：
  • 此工作區 — 裝置已綁定至與目前專案相同的工作區
  • CDP — 裝置支援 Chrome DevTools Protocol
Buttress 伺服器列以紫色強調色與專屬標記呈現：
  • JWT required ／ open — 伺服器是否已繫結至工作區、是否需要工作區 JWT
  • verified ／ UDP only — HTTP /buttress/info 探測是否成功，或僅看到 UDP 通告
  • 此工作區 — 伺服器已繫結至與目前專案相同的工作區
點擊任一卡片可切換選取狀態，支援多選，但兩種類型互斥（選取 Buttress 伺服器會清除 Foundation 的選取，反之亦然）。 底部按鈕會依選取項目改變：
  • Foundation 裝置 → 檢查或部署會插入由 bricks-cli 技能執行的 /bricks-cli 提示。
  • Buttress 伺服器 → 請代理進行整合會插入 /bricks-ctor 提示，附上各選取伺服器的識別資訊、工作區相符狀態與通告中的 generator 能力。整合規則由 bricks-ctor 技能提供 — 包括各 generator 類型的模型建議、標準的自動探索 buttressConnectionSettings，以及 iOS 模擬器注意事項（UDP 探索僅在實機上運作）。

​
後續步驟

部署您的應用程式

將您的應用程式發布至 BRICKS 伺服器。