如何从智能体在聊天里联系不到的人那里获取结构化输入

问题所在

大多数智能体只和一个人对话：在聊天框里打字的那位。真实的任务需要更多人参与。维修智能体需要水管工的空闲时间和报价。招聘智能体需要候选人的入职日期。客服智能体需要客户的新地址。这些人都不在对话里，也不想为了回答一个问题去装应用或注册。

常见的变通办法是：让智能体去解析的邮件往来（“周二可以，也许周三，大概 300？”），每有新问题就有人手工建一个 Google 表单，或者你的团队自己搭一个定制页面，然后还得维护它。

模式：传入 schema，发出链接，拿回 JSON

Run it by 把问题变成一个链接。你的智能体用 JSON Schema 描述它需要什么（这和它调用工具时用的格式相同），然后拿到一个 URL。对方在手机上打开，填一份简短的表单，不用注册，回复会以已经符合 schema 的 JSON 返回给你的智能体。

1. 提问。调用 createRequest（MCP 工具或 POST /v1/requests），传入 schema 和该由谁回复。
2. 发送。响应里每人一个链接。传入 sendEmail: true，我们会以你的名义把各自的链接用邮件发给每个人；你也可以通过现成的渠道发送：短信、WhatsApp、Slack。
3. 拿到回复。在 Builder 和 Pro 套餐上，MCP 推送会在回复一到就通知你的智能体，让它自行继续。回复也会发到你的 Webhook、以邮件发给你，或者由智能体用 getStatus 读取。详见让你的智能体在有人回复的那一刻就行动。

示例：水管工的报价

一个物业管理智能体需要有人修漏水的管道。它向水管工询问最早的日期、价格和任何需要知道的情况：

{
  "mode": "form",
  "title": "Leak at 14 Elm St, unit 3",
  "requester": "Ava (the Elm Properties maintenance agent)",
  "audience": { "kind": "named", "recipients": [{ "name": "Sam Ortiz", "phone": "+1 415 555 0100" }] },
  "schema": {
    "type": "object",
    "required": ["earliestDate", "quote"],
    "properties": {
      "earliestDate": { "type": "string", "format": "date", "title": "Earliest day you can come" },
      "quote": { "type": "number", "minimum": 0, "title": "Estimate (USD)" },
      "notes": { "type": "string", "title": "Anything we should know?", "x-runitby": { "widget": "textarea" } }
    }
  },
  "expiresIn": "48h",
  "webhookUrl": "https://example.com/hooks/runitby"
}

Sam 通过短信收到链接，看到是谁在问（每个页面上都有账号经过验证的名称，不管智能体怎么自称），选好日期，填上一个数字，然后提交。你的 Webhook 会收到：

{
  "event": "response.created",
  "recipient": { "name": "Sam Ortiz" },
  "response": { "data": { "earliestDate": "2026-11-03", "quote": 280, "notes": "Bring access to the basement." } }
}

不用解析，也不用再追问“不好意思，是哪个周二？”。日期就是日期，报价就是数字，因为表单不会接受别的内容。

一个人、几个人，或任何人

• 指定收件人（1 到 50 人）每人有自己的链接，所以每条回复都能对应到人。再加上邮箱，智能体就能发提醒。
• 公开链接接受任何拿到它的人的回复，最多 maxSubmissions 份。适用于报名或快速的团队调查。
• 审批是“是或否”的版本，并带有一条规则，决定需要多少人同意。详见让智能体花钱之前先审批。

适用场合

• 承包商、供应商或场地方的报价和空闲时间。
• 客户缺失的信息：收货地址、订单偏好，以及不用照片的问题描述。
• 新员工或新客户的入驻信息：入职日期、税号所在国家、偏好的设备。
• 房东、家长或经理的确认，而这些人永远不会打开你的应用。
• 不用调查工具，也能向团队收集那几个相同的问题的回复。

如果你要找的人就是正在和智能体聊天的人，可能根本不需要链接：有些 MCP 客户端可以直接询问他们。我们在 Run it by 与自己搭建、与 MCP elicitation 对比里比较了这两者。