Studio
Studio 提供互動式 UI，讓你建置、測試及管理 Agent、Workflow 和 Tool。你可以在開發期間於本機執行、加入驗證，或部署至正式環境，讓團隊管理 Agent、監控效能，並透過內建可觀測性取得深入分析。
觀看 Mastra Studio 概觀，快速瞭解如何在 Studio 中建置、測試及管理 Agent。
啟動 Studio「啟動 Studio」的直接連結
若應用程式是以 create mastra 建立，請使用 dev 指令碼啟動開發伺服器；也可以直接執行 mastra dev。
- npm
- pnpm
- Yarn
- Bun
npm run dev
pnpm run dev
yarn dev
bun run dev
伺服器啟動後，你可以：
- 開啟
localhost:4111的 Studio UI，與 Agent、Workflow 和 Tool 互動。 - 前往
localhost:4111/swagger-ui，探索底層 REST API 並與之互動。
Studio 執行期間，你可以即時編輯 Mastra 應用程式中的 Agent、Workflow及其他部分。
部署 Studio「部署 Studio」的直接連結
準備與團隊共用 Studio 時，可使用 Mastra platform 上的 Studio 或自己的基礎架構，將其部署至正式環境。詳情請參閱部署文件。
基本元件「基本元件」的直接連結
Agents「Agents」的直接連結
直接與 Agent 對話、切換模型，並調整 temperature 和 top-p 等設定，瞭解它們如何影響輸出。
與 Agent 互動時，你可以追蹤其推理過程並查看 Tool 呼叫輸出，也能觀察 Trace 與記錄，瞭解回應的產生方式。
你也可以附加評分器，持續評量及比較回應品質。
在 Agent 串流回應期間，你可以於同一討論串傳送後續訊息。Studio 會先將訊息顯示為等待中，直到串流確認後，再於該後續訊息下方繼續回應。開啟同一討論串的其他 Studio 分頁也能觀察進行中的串流。
使用 Editor，讓非技術團隊成員反覆調整 Agent、為每項變更建立版本，並在不重新部署的情況下執行實驗。
Workflows「Workflows」的直接連結
將 Workflow 視覺化為圖形，並使用自訂輸入逐步執行。執行期間，介面會即時更新，顯示目前步驟與實際採取的路徑。
執行 Workflow 時，也可查看詳細 Trace，其中會顯示 Tool 呼叫、原始 JSON 輸出，以及過程中可能發生的錯誤。
Processors「Processors」的直接連結
查看附加至各 Agent 的輸入與輸出處理器。Agent 詳細資料面板會依名稱與類型列出每個處理器，讓你在測試前確認防護機制、權杖限制器及自訂處理器均已正確連接。
MCP servers「MCP servers」的直接連結
列出附加至 Mastra 執行個體的 MCP 伺服器，並探索其可用 Tool。
Tools「Tools」的直接連結
單獨執行 Tool 以觀察行為，並在指派給 Agent 前進行測試。若發生問題，可單獨重新執行 Tool 來偵錯。
Workspaces「Workspaces」的直接連結
使用內建檔案瀏覽器瀏覽 Agent Workspace 檔案系統中的檔案。你可以切換 Workspace 掛載點、建立目錄，並以語法醒目提示查看檔案內容。可寫入的 Workspace 允許建立目錄及刪除檔案；唯讀 Workspace 則會有相應標示。Skills 分頁會列出所有找到的 Skill，以及其操作說明、參考資料與中繼資料。你可以從 skills.sh 安裝社群 Skill，或移除現有 Skill。
設定詳情請參閱 Workspace。
Request context「Request context」的直接連結
設定執行階段變數，透過相依性注入傳入 Agent 指示與 Tool。你可以使用 JSON 編輯 request context；若 Agent 定義了 requestContextSchema，也可使用由結構描述驅動的表單。值會在測試對話與實驗之間保留，因此不必重新啟動即可觸發條件流程。
設定詳情請參閱 request context。
評估「評估」的直接連結
使用日期篩選器，將分數指標限制在預設或自訂的時間範圍內。
Scorers「Scorers」的直接連結
Scorers 分頁會在 Agent 評分器執行時顯示結果。訊息通過 Agent 時，已定義的評分器會以非同步方式評估每項輸出，並在此呈現結果。你可以瞭解評分器對不同互動的反應、比較測試案例之間的效能，並找出可改善之處。
Datasets「Datasets」的直接連結
建立及管理測試案例集合，以評估 Agent 和 Workflow。從 CSV 或 JSON 匯入項目並定義輸入與標準答案結構描述，也可鎖定特定版本，確保實驗可精確重現。搭配評分器執行實驗，比較不同提示詞、模型或程式碼變更的品質。
完整 API 與版本控制詳情請參閱資料集概觀。
Experiments「Experiments」的直接連結
針對 Agent、Workflow 或評分器執行資料集中的所有項目，並集中收集結果。選擇目標、視需要附加評分器，再觸發實驗。結果檢視會顯示各項目的輸入、輸出、狀態與個別分數明細。並排比較兩項實驗，即可衡量提示詞、模型或程式碼變更造成的影響。
設定詳情請參閱資料集概觀。
Observability「Observability」的直接連結
請參閱 Studio 可觀測性文件以瞭解詳情。
設定「設定」的直接連結
設定 Studio 與 Mastra 伺服器之間的連線。設定頁面包含：
- Mastra instance URL：Mastra 伺服器的基底 URL（例如
http://localhost:4111）。 - API prefix：所有 API 請求的選用路徑前綴（預設為
/api）。 - Custom headers：加入每個請求都會傳送的鍵值組，適合用於驗證權杖或路由標頭。
- Theme：切換深色、淺色或系統主題。
程式碼設定「程式碼設定」的直接連結
除了設定 UI 外，也可透過 src/mastra/index.ts 中的 server 選項設定本機開發伺服器與 Studio。
Studio 預設在 http://localhost:4111 執行。你可以變更 host 與 port。
Mastra 也透過 --https 旗標支援 HTTPS 開發，並會自動為專案建立及管理憑證。執行 mastra dev --https 時，系統會為 localhost（或設定的主機）產生私密金鑰與憑證。詳情請參閱 HTTPS 參考文件。
後續步驟「後續步驟」的直接連結
- 瞭解如何將 Studio 部署至正式環境。
- 加入驗證，控制已部署 Studio 的存取權。
- 探索 Studio 可觀測性，透過指標、Trace 與記錄監控 Agent 效能。