fixRAgent

官方

只需一張照片即可進行維修分流：判斷問題、緊急程度（EMERGENCY、TODAY、THIS WEEK 或 WHENEVER）、應聯絡哪種技術人員，以及該如何告知住戶。

造訪 fixragent.com

你可以用 fixRAgent MCP 做什麼？

  • 照片初步判讀 — 傳送住戶的照片，取得物品辨識結果、是否可見故障、緊急程度，以及應聯絡哪種技術人員。
  • 工單欄位對應 — 讀取回傳欄位，以填入優先級、資產類型、廠商類別、描述、安全標記和住戶訊息。
  • 緊急程度與安全規則 — 若有人可能觸電，或水靠近任何電氣設備，則強制設為 EMERGENCY 等級。
  • 一致判讀數量 — 查看三次判讀（深度模式為五次）中有多少次對答案達成一致。
  • 西班牙文敘述 — 要求以西班牙文提供敘述，同時讓危險提示行維持英文。
  • 結果回呼 — 將故障的實際情況傳送至每則回覆中附帶的回呼 URL。

託管 MCP 伺服器

npx add-mcp 'https://fixragent.com/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

fixRAgent 分流 API — 開發者

https://fixragent.com/docs 的文字，以 Markdown 格式呈現，讀取自網站提供內容的同一個檔案。價格僅列於 https://fixragent.com/pricing。提供給 AI 助理的所有頁面：https://fixragent.com/llms.txt（整個網站合併為一個檔案：https://fixragent.com/llms-full.txt）。

fixRAgent 分流 API

傳入一張照片，傳回一個答案。

POST 居民的照片。傳回固定格式的 JSON：物品是什麼、是否看得見故障、緊急程度，以及應聯絡哪種技術人員。

查看請求

{ } response.json

記錄於 2026 年 9 月 13 日 · 3 次讀取結果一致 · 摘錄

依照你的方式提出請求

選擇呼叫方式。傳回的答案都相同。

不是每張照片都代表緊急狀況。關鍵在於判斷哪些情況需要立即處理。

引擎在同一天傳回的兩個答案。兩者都找到了實際故障，但只有一個必須在今晚處理。

立即處理 1abde77c

緊急程度 緊急

物品是什麼 銅製供水管

聯絡對象 水管工

故障情況 地下室一處已腐蝕的銅管彎頭接合處正在持續噴漏。

判斷信心 3 次讀取結果一致

可以等到本週 882c093e

緊急程度 本週內

物品是什麼 中央空調冷凝器

聯絡對象 HVAC 技術人員

故障情況 室外冷凝器的頂部風扇護罩和機殼外部有明顯鏽蝕，需要除鏽並塗上防護塗層。

判斷信心 3 次讀取結果一致

對應到你的工單

無須安裝整合，也不必維護同步。讀取你需要的欄位即可。

| | 我們傳回的欄位 | 對應填入的工單欄位

| core.tier | 你的優先級欄位。四種文字，對應你自己的四種級別。

| core.asset_type | 工單所對應的設備。

| core.trade_required | 廠商類別，或負責派送的佇列。

| core.fault_summary | 工單描述，以便於閱讀的文字撰寫。

| core.safety_hazard | 將工單移出一般佇列的標記。

| core.resident_explanation | 原樣傳送給居民的說明文字。

| diagnosis_id | 你的外部參照 ID，方便回傳處理結果。

| callback_url | 確認結果後，POST 回傳結果的位置。

為可靠使用而打造

開發者在串接前會想知道的事項。

固定格式

二十個核心欄位，並有版本控管。無論照片顯示漏水或完全沒有問題，格式都相同。

三次讀取，一個答案

照片會讀取三次（深度模式下為五次），回覆會說明有幾次結果一致。

一條寫在程式碼中的規則

若涉及人員可能接觸的線路，或水靠近任何電氣設備，就會強制標記為緊急。

限制會明確說明

達到限制時，回覆會用一句話說明，並提供依時鐘計算的 Retry-After。

不用金鑰也能試用

模擬伺服器會重播已擷取的回覆，讓你在消耗請求前就能串接用戶端。

告訴我們結果如何

每個回覆都會附上 callback_url。POST 回傳最終結果。

可依需求使用西班牙文

lang=es 會以西班牙文傳回文字內容。危害說明刻意保留英文。

照片與答案一同保存

我們會先移除位置詳細資訊，再保存答案、檔案指紋，以及清理後的照片與其 Triage Profile。傳送 keep_photo false 即不會保存照片。我們的模型供應商會將收到的資料保留 55 天。

在你的 AI 工具中使用

在 Claude、ChatGPT、Cursor 或 Gemini 中使用相同的呼叫方式。只需貼上金鑰一次。

取得金鑰。

填寫你的電子郵件、公司、姓名、一行建置項目說明，並勾選 API 條款。金鑰會連同使用該金鑰的 curl 指令一併寄給你。

  • 每個金鑰每天可提出 60 次請求（UTC）

  • 超過 60 次？UTC 00:00 後即可再次使用。需要更多額度，請聯絡我們，創辦人會在一個工作日內回覆（取得金鑰後）。

  • 付費使用方案另行報價

表單會將 { kind: "api_key", email, company, name, use_case, terms_accepted, source, role, variant, consent_version } POST 至 /api/leads。回覆會提供金鑰的 ID，而非金鑰本身：金鑰會透過電子郵件寄給你。terms_accepted 是上方的核取方塊，預設未勾選，必須由你勾選；若未勾選，請求會遭拒，且不會傳送任何資料。consent_version 是上方同意文字的版本，會與請求一併記錄，作為你接受 API 條款的證明。company 和 name 分別記錄接受條款的公司與人員；連同同意版本和請求時間，這四項資料就是 API 條款所述的接受紀錄內容，並會在寄出金鑰前與請求一併保存。輸入資料前，頁面會檢查你目前瀏覽的部署環境是否啟用該端點；若未啟用，表單會停用並明確說明，而不會假裝可以使用。你也可以將相同資料寄至 support@fixragent.com，效果相同。

取得金鑰後：每天 60 次，以及超額時的處理方式

每個金鑰每天可提出 60 次請求（UTC）。超過額度後，請寄信至 support@fixragent.com，說明你正在建置什麼；創辦人會在一個工作日內回覆。

金鑰在 UTC 當日達到 60 次請求時，回覆會是 429 demo_key_quota，並提供倒數至下一個 UTC 00:00 的 Retry-After，訊息中也會附上相同說明。金鑰不會遭撤銷；UTC 00:00 後即可再次使用。

完整參考資料

所有欄位、參數、錯誤和限制，分別列於各自頁面。

參數 config、extended、lang 回應 core、extended、agreement 錯誤 所有代碼及範例 限制 三項防護機制 結果回傳流程 callback_url OpenAPI openapi.json Postman collection 檔案 API 條款 /api-terms

不打算撰寫程式碼？無須建置即可開始。

使用相同的引擎，無須建置任何內容：貼紙、佇列，以及相同的四種緊急程度文字。

開始使用 適用於物業管理者