對話模式

對話是代理的駕駛艙:一個全新的沙盒、完整的網路存取、你的所有技能與 Connect，可用於探索、建構、編輯或除錯應用。

什麼時候用對話,什麼時候用應用? 對話適合一次性的工作、探索、除錯。應用適合「我之後還會想再跑這個,可能會按排程跑,可能會用不同的輸入,可能要交給同事跑。」 切換只需一次點擊(Save as App)或一句話(「把這個存成一個應用」)。

對話能做什麼

同一個介面裡有四種操作用途:

1. 探索

在投入做成應用之前先試試這個任務。代理在全新的沙盒裡執行;除非你儲存,否則什麼都不會留下。適合:「我都不確定這件事能不能做」、「讓我試幾種說法看看」、「我只需要一個一次性的答案」。

2. 建構應用

用一個觸發短語(「create an app that…」)來啟動應用建構器技能。代理會用對話帶你走完設計流程, 再透過 API 儲存這個應用。適合:把一段跑通的對話變成可重複使用的工作流。

3. 編輯既有的應用

請代理修改一個既有的應用(「更新 Company Brief,順便加上招募資料」)。應用建構器會抓取該應用、修改它,然後存成一個新版本。適合:不用學應用編輯器介面也能做漸進式改進。

4. 除錯失敗的執行

從應用的歷史紀錄裡打開一次失敗的執行。點擊 Debug in chat：一個對話會帶著這次執行的上下文打開:輸入、部分產物、代理的推理軌跡、錯誤訊息。這下你就可以問代理哪裡出錯了、該怎麼修。適合:「這之前是好的,現在為什麼不行了」。

開啟一個對話

在任何頁面,點擊側邊欄的 + New Chat。
一個空白對話會打開。底部是訊息輸入框,上方是對話區域,頂部是麵包屑。
對話在使用 claude-code 範本的隔離 E2B 沙盒裡執行，代理對暫存檔案系統擁有完整的讀寫權限,可以執行程式碼,但不會碰你的機器或其他對話。

對話介面的版面

┌──────────────────────────────────────────────────────────────┐
│ 📁 My workspace / Chat • 12 MaySave as App ▾ │
├──────────────────────────────────────────────────────────────┤
│ You │
│ Summarize last week's commits in shop-frontend. │
│ │
│ 🤖 Agent [github] · 1.4s │
│ I'll pull commits via GitHub. One moment. │
│ → github.list_commits(repo=shop-frontend, since=...) │
│ ← 47 commits returned │
│ <writes summary as markdown> │
├──────────────────────────────────────────────────────────────┤
│ 📎 Skills: 12 active · Connects: 4 auth │
│ Type your reply… [↵ Send] │
└──────────────────────────────────────────────────────────────┘

麵包屑(頂部)：工作區名稱 / 對話名稱。
Save as App ▾(右上)：下拉選單,包含「Save as App」和「Save into existing App」。在對話變成可儲存之前會是灰色不可點擊。
對話串(中央)：使用者和代理輪流發言。工具呼叫(技能呼叫、Connect 呼叫) 會以輸入 + 輸出的形式內嵌顯示。
狀態列(輸入框上方)：顯示已啟用的技能數量和已授權的 Connect 數量。
附件(📎)：打開檔案選擇器或把檔案拖進對話。
傳送(↵)：Enter 鍵或點擊。

代理能存取什麼

在每一個對話裡,代理都擁有:

沙盒執行環境。 一個使用 claude-code 範本的 E2B 沙盒。可以執行 Python、Node,安裝軟體套件,讀寫暫存檔案系統,發出 HTTP 請求。
網路存取。 搜尋、抓取 URL、渲染頁面、截圖。
已安裝的技能。 你工作區裡的每一個技能都可用。 aitroop-app-create 技能是內建的。
已授權的 Connect。 你授權過的每一個 OAuth 整合。執行開始時,權杖會以環境變數(或透過內部服務呼叫)注入。
對話上下文。 之前的回合、附加的檔案,以及你在對話中打開過的任何產物。

寫好第一則訊息

第一則訊息的品質決定了後續對話的走向。一個有用的範本:

# Task
What you want the agent to do, in one or two sentences.

# Inputs
Specific data points — dates, names, IDs, file references.

# Output
What the result should look like — format, length, structure.

# Constraints
What to include, what to skip, language, tone.

