給故障排查裝上“大腦”：Reef如何用Coral和Slack把跨工具救火變成一條SQL的事

　　“生產環境崩潰時，最難的從來不是找數據——而是把它們串起來?！边@是Reef團隊的親身體會。你打開GitHub看最近的PR，打開Sentry查報錯，翻Slack聊天記錄找值班同事說了什么，再去Vercel確認剛剛是不是有部署。四個標簽頁開著，你盯著屏幕，腦子里拼命對齊每個時間點。這種手忙腳亂的體驗，幾乎是每個工程師的工傷。

　　于是，在海盜主題的“Coral-bean”黑客松上，Reef誕生了。它的野心很簡單：把這種瑣碎的跨工具串聯，變成一次自動化調查、一份統一報告。根據故障的嚴重程度，它甚至還能順手給出修復建議。這篇文章就像一份船長的航海日志，記錄了他們怎么用Coral把多源數據揉成一條SQL，怎么讓AI代理自己規劃和判斷，以及你照搬這套模式需要哪些零件。

　　Reef本質上是一個“生產事故情報代理”。觸發方式有三種：儀表盤手動點擊、Sentry Webhook自動捕捉、Slack對話指令。當你睡覺時，一個“panic”信號被Sentry捕獲，Reef就被喚醒了。

　　它的核心工作流像一場狀態機驅動的偵探游戲：先制定查詢計劃，通過Coral執行SQL，由證據法官判定是否充分，不夠就繼續迭代，最多跑5輪。一旦收集到足夠信心，生成一份結構化的報告。如果是由Webhook觸發，報告還會直接推送到Slack頻道，讓團隊秒級看見故障全貌。整個運行流水線可以這樣看：觸發器 → 調查編排器 → 規劃器（Gemini）通過Coral SQL獲取數據 → 證據存儲和查詢引用 → 法官（Groq）判定 → 嚴重程度閘門 → 報告 → 推送Slack。

　　沒有Coral之前，跨工具的故障排查通常意味著：打開五個頁面，手工復制時間戳，在腦子里做一種脆弱的“時序拼接”。Coral把這個模型翻了個個兒。它把GitHub、Sentry、Slack、Vercel都暴露成SQL表。你只需要寫一條查詢，就能把“PR合并后出現的報錯”這種跨源關聯瞬間拉出來。比如這樣：

　　SELECT g.title AS pr_title, g.number AS pr_number, s.title AS error_message, s.level AS error_levelFROM github.pulls gJOIN sentry.issues s ON s.first_seen >= g.merged_atWHERE g.owner = 'your-org' AND g.repo = 'your-repo' AND s.level IN ('fatal', 'error') AND g.state = 'closed'ORDER BY s.first_seen DESCLIMIT 20;

　　一條SQL，兩個數據源。不需要數倉，不需要ETL，憑據也只留在你的本地機器上——Coral在查詢時即時解析API。那個關鍵的時間連接條件“s.first_seen >= g.merged_at”正是Reef自動化調查的核心洞見：剛剛合并的PR可能就是這次報錯的元兇。

　　背后的技術棧頗為輕巧：后端是Python 3.11+ 配 FastAPI 和 SQLAlchemy（開發環境SQLite，生產為Postgres）；前端用React 19、TypeScript、Vite、Tailwind；數據層靠Coral CLI（coral sql）或者在沒有安裝Coral時用模擬模式做演示。AI大腦分兩塊：規劃器調用Gemini 2.5 Flash生成查詢計劃，證據法官用Groq Llama 3.3 70B來做判斷。如果沒有API密鑰，系統會降級到模板規劃加規則法官的備用方案。

　　如果你也想搭一套，流程相當直接。先安裝Coral，再把你的生產工具注冊進來：brew install withcoral/tap/coral。在后端目錄下復制一份.env.example為.env，填入GITHUB_TOKEN、GITHUB_OWNER、GITHUB_REPO、SENTRY_ORG、SENTRY_TOKEN、SLACK_TOKEN、VERCEL_TOKEN。運行一次配置腳本setup_coral_sources.sh，它會把github、sentry、slack和vercel（來自社區清單）全部添加好，并執行一條煙霧查詢來驗證，比如PR與Sentry的關聯查詢。最后用一條簡單的檢查語句確認所有表就位：coral sql "SELECT schema_name, table_name FROM coral.tables WHERE schema_name IN ('github','sentry','slack','vercel') LIMIT 20"。

　　整個過程就像給故障響應流程裝了一個外掛大腦。你不再需要成為那個同時盯著四個屏幕、手動對齊時間戳的焦慮操作員。Reef像一個冷靜的同事，在你喊一聲“幫我查查這次崩潰”之后，默默把相關PR、報錯記錄、部署變更甚至對話上下文都拼成一條故事線，配上自己的判斷，丟回Slack。而背后的Coral，則把這場跨服務追蹤變成了數據庫里再自然不過的連接查詢。