fixRAgent
chính thứcPhân loại sự cố bảo trì chỉ từ một bức ảnh: đó là gì, mức độ khẩn cấp (EMERGENCY, TODAY, THIS WEEK hoặc WHENEVER), cần gọi thợ chuyên ngành nào và cần nói gì với cư dân.
Bạn có thể làm gì với fixRAgent MCP?
- Phân loại ảnh — Gửi ảnh của cư dân và nhận lại thông tin về vật thể trong ảnh, liệu có thấy hư hỏng hay không, mức độ khẩn cấp và nên gọi thợ thuộc ngành nào.
- Ánh xạ trường phiếu công việc — Đọc các trường được trả về để điền mức độ ưu tiên, loại tài sản, danh mục nhà cung cấp, mô tả, cờ an toàn và tin nhắn gửi cư dân.
- Quy tắc về mức độ khẩn cấp và an toàn — Buộc áp dụng cấp độ EMERGENCY khi có nguy cơ người bị điện giật hoặc nước ở gần bất kỳ thiết bị điện nào.
- Số lượng kết quả đồng thuận — Xem có bao nhiêu trong ba lần đọc (năm lần khi chạy chuyên sâu) đồng thuận về câu trả lời.
- Văn bản tiếng Tây Ban Nha — Yêu cầu phần văn bản bằng tiếng Tây Ban Nha, trong khi dòng cảnh báo vẫn bằng tiếng Anh.
- Callback kết quả — Gửi thông tin về nguyên nhân hư hỏng thực tế đến URL callback có trong mỗi phản hồi.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://fixragent.com/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
API phân loại sự cố fixRAgent — Dành cho nhà phát triển
Nội dung của https://fixragent.com/docs dưới dạng Markdown, được đọc từ chính tệp mà trang web cung cấp. Giá chỉ có trên https://fixragent.com/pricing. Mọi trang dành cho trợ lý AI: https://fixragent.com/llms.txt (toàn bộ trang web trong một tệp: https://fixragent.com/llms-full.txt).
API phân loại sự cố fixRAgent
Gửi một ảnh. Nhận một câu trả lời.
POST ảnh của cư dân. Hệ thống trả về một cấu trúc JSON cố định: đó là gì, có nhìn thấy sự cố hay không, mức độ khẩn cấp và cần gọi thợ nào.
Xem một yêu cầu
{ } response.json
ghi nhận ngày 13 tháng 9 năm 2026 · 3/3 lượt đọc đồng thuận · bản rút gọn
Gửi yêu cầu theo cách của bạn
Chọn cách bạn sẽ gọi API. Câu trả lời nhận được vẫn giống nhau.
Không phải ảnh nào cũng là trường hợp khẩn cấp. Điều quan trọng là biết trường hợp nào.
Hai câu trả lời mà hệ thống trả về trong cùng một ngày. Cả hai đều phát hiện sự cố thực sự. Chỉ một trường hợp cần được xử lý ngay tối nay.
XỬ LÝ NGAY 1abde77c
Mức độ khẩn cấp KHẨN CẤP
Đó là gì Ống cấp nước bằng đồng
Gọi ai Thợ sửa ống nước
Sự cố là gì Nước đang rò rỉ liên tục và phun ra từ khớp nối khuỷu của ống đồng bị ăn mòn trong tầng hầm.
Độ chắc chắn 3/3 lượt đọc đồng thuận
CÓ THỂ CHỜ 882c093e
Mức độ khẩn cấp TRONG TUẦN NÀY
Đó là gì Dàn ngưng tụ điều hòa trung tâm
Gọi ai Kỹ thuật viên HVAC
Sự cố là gì Dàn ngưng tụ ngoài trời bị gỉ đáng kể trên lưới quạt phía trên và vỏ ngoài, cần loại bỏ gỉ và phủ lớp bảo vệ.
Độ chắc chắn 3/3 lượt đọc đồng thuận
Ánh xạ sang phiếu công việc của bạn
Không cần cài đặt tích hợp hay duy trì đồng bộ. Đọc những trường bạn cần.
| | TRƯỜNG CHÚNG TÔI TRẢ VỀ | TRƯỜNG TRÊN PHIẾU CÔNG VIỆC ĐƯỢC ĐIỀN
| core.tier | Trường mức độ ưu tiên của bạn. Bốn từ, ánh xạ sang bốn mức của bạn.
| core.asset_type | Thiết bị mà phiếu công việc áp dụng.
| core.trade_required | Nhóm nhà cung cấp hoặc hàng đợi mà yêu cầu được chuyển đến.
| core.fault_summary | Mô tả trên phiếu công việc, được viết để mọi người dễ đọc.
| core.safety_hazard | Cờ đưa yêu cầu ra khỏi hàng đợi thông thường.
| core.resident_explanation | Nội dung gửi cho cư dân, giữ nguyên như đã viết.
| diagnosis_id | Mã tham chiếu bên ngoài của bạn để có thể gửi lại kết quả.
| callback_url | Nơi bạn POST kết quả thực tế sau khi xác định được.
Được thiết kế để bạn có thể tin cậy
Những điều nhà phát triển muốn biết trước khi tích hợp.
Một cấu trúc cố định
Hai mươi trường cốt lõi, có phiên bản. Cấu trúc luôn giống nhau, dù ảnh cho thấy rò rỉ hay không có vấn đề gì.
Ba lượt đọc, một câu trả lời
Ảnh được đọc ba lần (năm lần ở chế độ chuyên sâu) và phản hồi cho biết có bao nhiêu lượt đồng thuận.
Một quy tắc trong mã
Nếu có thể chạm vào dây điện hoặc có nước gần bất kỳ thiết bị điện nào, hệ thống sẽ buộc mức KHẨN CẤP.
Giới hạn được giải thích rõ
Khi một giới hạn ngăn bạn tiếp tục, phản hồi sẽ nêu rõ bằng một câu, kèm Retry-After được tính từ thời điểm hiện tại.
Dùng thử mà không cần khóa
Máy chủ giả lập phát lại các phản hồi đã ghi nhận để bạn có thể tích hợp ứng dụng khách trước khi dùng một yêu cầu thật.
Cho chúng tôi biết kết quả
Mỗi phản hồi đều có callback_url. POST kết quả thực tế sau khi bạn xác định được.
Có thể yêu cầu tiếng Tây Ban Nha
lang=es trả về nội dung bằng tiếng Tây Ban Nha. Dòng cảnh báo nguy hiểm vẫn bằng tiếng Anh, có chủ ý.
Ảnh được lưu cùng câu trả lời
Thông tin vị trí được xóa trước tiên. Chúng tôi lưu câu trả lời, dấu vân tay của tệp và ảnh đã làm sạch cùng với Hồ sơ phân loại sự cố. Gửi keep_photo false để ảnh không được lưu. Nhà cung cấp mô hình của chúng tôi lưu dữ liệu được gửi đến trong 55 ngày.
Dùng trong các công cụ AI của bạn
Gọi API tương tự trong Claude, ChatGPT, Cursor hoặc Gemini. Chỉ cần dán khóa một lần.
Nhận khóa.
Cung cấp email, công ty, tên, một dòng mô tả sản phẩm bạn đang xây dựng và đánh dấu chấp nhận điều khoản API. Khóa sẽ được gửi qua email cùng một dòng curl có sử dụng khóa đó.
-
60 yêu cầu mỗi ngày UTC cho mỗi khóa
-
Vượt quá 60? API sẽ trả lời lại lúc 00:00 UTC. Cần nhiều hơn? Hãy liên hệ với chúng tôi; một nhà sáng lập sẽ trả lời trong vòng một ngày làm việc (sau khi bạn nhận khóa).
-
Giá cho mục đích sử dụng có trả phí sẽ được báo riêng
Biểu mẫu POST { kind: "api_key", email, company, name, use_case, terms_accepted, source, role, variant, consent_version } đến /api/leads. Phản hồi nêu id của khóa, không phải chính khóa: khóa sẽ được gửi cho bạn qua email. terms_accepted là ô đánh dấu ở trên, mặc định chưa được chọn cho đến khi bạn chọn; nếu không chọn, yêu cầu sẽ bị từ chối và không có dữ liệu nào được gửi. consent_version là phiên bản của nội dung chấp thuận ở trên, được ghi lại cùng yêu cầu để xác nhận bạn chấp nhận điều khoản API. company và name cho biết công ty nào và người nào chấp nhận; cùng với phiên bản chấp thuận và thời điểm gửi yêu cầu, đây là bốn thông tin mà điều khoản API quy định phải có trong hồ sơ chấp thuận, và cả bốn đều được lưu cùng yêu cầu trước khi khóa được gửi qua email. Trước khi bạn nhập thông tin, trang sẽ kiểm tra endpoint đó có hoạt động trên bản triển khai bạn đang xem hay không; nếu không, biểu mẫu sẽ bị vô hiệu hóa và thông báo rõ thay vì giả vờ hoạt động. Gửi cùng thông tin qua email đến support@fixragent.com cũng có tác dụng tương tự.
Sau khi nhận khóa: 60 yêu cầu mỗi ngày và điều gì xảy ra khi vượt giới hạn
Mỗi khóa được dùng cho 60 yêu cầu mỗi ngày UTC. Nếu vượt giới hạn, hãy gửi email đến support@fixragent.com và cho biết bạn đang xây dựng gì — một nhà sáng lập sẽ trả lời trong vòng một ngày làm việc.
Khi khóa đạt 60 yêu cầu trong một ngày UTC, phản hồi là 429 demo_key_quota, với Retry-After được tính đến 00:00 UTC tiếp theo và cùng thông báo đó trong nội dung phản hồi. Khóa không bị thu hồi; API sẽ trả lời lại lúc 00:00 UTC.
Tài liệu tham khảo đầy đủ
Mọi trường, tham số, lỗi và giới hạn đều có trang riêng.
Tham số config, extended, lang
Phản hồi core, extended, agreement
Lỗi mọi mã lỗi, kèm ví dụ
Giới hạn ba cơ chế bảo vệ
Vòng lặp kết quả callback_url
OpenAPI openapi.json
Tệp bộ sưu tập Postman
Điều khoản API /api-terms
Không viết mã? Bắt đầu mà không cần viết gì cả.
Dùng chính hệ thống đó mà không cần xây dựng gì: nhãn dán, hàng đợi và cùng bốn mức độ khẩn cấp.
Bắt đầu
Dành cho đơn vị quản lý bất động sản