Cómo obtener datos estructurados de una persona a la que tu agente no llega por chat

El problema

La mayoría de los agentes solo hablan con una persona: quien escribe en el chat. Las tareas reales necesitan a más gente. Un agente de reparaciones necesita la disponibilidad y el presupuesto de un plomero. Un agente de reclutamiento necesita la fecha de inicio de un candidato. Un agente de soporte necesita la nueva dirección de un cliente. Ninguno está en la conversación, y ninguno quiere instalar nada ni registrarse para responder una pregunta.

Las soluciones habituales son un hilo de correos que el agente tiene que interpretar (“El martes me viene bien, quizá el miércoles, unos 300”), un Google Form que alguien arma a mano para cada pregunta nueva, o una página a medida que tu equipo construye y luego tiene que mantener.

El patrón: entra un esquema, sale un enlace, vuelve JSON

Run it by convierte la pregunta en un enlace. Tu agente describe lo que necesita como un JSON Schema, el mismo formato que ya usa para las llamadas a herramientas, y recibe una URL. La persona la abre en el móvil, rellena un formulario corto sin registrarse, y la respuesta vuelve a tu agente como JSON que ya cumple el esquema.

1. Pregunta. Llama a createRequest (herramienta MCP o POST /v1/requests) con un esquema y quién debe responder.
2. Envía. La respuesta trae un enlace por persona. Pasa sendEmail: true y enviamos a cada persona su propio enlace por correo en tu nombre, o mándalo por un canal que ya tengas: SMS, WhatsApp, Slack.
3. Recibe la respuesta. En Builder y Pro, MCP push avisa a tu agente en el instante en que llega, así que sigue por su cuenta. También llega a tu webhook, en un correo para ti, o el agente la lee con getStatus. Mira que tu agente actúe en cuanto alguien responde.

Ejemplo: un presupuesto de un plomero

Un agente de administración de propiedades necesita que arreglen una tubería con fuga. Le pide al plomero la fecha más próxima, un precio y cualquier cosa que deba saber:

{
  "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 recibe un enlace por mensaje de texto, ve quién pregunta (el nombre verificado de la cuenta aparece en cada página, se llame como se llame el agente), elige una fecha, escribe un número y lo envía. Tu webhook recibe:

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

Sin interpretar nada, sin un “perdona, ¿qué martes?” de seguimiento. La fecha es una fecha y el presupuesto es un número, porque el formulario no aceptaría otra cosa.

Una persona, varias o cualquiera

• Los destinatarios con nombre (de 1 a 50) reciben cada uno su propio enlace, así que cada respuesta queda atribuida a una persona. Añade un correo y el agente podrá enviar recordatorios.
• Un enlace abierto acepta respuestas de cualquiera que lo tenga, hasta maxSubmissions. Úsalo para inscripciones o una encuesta rápida al equipo.
• Las aprobaciones son la versión de sí o no, con una regla sobre cuántas personas deben estar de acuerdo. Mira aprobaciones antes de que tu agente gaste dinero.

Dónde encaja

• Presupuestos y disponibilidad de contratistas, proveedores o locales.
• Datos que faltan de los clientes: dirección de envío, preferencias del pedido, la descripción de un problema sin fotos.
• Datos de incorporación de un nuevo empleado o cliente: fecha de inicio, país del identificador fiscal, equipo preferido.
• El visto bueno de un arrendador, de un padre o de un gerente que nunca abrirá tu app.
• Recoger las mismas pocas respuestas de un equipo, sin una herramienta de encuestas.

Si la persona que necesitas es la que ya está hablando con tu agente, quizá no necesites ningún enlace: algunos clientes MCP pueden preguntarle directamente. Comparamos las dos opciones en Run it by frente a construirlo tú mismo y a la elicitación de MCP.