Como obter dados estruturados de uma pessoa que seu agente não alcança no chat

O problema

A maioria dos agentes só conversa com uma pessoa: quem está digitando no chat. As tarefas reais envolvem mais gente. Um agente de manutenção precisa da disponibilidade e do orçamento de um encanador. Um agente de recrutamento precisa da data de início de um candidato. Um agente de suporte precisa do novo endereço de um cliente. Nenhum deles está na conversa, e nenhum quer instalar algo ou se cadastrar para responder uma única pergunta.

As soluções improvisadas de sempre são uma cadeia de e-mails que o agente precisa interpretar (“terça serve, talvez quarta, uns 300?”), um Google Form que alguém monta à mão para cada pergunta nova, ou uma página sob medida que sua equipe constrói e depois precisa manter.

O padrão: schema entra, link sai, JSON volta

O Run it by transforma a pergunta em um link. Seu agente descreve o que precisa como um JSON Schema, o mesmo formato que ele já usa para chamar ferramentas, e recebe uma URL de volta. A pessoa abre no celular, preenche um formulário curto sem cadastro, e a resposta volta para o seu agente como um JSON que já segue o schema.

1. Pergunte. Chame createRequest (ferramenta MCP ou POST /v1/requests) com um schema e quem deve responder.
2. Envie. A resposta traz um link por pessoa. Passe sendEmail: true e enviamos a cada pessoa o próprio link por e-mail em seu nome, ou mande por um canal que você já tenha: SMS, WhatsApp, Slack.
3. Receba a resposta. No Builder e no Pro, o MCP push avisa seu agente no instante em que ela chega, e ele segue sozinho. Ela também chega ao seu webhook, em um e-mail para você, ou o agente a lê com getStatus. Veja como fazer seu agente agir assim que alguém responder.

Exemplo: um orçamento de um encanador

Um agente de administração de imóveis precisa que um cano com vazamento seja consertado. Ele pergunta ao encanador a data mais próxima, um preço e qualquer coisa que precise 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 recebe um link por mensagem de texto, vê quem está perguntando (o nome verificado da conta aparece em todas as páginas, seja qual for o nome que o agente dá a si mesmo), escolhe uma data, digita um número e envia. Seu webhook recebe:

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

Sem interpretar texto, sem o “desculpe, qual terça?” de acompanhamento. A data é uma data e o orçamento é um número, porque o formulário não aceitaria outra coisa.

Uma pessoa, várias ou qualquer uma

• Destinatários nomeados (de 1 a 50) recebem cada um o próprio link, então toda resposta é atribuída a uma pessoa. Adicione um e-mail e o agente pode enviar lembretes.
• Um link aberto aceita respostas de qualquer pessoa que o tenha, até maxSubmissions. Use para inscrições ou uma pesquisa rápida com a equipe.
• As aprovações são a versão de sim ou não, com uma regra para quantas pessoas precisam concordar. Veja aprovações antes de o seu agente gastar dinheiro.

Onde isso se encaixa

• Orçamentos e disponibilidade de prestadores, fornecedores ou locais de evento.
• Dados que faltam dos clientes: endereço de entrega, preferências do pedido, uma descrição de um problema sem fotos.
• Dados de onboarding de um novo contratado ou de um novo cliente: data de início, país do documento fiscal, equipamento preferido.
• Aprovação de um proprietário, de um responsável ou de um gestor que nunca vai abrir o seu app.
• Coletar as mesmas poucas respostas de uma equipe, sem uma ferramenta de pesquisa.

Se a pessoa de que você precisa é a que já está conversando com o seu agente, talvez você nem precise de um link: alguns clientes MCP conseguem perguntar a ela diretamente. Comparamos os dois em Run it by vs construir você mesmo e a elicitation do MCP.