Siri può richiamare la tua app. Quale azione rendere disponibile per prima?

Un pacco è in ritardo. Il cliente vuole sapere se arriverà in ufficio prima che esca, ma la risposta utile si trova dietro una schermata di accesso, un elenco di ordini e una pagina di tracciamento. Una richiesta in linguaggio naturale può accorciare il percorso, se l’app offre all’assistente un modo ben definito per trovare la spedizione giusta.

Il 3 novembre Apple ha aperto l’anteprima per sviluppatori di Siri AI per App Intents, in software beta tra cui iOS 27.3. L’anteprima consente di collegare le app a richieste che possono usare il contesto personale, le informazioni sullo schermo e azioni correlate. Apple prevede di portare l’integrazione ai clienti più avanti, con l’invio delle app all’App Store previste in primavera. Gli sviluppatori possono definire il comportamento di un’azione prima che le persone inizino a farci affidamento.

Siri nel 2014, fotografata da Kārlis Dambrāns. Immagine ritagliata e ridimensionata, CC BY 2.0. Fonte dell’immagine · Licenza.

Affida all’assistente un compito con un esito riconoscibile

Ricerca con App Intent. Illustrazione originale di Telli.sh.

Un App Intent rappresenta un’operazione che l’app è pronta a eseguire. Pensa a un’app per spedizioni che rende disponibile la ricerca dello stato di un pacco. L’input può essere un’entità spedizione che l’app sa individuare, e il risultato può identificare la spedizione, l’ultimo stato e l’ora di aggiornamento. L’app è responsabile dei dati e decide quali informazioni può vedere l’account autenticato.

Questo progetto mantiene l’interazione breve e permette di dare una risposta precisa. Se un account ha tre consegne in corso, l’assistente ha bisogno di abbastanza informazioni per distinguerle. Un codice di tracciamento, un nome breve o una destinazione riconoscibile possono rendere la scelta concreta. Una frase ambigua come «il mio pacco» dovrebbe portare a una richiesta di chiarimento quando più elementi corrispondono.

Le prime due righe sono un buon punto di partenza. Di solito possono restituire una risposta utile senza creare una transazione. Cambiare una prenotazione comporta condizioni diverse. L’orario richiesto potrebbe essere esaurito, il locale potrebbe applicare una commissione oppure una conversione di fuso orario potrebbe cambiare la data. Queste condizioni devono trovare posto sia nell’azione dell’app sia nella sua risposta.

Fai verificare i permessi all’app nel momento in cui agisce

Scrittura con App Intent. Illustrazione originale di Telli.sh.

L’assistente può interpretare una frase e individuare un’azione possibile. Spetta comunque all’app verificare chi la chiede, a quale oggetto può accedere e se l’operazione può procedere. Applica allo stesso percorso i controlli già usati nell’interfaccia dell’app. Una richiesta in linguaggio naturale può arrivare mentre la persona usa un altro account, su un dispositivo bloccato o dopo la scadenza della sessione.

Prima di un impegno economico, mostra un’ultima volta l’importo e a chi sarà addebitato. Per una modifica alla consegna, rendi visibile la destinazione prima della conferma. Se il backend non può sapere se la richiesta è andata a buon fine, l’app dovrebbe mostrare uno stato che l’utente può chiarire, evitando di spingerlo a inviare una seconda richiesta identica. Chiunque abbia progettato una schermata di pagamento conosce queste regole. In un’interazione vocale o in chat, la stessa chiarezza deve a volte stare in molto meno spazio.

Prendiamo un esempio semplice. Una persona chiede di ordinare di nuovo una confezione di caffè. Il primo ordine potrebbe avere usufruito di uno sconto temporaneo, l’indirizzo selezionato potrebbe essere superato e il prodotto potrebbe esistere in più formati. Un’esperienza prudente può indicare l’articolo attuale, il formato, il prezzo e l’indirizzo prima di effettuare l’ordine. Può anche rendere facile ritrovare la ricevuta.

