Elige qué funciones y objetos de tu app estarán disponibles para el sistema

App Intents ofrece una de las formas más directas de hacer que una app de iOS sea más útil fuera de su propia interfaz. En lugar de limitar tu app a lo que alguien puede hacer después de abrirla y navegar por sus pantallas, usa Codex para que las acciones y los objetos pertinentes estén disponibles en Atajos, Siri, Spotlight, widgets, controles y experiencias más recientes del sistema que funcionan con asistentes.

Hoy, esto facilita que los usuarios descubran y automaticen acciones, y prepara tu app para un futuro en el que los asistentes tengan más protagonismo. Si tu app ya permite redactar, abrir, filtrar, dirigir a su destino o resumir contenido de valor para el usuario, App Intents le da al sistema una forma estructurada de solicitar esa operación.

Empieza por las acciones y las entidades antes de pensar en las pantallas

Al integrar App Intents por primera vez, “replicar toda la app” rara vez es el mejor enfoque. Pídele a Codex que identifique los siguientes elementos:

• las pocas acciones que un usuario querría ejecutar sin recorrer toda la interfaz
• los objetos de la app que el sistema necesita reconocer para dirigir esas acciones al lugar correcto
• los flujos de trabajo que deben abrir la app en un estado específico y los que deben completarse directamente desde una interfaz del sistema

La guía de Apple sobre App Intents propone un buen punto de partida. Define la acción y la información sobre las entidades que el sistema necesita conocer. Luego, haz que los usuarios puedan encontrar y reutilizar esas acciones en distintas experiencias del sistema. Las referencias más útiles son Cómo hacer que las acciones y el contenido sean fáciles de encontrar y estén disponibles en todo el sistema, Cómo crear el primer intent de tu app y el ejemplo Cómo integrar App Intents para admitir experiencias del sistema.

Piensa en las interfaces del sistema más allá de los atajos

Puedes hacer mucho más que “agregar un atajo”. Una buena integración con App Intents puede hacer que tu app sea útil en varios lugares:

• Atajos, donde los usuarios pueden ejecutar acciones directamente o combinarlas en automatizaciones más amplias
• Siri, donde la app puede ofrecer acciones concretas y enlaces profundos en lugar de limitarse a abrir la pantalla inicial
• Spotlight, donde los usuarios pueden encontrar entidades y atajos de la app y acceder a ellos desde el sistema
• widgets, Actividades en vivo, controles y otras interfaces que usan intents
• experiencias más recientes diseñadas para asistentes, donde al sistema le resulta mucho más fácil interpretar acciones y entidades estructuradas que secuencias arbitrarias de interacción con la interfaz

Sigue un patrón que puedas aplicar en una app real

La integración suele funcionar mejor cuando la app adopta una estructura como esta:

• un target dedicado a App Intents que reúna los tipos de intent para que no queden dispersos en archivos de la app sin relación entre sí
• entradas de AppShortcutsProvider para acciones importantes para el usuario, como redactar una publicación o abrir la app en una pestaña específica
• tipos AppEntity pequeños para los objetos que el sistema necesita interpretar, como cuentas, listas y filtros de la cronología
• una implementación que, al procesar un intent, devuelva el control a la escena principal de la app y permita abrir el flujo de redacción correspondiente o cambiar a la pestaña adecuada

Para la mayoría de las apps, le pediría a Codex que siguiera este patrón. Empieza con una capa pequeña de acciones accesibles desde el sistema, limita la información que expones mediante las entidades y define cómo se devolverá el control a la app en tiempo de ejecución cuando un intent necesite la interfaz principal.

Pídele a Codex que diseñe el conjunto inicial de intents

El prompt más eficaz describe los objetos centrales de tu app y las acciones más importantes para sus usuarios. Luego le pide a Codex que elija el conjunto mínimo de acciones y entidades que resulte útil ofrecer con App Intents, en lugar de exponerlo todo sin un criterio de selección.

Consejos prácticos

Ofrece acciones que los usuarios quieran ejecutar fuera de la app

Para los primeros intents, suelen funcionar bien acciones como redactar, abrir, buscar, filtrar, iniciar, continuar o inspeccionar. Si una acción solo resulta útil después de un proceso largo de configuración dentro de la app, quizá convenga dejarla para una etapa posterior de la integración con App Intents.

Limita las entidades a una parte de tu capa de modelos

Por lo general, el sistema no necesita todo tu modelo de persistencia. Pídele a Codex que defina la información mínima que deben exponer las entidades de la app para que Siri, Atajos y Spotlight tengan suficiente contexto para dirigir la acción al lugar correcto y mostrarla de forma adecuada.

Diseña la integración como infraestructura para asistentes, más allá de los atajos

Aunque en la primera versión las mejoras solo sean visibles en Atajos o Siri, la ventaja de fondo es que tu app empieza a expresar sus funciones mediante acciones y entidades estructuradas. Gracias a esa estructura, a tu app le resultará más fácil integrarse con futuros puntos de acceso del sistema y con los que funcionen con IA que a una app cuyas funciones solo se expresen mediante toques y jerarquías de vistas.