快速開始：15 分鐘建立你的第一個應用

讀完本頁,你將透過與智能體對話建立一個能調研任意公司、產出單頁 Markdown 簡報的真實應用,並可設為每週一自動執行。

讀完時你會擁有什麼

一個名為 Company Brief 的應用,它會:

• 接收一個公司名稱(必填)和一個選填的官網連結。
• 讓你切換是否包含競爭對手。
• 在公開網路上研究該公司,然後產出一份單頁 Markdown 簡報。
• 將簡報儲存為可下載、可分享、可鏈式呼叫的產物。

夠簡單,15 分鐘就能完成;又夠真實,你會真的拿來用。

開始之前

我們要建什麼。 一個名為 Company Brief 的應用,以公司名稱為輸入, 產出一份單頁的 Markdown 研究簡報。簡單到 15 分鐘就能完成,真實到你會願意真的拿來用。

步驟 1：登入

1. 前往 app.aitroop.net。
2. 點擊 Sign up(如果你已有帳號,點擊 Log in)。
3. 輸入 email 並設定密碼,或者點擊 Continue with Google。
4. 你會進入工作區首頁。

登入後你會看到的畫面

大致是這樣:

側邊欄的項目對應平台的幾個操作面:

• Chats：與智能體的對話歷史。
• Apps：你儲存的工作流程庫。
• Skills：智能體可以呼叫的能力。
• Connects：透過 OAuth 與外部帳號建立的連接。
• Schedules：按 cron 自動執行的應用。
• Settings：工作區、帳務、團隊成員。

步驟 2：開啟一個新的對話

1. 點擊側邊欄左上角的 + New Chat。
2. 一個空白對話開啟。底部是訊息輸入框,上方是空的對話區域。

對話介面的版面如下:

各部分含義:

• 頂部的麵包屑:工作區名稱 / 對話名稱。
• "Save as App" 按鈕(右上角)，在對話進入可儲存的狀態之前一直是灰色的。
• 訊息輸入框上的附件按鈕(📎)，把檔案拖到這裡加入對話。
• 傳送按鈕,或直接按下 Enter。

步驟 3：請智能體幫你建立應用

Aitroop 內建了一個名為 aitroop-app-create 的技能(也就是應用建構器)。 當你的訊息包含以下觸發短語時,它就會被啟動:

• "Create an app that…"
• "Build me a workflow for…"
• "I want an app to…"
• "Make an automation that…"

在對話中輸入下面這段:

按 Enter 送出。接著會依序發生三件事:

1. 你的訊息出現在對話串中。
2. 智能體思考幾秒鐘，你會看到一個 "thinking" 的指示。
3. 智能體載入應用建構器技能(可能會內嵌顯示一個 "Skill: aitroop-app-create" 標籤),然後開始回覆。

步驟 4：回答釐清問題

應用建構器會丟出 1-5 個簡短問題,用來補齊設計上的空缺。典型回覆大致如下:

你不必逐條作答,一條回覆就夠了:

把回答答好的幾個小訣竅

• 言簡意賅。 智能體不需要長篇大論。"Yes / No / 3 paragraphs / English" 這種就夠了。
• 放心讓智能體取合理的預設值。 如果某個問題你並不在意,回一句 "your call" 即可，智能體會選個合理預設,並在設計裡標註。
• 不必一次到位。 任何選擇之後都可以再編輯。

步驟 5：檢視應用設計

回答完之後,應用建構器會展示完整的設計。這是最關鍵的一步，仔細看每一個欄位。

逐項註解:每一塊代表什麼

• name、icon、tags：顯示在應用庫中。圖示是一個 emoji。
• Inputs：使用者要填的表單欄位。標為 required 的欄位沒填時會停用 Run 按鈕。
• Stage：智能體要做的事。{{company_name}} 在執行時會被換成表單裡的值。
• Artifact：最終的產出。format: markdown 會被渲染成一份漂亮的文件。
• Resources：應用需要的技能和連接。這裡的 web-search 表示智能體會上網搜尋。

確認或修改

三種範例回覆及其效果:

本教學裡,請輸入:

步驟 6：智能體儲存應用

在背後,應用建構器會校驗設計(每個 ID 都唯一、每個 {{ref}} 都能解析、目標夠具體), 然後呼叫 POST /api/apps。你會看到類似這樣的輸出:

此刻,應用已經上線、可直接執行。

確認它真的儲存好了

1. 在側邊欄點擊 Apps。
2. 你應該能在列表最上方看到 Company Brief,並帶有你設定的 🏢 圖示。
3. 若沒看到,重新整理頁面或再點一次 Apps。

