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 | 你的外部参考编号，用于回传处理结果。

| callback_url | 确认实际情况后，POST 结果的地址。

为可靠使用而构建

开发者接入前会关心的事项。

固定格式

包含 20 个核心字段，并进行版本管理。无论照片显示的是漏水还是没有问题，格式都相同。

三次读取，一个答案

照片会读取三次（深度模式下为五次），回复会说明结果一致的次数。

一条代码规则

涉及人员可能触碰的线路，或电气设备附近有水时，都会强制标记为紧急。

限流时会明确说明

达到限制时，回复会用一句话说明原因，并提供根据时钟计算的 Retry-After。

无需密钥即可试用

模拟服务器会重放已捕获的回复，因此你可以先接入客户端，再消耗正式请求。

告诉我们结果如何

每条回复都包含 callback_url。确认实际情况后，POST 结果即可。

按需使用西班牙语

lang=es 会以西班牙语返回文本。危险提示行会保留英文，这是有意为之。

照片与对应答案一同保存

我们会先移除位置详情。随后保存答案、文件指纹、清理后的照片及其 Triage Profile。发送 keep_photo false 即可不保存照片。我们的模型提供商会将收到的内容保留 55 天。

在你的 AI 工具中使用

在 Claude、ChatGPT、Cursor 或 Gemini 中发起相同的调用。只需粘贴一次密钥。

获取密钥。

填写你的邮箱、公司、姓名、用一行文字说明你正在构建什么，并勾选 API 条款。密钥会通过电子邮件发送给你，同时附上一条使用该密钥的 curl 命令。

  • 每个密钥每天最多可发起 60 次请求（UTC）

  • 超过 60 次？到 00:00 UTC 后即可再次获得回复。需要更多请求，请联系我们；创始人会在一个工作日内回复（获取密钥后）。

  • 付费使用需报价

表单会将 { 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 次，超出后会怎样

每个密钥每天（UTC）可发起 60 次请求。超出后，请发送邮件至 support@fixragent.com 并说明你正在构建什么——创始人会在一个工作日内回复。

密钥在 UTC 日内达到 60 次请求后，回复会返回 429 demo_key_quota，并提供倒计时至下一个 00:00 UTC 的 Retry-After，消息中也会包含相同的说明。密钥不会被撤销；到 00:00 UTC 后即可再次获得回复。

完整参考文档

每个字段、参数、错误和限制均有独立页面。

参数 config、extended、lang
响应 core、extended、agreement
错误 所有代码及示例
限制 三项防护机制
结果回传流程 callback_url
OpenAPI openapi.json
Postman 集合文件
API 条款 /api-terms

不打算编写代码？无需编写即可开始。

使用同一引擎，无需构建任何东西：贴纸、队列，以及相同的四种紧急程度。

开始使用
面向物业管理者