For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navigation principale
Theme
Codex

Codex use case

Ajoutez des App Intents à une application iOS

Avec Codex, rendez les actions et le contenu de votre application accessibles dans Raccourcis, Siri, Spotlight et les nouvelles interfaces système qui font appel à un assistant.

Difficulty Advanced
Time horizon 1h

Avec Codex et le plugin Build iOS Apps, déterminez quelles actions et entités de votre application exposer via App Intents. Intégrez-les à des interfaces système comme Raccourcis et Spotlight, puis préparez votre application à prendre progressivement en charge davantage de workflows pilotés par un assistant.

Best for

  • Applications iOS qui proposent déjà des actions ou du contenu utiles, mais qui restent invisibles dans Raccourcis, Siri, Spotlight ou ailleurs dans le système
  • Équipes qui souhaitent rendre accessibles dès maintenant quelques actions particulièrement utiles, puis adapter progressivement leurs workflows aux assistants
  • Applications dont les objets sont bien définis (comptes, listes, filtres, destinations, brouillons ou médias) et pourraient devenir des entités d’application accessibles en dehors de l’interface

Contents

    ← All use cases

    Ajoutez des App Intents à une application iOS

    Avec Codex, rendez les actions et le contenu de votre application accessibles dans Raccourcis, Siri, Spotlight et les nouvelles interfaces système qui font appel à un assistant.

    Avec Codex et le plugin Build iOS Apps, déterminez quelles actions et entités de votre application exposer via App Intents. Intégrez-les à des interfaces système comme Raccourcis et Spotlight, puis préparez votre application à prendre progressivement en charge davantage de workflows pilotés par un assistant.

    Advanced
    1h

    Avec Codex et le plugin Build iOS Apps, déterminez quelles actions et entités de votre application exposer via App Intents. Intégrez-les à des interfaces système comme Raccourcis et Spotlight, puis préparez votre application à prendre progressivement en charge davantage de workflows pilotés par un assistant.

    Advanced
    1h

    Best for

    • Applications iOS qui proposent déjà des actions ou du contenu utiles, mais qui restent invisibles dans Raccourcis, Siri, Spotlight ou ailleurs dans le système
    • Équipes qui souhaitent rendre accessibles dès maintenant quelques actions particulièrement utiles, puis adapter progressivement leurs workflows aux assistants
    • Applications dont les objets sont bien définis (comptes, listes, filtres, destinations, brouillons ou médias) et pourraient devenir des entités d’application accessibles en dehors de l’interface

    Skills & Plugins

    • Utilisez les Skills de compilation iOS et de développement SwiftUI pour ajouter des App Intents, des entités d’application et des App Shortcuts. Vérifiez ensuite que l’application compile toujours et que chaque point d’entrée activé par un intent mène au bon écran ou au bon workflow.
    Skill Why use it
    Build iOS Apps Utilisez les Skills de compilation iOS et de développement SwiftUI pour ajouter des App Intents, des entités d’application et des App Shortcuts. Vérifiez ensuite que l’application compile toujours et que chaque point d’entrée activé par un intent mène au bon écran ou au bon workflow.

    Starter prompt

    Utilisez le plugin Build iOS Apps pour examiner cette application iOS et ajouter des App Intents pour les actions et les entités à rendre accessibles au système. Contraintes : - Commencez par repérer les actions les plus utiles aux utilisateurs et les principaux objets à rendre accessibles hors de l’application, dans Raccourcis, Siri, Spotlight, les widgets, les contrôles ou les nouvelles interfaces système qui font appel à un assistant. - Limitez la portée de cette première étape. Choisissez quelques intents réellement utiles sans ouvrir l’application complète. Ajoutez aussi les intents qui doivent ouvrir l’application directement sur un écran ou un workflow précis. - Définissez des entités d’application uniquement pour les données dont le système a besoin pour interpréter ces actions et les acheminer au bon endroit. Si quelques entités suffisent, évitez de reproduire toute la couche de modèles interne. - Ajoutez des App Shortcuts là où ils permettent aux utilisateurs de trouver plus facilement les actions. Choisissez des titres, des formulations et des représentations à l’écran qui conviennent à Siri, Spotlight et Raccourcis. - Si l’application doit traiter un intent dans son interface principale, renvoyez le résultat à l’application et expliquez comment la scène de l’application prend le relais. - Compilez et validez l’application à l’issue de cette première étape, puis récapitulez les actions, les entités et les interfaces système désormais prises en charge. Livrables : - La liste des intents et des entités que vous recommandez d’exposer dans une première version - Les intents, les entités et les App Shortcuts mis en œuvre - Une description de la façon dont l’application achemine ou traite ces intents à l’exécution - Les fonctionnalités du système Apple désormais accessibles et celles qu’il serait logique de prendre en charge ensuite
    Utilisez le plugin Build iOS Apps pour examiner cette application iOS et ajouter des App Intents pour les actions et les entités à rendre accessibles au système. Contraintes : - Commencez par repérer les actions les plus utiles aux utilisateurs et les principaux objets à rendre accessibles hors de l’application, dans Raccourcis, Siri, Spotlight, les widgets, les contrôles ou les nouvelles interfaces système qui font appel à un assistant. - Limitez la portée de cette première étape. Choisissez quelques intents réellement utiles sans ouvrir l’application complète. Ajoutez aussi les intents qui doivent ouvrir l’application directement sur un écran ou un workflow précis. - Définissez des entités d’application uniquement pour les données dont le système a besoin pour interpréter ces actions et les acheminer au bon endroit. Si quelques entités suffisent, évitez de reproduire toute la couche de modèles interne. - Ajoutez des App Shortcuts là où ils permettent aux utilisateurs de trouver plus facilement les actions. Choisissez des titres, des formulations et des représentations à l’écran qui conviennent à Siri, Spotlight et Raccourcis. - Si l’application doit traiter un intent dans son interface principale, renvoyez le résultat à l’application et expliquez comment la scène de l’application prend le relais. - Compilez et validez l’application à l’issue de cette première étape, puis récapitulez les actions, les entités et les interfaces système désormais prises en charge. Livrables : - La liste des intents et des entités que vous recommandez d’exposer dans une première version - Les intents, les entités et les App Shortcuts mis en œuvre - Une description de la façon dont l’application achemine ou traite ces intents à l’exécution - Les fonctionnalités du système Apple désormais accessibles et celles qu’il serait logique de prendre en charge ensuite

    Rendez les fonctionnalités utiles de votre application accessibles au système

    Le framework App Intents offre un moyen simple de rendre une application iOS plus utile en dehors de sa propre interface. Certaines actions ne devraient pas obliger les utilisateurs à ouvrir l’application et à parcourir ses écrans. Utilisez Codex pour rendre les actions et les objets pertinents accessibles depuis Raccourcis, Siri, Spotlight, les widgets, les commandes et les interfaces système plus récentes qui font appel à des assistants.

    Dès aujourd’hui, cette intégration permet aux utilisateurs de découvrir plus facilement les fonctionnalités de votre application et d’automatiser des tâches. Elle prépare aussi l’application à un usage accru des assistants. Si votre application permet déjà de rédiger un contenu, d’ouvrir un élément, de filtrer des résultats, d’acheminer une demande ou de produire un résumé, App Intents donne au système un moyen structuré de faire appel à ces fonctionnalités.

    Commencez par les actions et les entités, sans reprendre chaque écran

    Pour une première intégration d’App Intents, il est rarement judicieux de vouloir « reproduire toute l’application ». Demandez à Codex d’identifier les éléments suivants :

    • les quelques actions qu’un utilisateur souhaiterait déclencher sans parcourir toute l’interface
    • les objets de l’application que le système doit connaître pour diriger ces actions vers la bonne cible
    • les workflows qui doivent ouvrir l’application dans un état précis et ceux qui doivent s’exécuter jusqu’au bout directement depuis une interface système

    Les recommandations d’Apple pour App Intents proposent une démarche adaptée. Définissez l’action, puis les entités et les propriétés dont le système a besoin. Rendez ensuite ces actions faciles à trouver et à réutiliser dans différentes interfaces du système. Consultez les guides Rendre les actions et les contenus faciles à trouver et largement accessibles et Créer votre première intention d’application, ainsi que l’exemple Intégrer App Intents aux interfaces du système.

    Pensez aux différentes interfaces du système, au-delà des raccourcis

    Les possibilités vont bien au-delà du simple fait d’« ajouter un raccourci ». Une intégration bien conçue d’App Intents permet d’utiliser votre application dans plusieurs contextes :

    • Raccourcis, où les utilisateurs peuvent exécuter des actions directement ou les combiner pour créer des automatisations plus complexes
    • Siri, où l’application peut proposer des commandes qui expriment des actions précises et des liens profonds vers les écrans correspondants, au lieu de simplement s’ouvrir
    • Spotlight, où les utilisateurs peuvent retrouver les entités et les raccourcis de l’application et y accéder directement depuis le système
    • les widgets, les activités en direct, les commandes et les autres interfaces qui s’appuient sur des intentions
    • les interfaces plus récentes destinées aux assistants, où le système comprend bien plus facilement des actions et des entités structurées que des enchaînements d’écrans propres à chaque application

    Inspirez-vous de l’architecture d’une application réelle

    En général, l’intégration fonctionne mieux avec une structure de ce type :

    • une cible dédiée à App Intents pour regrouper les types d’intentions qui seraient autrement dispersés dans des fichiers sans rapport entre eux
    • des entrées AppShortcutsProvider pour les actions les plus utiles aux utilisateurs, comme rédiger une publication ou ouvrir l’application sur un onglet précis
    • des types AppEntity simples pour représenter les éléments que le système doit pouvoir interpréter, comme les comptes, les listes et les filtres du fil d’actualité
    • un traitement des intentions qui passe le relais à la scène principale de l’application, de sorte qu’une intention déclenchée puisse ouvrir l’interface de rédaction appropriée ou afficher le bon onglet

    C’est l’approche que je demanderais à Codex de suivre pour la plupart des applications. Commencez par exposer quelques actions au système, limitez les informations exposées par les entités et prévoyez précisément comment l’application prendra le relais lorsqu’une intention nécessite l’interface principale.

    Demandez à Codex de concevoir une première intégration d’App Intents

    Pour rédiger un prompt efficace, indiquez à Codex les principaux objets de votre application et les actions les plus importantes pour ses utilisateurs. Demandez-lui ensuite de choisir le plus petit ensemble d’actions et d’entités qui présente un intérêt pour une première intégration d’App Intents, sans tout exposer d’emblée.

    Conseils pratiques

    Exposez les actions que les utilisateurs souhaitent effectuer en dehors de l’application

    Pour vos premières intentions, privilégiez des actions comme rédiger, ouvrir, rechercher, filtrer, démarrer, poursuivre ou examiner. Si une action ne présente d’intérêt qu’après une longue phase de configuration dans l’application, mieux vaut peut-être la réserver à une intégration ultérieure.

    Limitez vos entités à une partie de votre modèle de données

    Le système a rarement besoin de l’intégralité de votre modèle de persistance. Demandez à Codex de limiter les informations exposées par les entités au strict nécessaire pour que Siri, Raccourcis et Spotlight disposent d’assez de contexte pour diriger l’action vers la bonne cible et l’afficher correctement.

    Faites de cette intégration une base pour les assistants, au-delà des raccourcis

    Même si les seules améliorations visibles dans votre première version concernent Raccourcis ou Siri, le principal bénéfice est que votre application commence à décrire ses fonctionnalités sous forme d’actions et d’entités structurées. Elle pourra ainsi s’intégrer plus facilement aux futurs points d’entrée proposés par le système ou pilotés par l’IA qu’une application dont les fonctionnalités ne s’expriment qu’à travers des gestes tactiles et des hiérarchies de vues.

    Tech stack

    Need

    Accès aux actions

    Default options

    App Intents

    Why it's needed

    Le framework App Intents définit comment votre application déclare ses actions pour les rendre accessibles dans Raccourcis, Siri, Spotlight, les widgets, les contrôles et les nouvelles interfaces destinées aux assistants.

    Need

    Données accessibles au système

    Default options

    AppEntity, EntityQuery et représentations à l’écran

    Why it's needed

    Quelques entités bien définies suffisent au système pour comprendre les objets de votre application sans que vous ayez à exposer toute la couche de modèles.

    Need

    Découverte des actions

    Default options

    AppShortcutsProvider avec des formulations, des titres et des symboles explicites

    Why it's needed

    Grâce aux App Shortcuts, les utilisateurs peuvent facilement trouver et lancer les premières actions disponibles sans avoir à créer leurs raccourcis de toutes pièces.

    Need

    Cycle de validation

    Default options

    xcodebuild, tests sur simulateur et vérification ciblée du routage à l’exécution

    Why it's needed

    Une fois la cible des intents compilée, le plus délicat reste de vérifier que l’application s’ouvre ou mène au bon écran lorsque le système invoque un intent.

    Need Default options Why it's needed
    Accès aux actions App Intents Le framework App Intents définit comment votre application déclare ses actions pour les rendre accessibles dans Raccourcis, Siri, Spotlight, les widgets, les contrôles et les nouvelles interfaces destinées aux assistants.
    Données accessibles au système AppEntity , EntityQuery et représentations à l’écran Quelques entités bien définies suffisent au système pour comprendre les objets de votre application sans que vous ayez à exposer toute la couche de modèles.
    Découverte des actions AppShortcutsProvider avec des formulations, des titres et des symboles explicites Grâce aux App Shortcuts, les utilisateurs peuvent facilement trouver et lancer les premières actions disponibles sans avoir à créer leurs raccourcis de toutes pièces.
    Cycle de validation xcodebuild , tests sur simulateur et vérification ciblée du routage à l’exécution Une fois la cible des intents compilée, le plus délicat reste de vérifier que l’application s’ouvre ou mène au bon écran lorsque le système invoque un intent.

    Related use cases