步驟 7：執行你的應用

1. 在應用列表中點擊 Company Brief。
2. 應用頁面開啟,顯示表單(你的三個輸入)和一個 Run 按鈕。
3. 填寫表單:
   • company_name: Stripe
   • company_url: 留空
   • include_competitors: 打開(預設)
4. 點擊 Run。

執行過程中你會看到什麼

頁面會分成左右兩欄:

• 左欄，執行紀錄。 智能體的推理過程、工具呼叫、階段性輸出。你可以親眼看到每一次網頁搜尋。
• 右欄，產物預覽。 一開始是空白,隨後 Markdown 簡報會隨著智能體的書寫逐步呈現。

典型的執行時間線:

此時 Run 按鈕會變灰(執行中),完成後會再次可用。

執行結束之後

在右欄的產物預覽,你可以做三件事:

• 閱讀：捲動瀏覽、複製文字、點選連結。
• 下載：原始 Markdown 選 .md,渲染版本則選 PDF/DOCX。在預覽面板頂端找下載圖示即可。
• 在對話中開啟：想讓智能體微調這次具體的輸出,就點 Edit in chat。系統會開啟一個新對話,把產物當作上下文載入。

執行歷史

每一次執行都會被記錄下來。在應用頁面上,Runs 分頁會列出過去的執行記錄: 時間戳、執行者、使用的輸入、狀態、耗時。點任一筆就能看到該次的產物與智能體的推理軌跡。

步驟 8：換一組輸入再跑一次

回到應用頁面,點擊 Run(或 "New run"),改用另一家公司填寫表單:

• company_name: Notion
• company_url: notion.so
• include_competitors: 關閉

點擊 Run。同一套工作流程,完全不同的輸出。這就是甜頭時刻：你只描述了一次提示,如今它就能套用在任何輸入上。

步驟 9：編輯應用

假設跑過幾次之後,你覺得簡報還應該加上 "招募訊號"。有兩種方式可以更新這個應用:

方式 A:對話式編輯(推薦)

1. 在應用頁面找到 Edit in chat 或 Chat with this App。
2. 對話開啟,應用的設計已經載入。
3. 輸入:

智能體會讀取目前的應用、修改階段目標、進行校驗,然後呼叫 PUT /api/apps/{id}。儲存前你會看到一份差異對照:

方式 B:直接編輯欄位

1. 在應用頁面點擊 Edit。
2. 所有欄位都會以原始形式呈現:name、icon、tags、inputs、stages、artifacts、resources。
3. 任意修改，重新命名欄位、更換輸入型別、調整階段目標。
4. 點擊 Save 建立 v2。

無論哪種方式,舊版本都會保留在 Versions 分頁裡,一鍵就能回滾。

步驟 10(選用)：排程

對於希望自動執行的應用:

1. 在應用頁面開啟 Schedules 分頁。
2. 點擊 + New schedule。
3. 填寫三個區塊:
   • Cron：選一個預設(Hourly、Daily at 9 AM、Weekly Monday),或者寫自訂表達式。
   • Inputs：每次執行使用的輸入值。對於 "company_name",可以寫死一份清單,或者使用動態值(如果應用支援)。
   • Delivery：產物送到哪裡。可以是 email、Slack 頻道、Drive 資料夾或 webhook。
4. 點擊 Save schedule。

排程現在已啟用。應用頁面會顯示下一次執行的時間。隨時開啟 Schedules 分頁,即可暫停、編輯或刪除這個排程。

你完成了什麼

你完整走過了 Aitroop 的整套操作迴圈:

1. 透過對話建立了一個應用：使用應用建構器技能,沒寫一行 JSON,也沒寫一行程式碼。
2. 在儲存前審閱並確認了設計。
3. 用兩組不同輸入執行了應用,親眼看見參數化是怎麼運作的。
4. 透過另一段對話編輯了應用。
5. (選用)將它排程讓它自動執行。

常見疑難排解與困惑

"智能體沒有問我任何釐清問題。"

這通常代表你最初的描述已經夠具體了。智能體會直接跳到設計審閱(步驟 5)。 從那裡開始流程一樣，審閱、確認或修改。

"我的應用需要讀 Gmail / Drive / GitHub,該怎麼辦?"

這些都是連接(OAuth 整合)。當你描述的應用需要讀取 Gmail 資料 ("read my last 50 emails and...")時,應用建構器會把 google 加進 resources.connects。 第一次執行該應用時,系統會提示你授權 Gmail。授權一次,以後都能用。 完整流程見 連接。

