07 — 營運

驗證安裝

確認所有容器健康、Manager 可達。

列出運行中的容器

costaff status
# 或直接用 docker：
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'

至少應該看到：

costaff-postgres
costaff-mcp-costaff — Manager 的 MCP server
costaff-agent-costaff — Manager 本人，綁在 0.0.0.0:18080
每個已註冊專家一組 costaff-agent-<name> 與 costaff-mcp-<name>
每個已註冊 channel 一個 costaff-channel-<name>

健康檢查 endpoint

# Manager Agent（ADK web server）— 回非 5xx 就代表活著
curl -I http://localhost:18080/

# 專家 Agent 與 channel 都在各自的自動分配 port 上
# 提供 A2A agent card（port 看 costaff agent list / channel list）
curl http://localhost:<port>/.well-known/agent-card.json
# → agent card JSON

costaff agent list 與 costaff channel list 會自動幫你跑同樣的健康檢查，每列直接顯示結果。

打開聊天介面

瀏覽器開你 WebChat channel 的 port（看 costaff channel list；如果它是你加的第一個 channel 就是 http://localhost:18090），用部署時設定的 email + 密碼登入，開始對話。Manager 會把你的訊息路由到對的專家 Agent，並串回專家的處理進度。

或者跑 costaff dashboard 開操作後台（http://localhost:8501）— Chat 分頁不用任何 channel 就能直接跟 Manager 對話。

「Your account has not been approved」

任何聊天介面傳來的第一句話會建立待核准身份，核准前助理會拒絕執行實際工作（預設開啟）。修法：dashboard → Users → 核准新的那一列 → 再傳一次訊息。

Dashboard 怎麼逛

dashboard 左側選單，按新手需要的順序：

模組	在這裡做什麼
Chat	直接跟 Manager 對話 — 不需要任何 channel。
Users	核准新身份（上面那道門檻）、編輯每位使用者的個人資料。
Channels	不用重啟就能新增或更換 Telegram / Discord / LINE 的 bot token。
Agents	每個專家的健康狀態；每個 Agent 的 MCP / API / skill 指派。
Reminders / Tasks	助理排好的所有提醒、週期任務的執行歷史。
Sessions	瀏覽過往對話，含完整的工具呼叫軌跡。
Logs	任何服務的即時容器日誌 — 怪怪的時候先來這裡。
Config	Model provider、審核門檻開關、主題。

跑 doctor

想一次檢查全部、含環境變數，用：

costaff doctor

它會驗證容器、網路、.env、資料庫，結尾列出建議修復步驟（每個偵測到的問題都配好對應的修復指令），並存一份帶時間戳的報告 — 請求協助時附這份最方便。