Il contesto dell’utente aiuta a partire dal punto giusto. Deve restare chiaro quali elementi l’app ha effettivamente usato. Una conferma come «l’ordine che hai sullo schermo» può bastare quando è visibile un solo ordine. Se ci sono più elementi, ripeti la scelta precisa. Dai alla persona modo di correggere l’interpretazione prima che l’app agisca.

Una sequenza di azioni deve mostrare come è andata davvero

Apple descrive anche le skill che compongono più azioni e il supporto per le entità nell’indice semantico di Spotlight. Insieme, queste funzioni possono ridurre il numero di schermate fra una richiesta e il risultato. Rendono anche più importanti i piccoli errori in un’operazione, perché l’output di un’azione può diventare l’input della successiva.

Immagina di chiedere di trovare una prenotazione in programma e spostarla. La ricerca può riuscire e la modifica fallire. Comunica entrambi gli esiti. Dire che hai trovato la prenotazione e che ha ancora l’orario iniziale offre alla persona un’informazione utile e un passo successivo chiaro. Un generico messaggio di successo nasconderebbe l’errore, mentre un errore generico nasconderebbe la ricerca riuscita.

Una sequenza concreta richiede spesso più tipi di risultato. Un passaggio può restituire un candidato. Uno successivo può chiedere una scelta o una conferma. L’ultimo può restituire una ricevuta o indicare che l’operazione è in corso. Quando componi le azioni, prova sia il caso in cui una persona cambia idea a metà sia quello in cui una richiesta di rete dura più di quanto sia ragionevole aspettare.

Usa internamente un identificativo stabile per il record. I nomi in linguaggio naturale cambiano e più elementi possono avere nomi simili. Un ID stabile permette all’app di riconoscere se ha operato sull’elemento previsto e di restituire comunque una descrizione comprensibile. Conserva un link al record originale, così chi ha bisogno di contesto può riaprire l’app sulla schermata giusta.

Prova l’anteprima con un’azione verificabile a mano

1. Controlla nell’annuncio Apple per sviluppatori quali sistemi beta, dispositivi e lingue sono supportati. Usa un account e dati di prova. Apple include il coreano fra le lingue supportate e descrive i limiti per dispositivo e regione.
2. Scegli un’operazione di lettura che le persone usano già regolarmente. Annota il percorso normale nell’interfaccia e la risposta esatta attesa quando l’azione riesce.
3. Usa la documentazione Apple di App Intents per modellare l’azione e l’entità su cui opera. Decidi che cosa deve succedere se la richiesta trova zero, uno o più record.
4. Esegui l’azione in situazioni normali e ambigue. Includi un account assente, una sessione scaduta, nomi duplicati e la rete indisponibile. Confronta ogni risultato con la schermata attuale dell’app.
5. Per un’azione di scrittura successiva, annota dove la persona vede l’oggetto, le condizioni e l’esito. Aggiungi una prova che ripete la richiesta dopo un timeout e controlla che l’app la gestisca correttamente.
6. Tratta la data di disponibilità per i clienti e l’anteprima per sviluppatori come due tappe separate. Quando pianifichi l’uscita sull’App Store, ricontrolla le regole e le informazioni di Apple sull’invio.

È un buon momento per provare le varianti linguistiche. Un’app di consegne può partire dalle espressioni che i clienti usano nelle richieste di assistenza. Alcune includono una data, altre nominano il negozio e altre ancora indicano un pacco per destinazione. Osserva come l’azione chiede il dettaglio mancante quando la frase è incompleta. Un chiarimento utile avvicina la persona alla risposta.

Scegli dove presentare il risultato

Apple distingue fra entità dell’app in Spotlight, azioni specifiche dell’app, snippet e skill che combinano azioni. Un’app per spedizioni può decidere quale di queste modalità è adatta a una domanda concreta. Un’entità nella ricerca può aiutare a riconoscere un ordine. Un’azione può elaborare una richiesta rispetto all’account attuale. Una scheda può mostrare il risultato a colpo d’occhio. Una sequenza serve quando trovare l’ordine è solo il primo passo.