"表單欄位看起來怪怪的。"

有兩種路徑:

• 儲存之前(步驟 5):告訴智能體要改什麼。"Change company_name to a textarea instead."
• 儲存之後:在應用頁面打開 Edit,或使用對話式編輯(步驟 9)。

"我的執行失敗了。"

1. 在應用頁面開啟 Runs 分頁。
2. 點擊失敗的那一筆。
3. 在執行紀錄中查看錯誤。常見原因:
   • 逾時：提高階段的 timeout_ms(預設 3 分鐘,重度研究可以試 10 分鐘)。
   • 缺少連接：在 Settings → Connects 中授權所需的連接。
   • 輸入不合適：表單值跟智能體預期不一致。換個值再跑一次。
4. 點擊 Debug in chat,以對話形式打開這次失敗的執行，一樣的上下文、一樣的輸入,但是可互動。

"這跟 ChatGPT 有什麼不一樣?"

ChatGPT 沒有持久化的應用、沒有表單、沒有排程、 沒有具型別的產物、沒有基於連接讀寫你工具的能力, 也沒辦法讓隊友直接拿來用,他們必須把你的提示詞全部重做一次。Aitroop 把這些都補齊了。

"我能用哪些技能和連接?"

• 技能:側邊欄 → Skills,或直接問智能體 "what Skills do I have?"
• 連接:側邊欄 → Connects 會顯示已授權與可用的服務商。

常見問題

註冊信一直沒收到。

先檢查垃圾信,再等 2 分鐘。如果還是沒有,使用 Continue with Google 登入，不需要 email。 如果一定要用 email,在登入頁點 "Resend verification"。

智能體沒在問我釐清問題。

代表你最初的描述已經填齊了所有 5 個設計槽。這其實是好事，智能體直接跳到步驟 5(審閱設計)。流程從這裡繼續即可。如果你就是想強制讓它發問, 可以在訊息末尾加一句 "Ask me anything you need to know first."

"Save as App" 按鈕是灰的。

對話還沒進入可儲存的狀態。你需要(a)在訊息中帶上可被識別的觸發短語,或者 (b)至少讓智能體完成過一輪看起來像是完整任務的回應。直接輸入 "save this as an app" 也行，應用建構器會從對話中推斷出一個 AppDef。

應用儲存後表單欄位錯了。

別擔心,應用是可以編輯的。兩種方式:

• 對話式:在應用頁面點 Edit in chat。告訴智能體 "Change company_name to a textarea",然後核可差異。
• 直接編輯:在應用頁面點 Edit,手動改任何欄位。然後儲存。

無論哪種方式,變更都會建立新版本。舊版本會留在 Versions 分頁裡。

第一次執行就失敗,怎麼辦?

1. 在應用頁面打開 Runs 分頁。
2. 點擊失敗的那次執行。
3. 看頂部的錯誤。最常見:逾時(提高 timeout_ms)、缺少連接(去授權)、格式不對(調整目標)。
4. 點擊 Debug in chat：以對話形式打開失敗的執行,帶完整上下文。問一句 "why did this fail?"

完整的除錯指南見 執行記錄。

執行耗時比我預期的長很多。

三種常見原因:

• 研究類階段。 網頁搜尋 + 在 10 筆以上結果上推理,通常需要 30-90 秒,屬於正常範圍。
• 冷啟動沙盒。 長時間閒置之後的首次執行:沙盒啟動會多花 1-3 秒。
• 目標模糊。 如果智能體不確定 "做到什麼程度才算好",它就會反覆迭代。把目標收緊，加結構、加限制、加範例。

怎麼把這個應用分享給隊友?

三種層級:

• Private(預設)，只有你能看 / 執行。
• Team：對工作區內可見。在應用頁面點 Share → Workspace。
• 公開連結：任何拿到連結的人都能執行。在應用頁面點 Share → Public link,會生成一個 token,隨時可以撤銷。

團隊應用底下的連接是每位使用者各自授權的，隊友會用自己的 Gmail,不是你的。 詳見 連接。

我想透過 webhook / 指令稿呼叫這個應用。

一行 curl:

在 Settings → API Tokens 取得 $AT_USER_TOKEN。回應中會包含執行 ID; 可以用 GET /api/app-executions/:execId/stream 串流即時進度,或輪詢 GET /api/app-executions/:execId 取得最終狀態。

在哪裡能學到完整的功能集?

• 核心概念：應用 JSON 結構的詳細說明。
• 執行記錄：執行時究竟發生了什麼。
• 沙盒：智能體能在裡面做什麼。
• 排程：cron 語法與投遞目的地。