Come ottenere input strutturato da una persona che il tuo agente non raggiunge in chat

Il problema

La maggior parte degli agenti parla con una sola persona: chi sta scrivendo in chat. I compiti reali richiedono più persone di così. Un agente per le riparazioni ha bisogno della disponibilità e del preventivo di un idraulico. Un agente di recruiting ha bisogno della data di inizio di un candidato. Un agente di assistenza ha bisogno del nuovo indirizzo di un cliente. Nessuno di loro è nella conversazione, e nessuno vuole installare qualcosa o registrarsi per rispondere a una domanda.

I rimedi di solito sono una catena di email che l’agente deve interpretare («martedì va bene, forse mercoledì, intorno a 300?»), un Google Form che qualcuno costruisce a mano per ogni nuova domanda, o una pagina su misura che il tuo team sviluppa e poi deve mantenere.

Lo schema: schema in ingresso, link in uscita, JSON di ritorno

Run it by trasforma la domanda in un link. Il tuo agente descrive ciò che gli serve come JSON Schema, lo stesso formato che usa già per le chiamate agli strumenti, e riceve un URL. La persona lo apre dal telefono, compila un breve modulo senza registrarsi, e la risposta torna al tuo agente come JSON che rispetta già lo schema.

1. Chiedi. Chiama createRequest (strumento MCP o POST /v1/requests) con uno schema e le persone che devono rispondere.
2. Invia. La risposta contiene un link per persona. Passa sendEmail: true e mandiamo a ciascuno il suo link per email a tuo nome, oppure invialo tu su un canale che hai già: SMS, WhatsApp, Slack.
3. Ricevi la risposta. Su Builder e Pro, MCP push avvisa il tuo agente nell’istante in cui arriva, così prosegue da solo. Arriva anche al tuo webhook, in un’email per te, oppure l’agente la legge con getStatus. Vedi come far agire il tuo agente appena qualcuno risponde.

Esempio: il preventivo di un idraulico

Un agente di gestione immobiliare deve far riparare un tubo che perde. Chiede all’idraulico la prima data disponibile, un prezzo e qualsiasi cosa debba sapere:

{
  "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 riceve un link via SMS, vede chi sta chiedendo (il nome verificato dell’account è su ogni pagina, comunque si faccia chiamare l’agente), sceglie una data, digita un numero e invia. Il tuo webhook riceve:

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

Niente da interpretare, nessun «scusa, quale martedì?» di seguito. La data è una data e il preventivo è un numero, perché il modulo non accetterebbe altro.

Una persona, più persone o chiunque

• I destinatari nominativi (da 1 a 50) ricevono ciascuno il proprio link, così ogni risposta è attribuita a una persona. Aggiungi un’email e l’agente può mandare promemoria.
• Un link aperto accetta risposte da chiunque lo abbia, fino a maxSubmissions. Usalo per iscrizioni o un rapido sondaggio nel team.
• Le approvazioni sono la versione sì-o-no, con una regola su quante persone devono essere d’accordo. Vedi le approvazioni prima che il tuo agente spenda.

Dove è utile

• Preventivi e disponibilità da artigiani, fornitori o sedi.
• Dati mancanti dai clienti: indirizzo di spedizione, preferenze d’ordine, la descrizione di un problema senza foto.
• Informazioni di onboarding da un neoassunto o da un nuovo cliente: data di inizio, paese del codice fiscale, attrezzatura preferita.
• Il via libera di un proprietario di casa, di un genitore o di un responsabile che non aprirà mai la tua app.
• Raccogliere le stesse poche risposte da un team, senza uno strumento di sondaggi.

Se la persona che ti serve è già quella che sta chattando con il tuo agente, forse non ti serve alcun link: alcuni client MCP possono chiederglielo direttamente. Confrontiamo le due strade in Run it by o costruirselo in casa, e Run it by o MCP elicitation.