你不必每次都套這個範本。但當代理的輸出少了點什麼時,缺的那塊通常就是這四項之一，補上再試一次。

範例:一則寫得好的第一則訊息

# Task
Summarize this week's customer support tickets.

# Inputs
Tickets in HubSpot, status=open, last 7 days.

# Output
One-page Markdown brief with:
- Top 3 themes (one bullet each)
- Escalations (with ticket IDs)
- Sentiment trend vs prior week

# Constraints
Skip tickets marked as spam.
Executive tone, no jargon.

附加檔案

把檔案從你的機器拖進對話,或點擊 📎 附件按鈕。
檔案上傳後,會以小標籤的形式出現在輸入框上方。
代理可以在沙盒裡讀取這個檔案，可以解析、轉換、摘要。
附件只屬於這次對話。它不會跟著你去到其他對話。

支援的檔案類型

文字: .txt、.md、.csv、.json、.xml、.yaml。
文件: .pdf、.docx、.xlsx、.pptx。
圖片: .png、.jpg、.gif、.webp、.svg。
程式碼: 任何原始檔。代理會辨識語言並相應地渲染。
壓縮檔: .zip、.tar.gz：代理可以列出內容並解壓縮。

關於檔案的幾個小提示

在提示中提到這個檔案。「從附件合約中萃取關鍵日期。」代理並不會總是主動去看附件。
如果是應用的輸入,別在對話裡附加。 改用一個 file 類型的 AppInput, 這樣使用者每次執行時都重新上傳新的檔案。
大型 CSV: 代理會分段讀取;大約 100MB 以內都運作良好。

代理如何使用技能

你不需要用名字去呼叫技能。代理會根據任務自行決定何時呼叫它們。一旦呼叫,你會看到呼叫過程內嵌顯示:

🤖 Agent [web-search] · 2.1s
Let me search the web for recent news.

→ web-search(query="Stripe funding 2025", limit=10)
← 10 results: ["Stripe raises Series H...", ...]

<agent continues with results in context>

最重要的內建技能:應用建構器

aitroop-app-create 技能會在你的訊息中出現觸發短語時自動啟動:

「Create an app that…」
「Build me a workflow for…」
「I want an app to…」
「Make an automation that…」
「Update my app…」

觸發短語不分大小寫,也不在意前後文。「I'd like an app to summarize emails」和「Create an app that summarizes emails」一樣能觸發它。

查看目前啟用了哪些技能

看一下輸入框上方的狀態列，它會顯示一個計數(「Skills: 12 active」)。點擊會展開清單。或者直接問代理:

> what Skills do I have available?

代理如何使用 Connect

Connect 是隱形運作的。代理會用你授權過的 OAuth 權杖去讀取或寫入外部系統。你不必特地提到 Connect 的名字。

第一次授權

代理判斷它需要一個你還沒授權的 Connect(例如,使用者請它讀「我未讀的 Gmail」)。
代理會暫停,並顯示一個授權提示:
🔒 This chat needs Gmail access to read your inbox.
[ Authorize Gmail ] [ Skip ]
點擊 Authorize Gmail。一個彈出視窗會打開 Google 的 OAuth 畫面。
批准平台所要求的權限範圍。
你會被帶回到對話。代理從它暫停的地方繼續。

之後的執行

第一次授權之後,後續的對話和執行會無聲地使用該 Connect，不再有提示。可以隨時在 Settings → Connects 中撤銷授權。

寫入操作的確認

對於具備寫入能力的 Connect 動作(寄電子郵件、建立 CRM 記錄、修改檔案),代理會把它打算做的事展示給你,並等待你明確的批准:

🤖 Agent About to send this email via Gmail:
  To:     [email protected]
  Subject: Following up on yesterday's call
  Body:    Hi Jane, thanks for the time yesterday...

  [ Send ] [ Edit first ] [ Cancel ]

一則訊息如何變成一個回合

對話框看起來就是一個大大的文字欄位,但它底下,每一次傳送都會經過一個小巧、叢集安全的訊息佇列。花兩分鐘搞清楚裡面發生了什麼是值得的，它解釋了你以後所有「我訊息怎麼沒送出去?」的問題。

狀態機

pending  →  dispatching  →  sent

                    dispatching  →  pending (瞬時失敗,嘗試次數 < 5)

                    dispatching  →  failed (嘗試 5 次之後)