Per una ricerca di stato, una scheda potrebbe mostrare la città di destinazione, lo stato attuale e l’ora dell’ultimo aggiornamento del corriere. La quantità di dettagli appropriata dipende da dove appare la scheda e dal fatto che il dispositivo sia bloccato. Prova la schermata senza presumere che la persona senta un avviso vocale. Prova la versione parlata senza affidare allo schermo una nota essenziale. Gli stessi dati devono essere comprensibili in entrambi i casi.

La guida all’anteprima spiega anche come l’assistente individua l’app di destinazione. Per un’azione personalizzata con l’app in background occorre nominarla, salvo nei contesti indicati di seguito. Un’app in primo piano, una Live Activity attiva o una conversazione che l’ha già nominata possono fornire il contesto necessario. Inizia da un richiamo esplicito, per verificare che l’azione funzioni. Poi prova la stessa richiesta dalla schermata Home, con un’altra app visibile e durante una conversazione già avviata. Annota il risultato in ciascun contesto.

Verifica separatamente il canale di distribuzione

La guida all’anteprima descrive i test su dispositivi con build firmate per lo sviluppo e i test con TestFlight interno. Precisa che le build di TestFlight esterno e quelle dell’App Store non possono esercitare queste integrazioni in anteprima. È un dettaglio importante quando chi gestisce il prodotto chiede una prova con i clienti. Una dimostrazione valida in una build di sviluppo non prova che un cliente possa attivare la funzione in una build distribuita sullo store.

Apple indica il supporto per i dispositivi compatibili con Apple Intelligence e per sei lingue, compreso il coreano. Si applicano anche limiti per regione ed età e lato server. Apple elenca le beta 27.3 di iOS, iPadOS, macOS, watchOS e visionOS per Siri AI, mentre l’anteprima iniziale per le app di terze parti nomina iOS, iPadOS, macOS e visionOS. Tieni distinti i due perimetri quando assegni le prove. Un rapporto di test preciso aiuta chi lo legge a capire se un problema dipende dall’azione, dal canale di test o dal dispositivo.

Per un test interno, dedica una riga a ogni combinazione di richiesta, dispositivo, lingua, canale di distribuzione e risultato. Parti da un caso che sai funzionare. Per una ricerca dello stato in coreano, confronta una frase breve e colloquiale con una richiesta che include il rivenditore o la data di tracciamento. Se entrambe portano allo stesso record, l’interazione ha superato una variazione utile. Se una mostra l’ordine di un’altra persona, interrompi la prova e correggi il controllo delle autorizzazioni alla fonte.

La verifica finale dovrebbe prevedere un normale passaggio alla persona. Se l’intent trova una prenotazione ma non può spostarla, mostra l’orario disponibile e apri la schermata giusta. Se la modifica riesce, mostra il risultato e permetti all’utente di trovare più avanti la ricevuta nell’app. In entrambi i casi la persona ha un passo successivo preciso.

Una scorciatoia conquista fiducia un’azione alla volta

L’aspetto interessante dell’integrazione con Siri AI è la possibilità di avvicinare la funzione più utile dell’app a chi ne ha bisogno. Un’azione circoscritta e verificabile può essere utile anche senza un ampio catalogo di integrazioni. Per un’azienda che sa mostrare lo stato esatto di una consegna, è un buon punto di partenza.

Quando aggiungi azioni, usa lo stesso criterio per tutte. La persona dovrebbe capire che cosa ha trovato l’app, che cosa ha chiesto il permesso di fare e che cosa è successo. Questa chiarezza conta ancora di più se una richiesta attraversa più servizi o se l’utente non apre mai la finestra dell’app originale.

Fonti

• Annuncio dell’anteprima di Siri AI del 3 novembre su Apple Developer
• Documentazione Apple di App Intents
• Guida Apple alla configurazione e ai test dell’anteprima per sviluppatori
• Documentazione Apple di Spotlight e App Intents

---

Per conservare e ritrovare le conversazioni e le decisioni che accompagnano il tuo lavoro, crea un account Telli.sh.