你按下傳送。 伺服器會插入一筆 app_message 列,狀態為 status: 'pending',帶一個會話內單調遞增的 position,以及一個 priority(預設是掛鐘時間,這樣訊息會依傳送順序執行)。UI 會立刻把這一列渲染成「Sending…」。
有一個 worker 來認領它。 叢集裡的伺服器都在監聽 Postgres 的 queue_dispatch 頻道;寫入端在插入後也會發出 NOTIFY。誰贏了競速, 誰就用 SELECT … FOR UPDATE SKIP LOCKED 依 priority DESC, position ASC 排序認領這一列,把它翻成 dispatching, 並把 attempts 加一。
執行器開跑。 Worker 把訊息交給代理執行器(通訊協定詳見核心概念)。JSONL 事件會回傳;每一筆都會即時扇出到對話的 SSE 訂閱者。
完成。 成功的回合 → 這一列變成 sent。瞬時錯誤 (network、session_expired 等)→ 這一列回到 pending, 等下一個 worker 來認領。5 次失敗之後,這一列變成 failed,UI 會顯示捕獲到的 last_error。

每個會話一次只允許一個回合

資料表結構透過一個部分唯一索引強制每個會話最多只有一筆處理中的使用者訊息,該索引建在 session_id 上,過濾條件是 status = 'dispatching' AND role = 'user'。就算你在第一筆還沒進入 dispatching 之前就傳了第二筆,第二筆也會卡在 pending 裡等第一筆結束，不會有交錯的回合,也不會出現兩個 Claude 回應之間的競態。多執行個體派發絕對不可能破壞這一點;資料庫就是事實的唯一來源。

從崩潰的 worker 中恢復

Worker 可能在派發途中掛掉，Kubernetes 驅逐了一個 pod、某個節點崩潰了。一個獨立的恢復輪詢器每 60 秒掃描一次,尋找那些卡在 dispatching 超過 900 秒(15 分鐘)的列,把它們翻回 pending,讓另一個 worker 來認領。實際的體感是:在基礎設施事件之後,新一次派發嘗試最壞會有 15 分鐘的延遲，但訊息永遠不會被悄悄遺失。

UI 裡的「Sending…」到底是什麼意思

轉圈很快就停。 狀態是 pending 或 dispatching; worker 正在連線到沙盒或啟動執行器。前幾百毫秒這是正常的。
轉圈持續 >30 秒還沒有文字。 執行器已經起來了,但 Claude 正在長思考; 保活機制在運作。耐心等等。
轉圈持續 15 分鐘以上。 承載這次派發的 worker 可能已經掛掉了。恢復輪詢器很快會重置它。
紅色泡泡帶錯誤訊息。 狀態是 failed;你看到的就是 last_error 欄位。再傳送一次就能重試，佇列會接著處理。

對輸出進行迭代

一段高效率對話的標準節奏:

代理產出一些東西，文字、草稿、結構化輸出。
你讀一遍。
你具體地告訴它該改什麼。
代理產出新版本。
重複,直到滿意。

更好的回饋方式

籠統	更好
「再寫好一點。」	「砍掉 30%。語氣別那麼正式。免責聲明跳過。」
「換個格式。」	「從散文改成編號清單,每項一句話。」
「不太對。」	「『優勢』這一節要寫成 3 段散文,別用項目符號。『風險』這一節繼續用項目符號就好。」
「太多了。」	「只保留前 3 個主題。其他全部去掉。」

把對話存成應用

把一段跑通的對話變成已儲存的工作流,有兩條路徑:

路徑 A:在對話中途使用觸發短語

在對話的任何時刻,說:

> save this as an app

應用建構器會啟動,查看目前為止的對話內容,然後提出一個 AppDef。從這裡開始,流程和從零開始建構一樣:審閱 - 確認。

路徑 B:使用 Save as App 按鈕

點擊右上角的 Save as App ▾。
選 Save as App 新建一個應用,或選 Save into existing App 合併到你已經有的某個應用裡。
應用建構器會啟動,並根據這次對話提出一個設計方案。
審閱、確認、儲存。

沙盒細節

每一個對話都在一個使用 claude-code 範本的隔離 E2B 沙盒裡執行:

每個對話有全新的檔案系統。 在對話開啟時建立;在對話結束或長時間閒置之後銷毀。
允許安裝軟體套件。 代理會依任務需要安裝東西(Python 套件、npm 模組、系統工具)。
允許網路存取。 網路搜尋、API 呼叫、抓取檔案。
Connect 依執行注入。 你的 OAuth 權杖會提供給代理,但不會暴露在對話內容裡。
沒有跨對話狀態。 兩個對話絕對不會共用檔案或上下文。

對話歷史與搜尋

所有對話都集中在 側邊欄 → Chats 下面。
點擊任何一個對話就能重新開啟，你可以隨時繼續對話。
使用搜尋(對話清單頂部)按內容尋找對話。
把你經常引用的對話釘住。
把已經做完的對話封存，封存後仍可搜尋,但不會塞滿清單。

什麼時候對話不是合適的介面

遇到下列情況時,改用應用,不要重複開新對話:

你已經找到了任務的可行版本。
你以後還想用不同的輸入做同一類工作。
你希望同事不用學你的提示詞也能跑。
你希望它能依排程自動執行。

一次性的工作、探索、除錯,以及隨意的提問，留在對話裡就好。

內建的代理工具

除了你安裝的技能和 Connect,代理還有五個始終可用的工具,透過內建的 MCP 伺服器公開 (mcp__aitroop__*):

工具	它做什麼	代理什麼時候會用
`ask_question`	暫停並向你問一個釐清性問題。	資訊缺失、猜測會浪費工作的時候。
`get_task`	查詢某個任務的細節(針對在對話中產生的任務)。	帶結構化待辦的長會話。
`update_task`	把一個任務標記為已完成 / 進行中 / 受阻。	同上。
`get_asset_content`	重新讀取本次對話裡已經產出的某個產物。	「針對你剛寫的簡報第 3 節,再展開一下。」
`generate_image`	透過 Gemini 進行文字生圖(前提是主機已設定金鑰)。	「幫這個工作流畫一張圖。」

常見問題與疑難排解

代理沒有在使用我以為它會用的技能 / Connect。

常見原因: 代理選擇了不同的做法。常常是它在依上下文推理,而你希望它呼叫一個工具。

修正: 明確地告訴它。「這件事用 web-search 技能。」 或者檢查一下輸入框上方的狀態列，如果它顯示「Skills: 12 active」,但你想要的那個技能不在裡面, 先從 側邊欄 → Skills 安裝它。

我上傳了一個檔案,但代理好像沒有在看它。

透過 📎 附加的檔案躺在沙盒裡,但代理不會主動去讀,除非你的提示詞裡提到了它們。加上: 「把附件 contract.pdf 當作輸入。」

我的對話反應特別慢。

三個常見原因:

冷啟動沙盒。 對話的第一則訊息:+1-2 秒用於配置沙盒。
重量級的工具呼叫。 一個包含 10 次網路搜尋的研究任務需要 30-90 秒。盯著執行紀錄看，每次呼叫發生時你都能看到。
上下文溢位。 非常長的對話(50+ 回合)會變慢。狀態列會顯示上下文用量; 可以考慮用你關心的那份產物當種子,開一個新對話。

我要怎麼把一個對話分享給同事?

打開對話,點擊右上角的分享圖示,拿到一個公開 URL。在那個 URL 下,對話會變成唯讀，你的同事可以看,但不能傳送訊息或觸發新的代理回合。可以隨時在 Settings → Shares 中撤銷。

我能用不同的輸入把同一個對話再跑一次嗎?

不能直接做到，對話是有狀態的會話,不是參數化的工作流。如果你想用不同輸入重跑,那正是應用的意義所在。打 「save this as an app」,應用建構器會把這段對話變成一個應用。

代理一直在問我釐清性問題。怎麼走捷徑?

把答案提前給它。在你第一則訊息的最上面用一個有用的範本:

# Task
<what to do>
# Inputs
<exact data points>
# Output
<format, length, structure>
# Constraints
<what to include / skip>

我關掉分頁之後,對話會怎樣?

對話歷史會永久保存(直到你刪除它)。這個對話的沙盒在 5 分鐘後進入閒置模式,再過不久就會被銷毀。你下次打開這個對話時,會重新配置一個全新的沙盒。之前附加的檔案會自動重新上傳; 代理的推理透過對話歷史延續下去。

下一篇應用：建構與執行