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

Codex use case

Ajoutez des App Intents à une app iOS

Utilisez Codex pour rendre les actions et le contenu de votre app accessibles à Raccourcis, Siri, Spotlight et aux expériences système plus récentes pilotées par des assistants.

Difficulty Avancé
Time horizon 1 h

Utilisez Codex et le plugin Build iOS Apps pour identifier les actions et les entités que votre app doit exposer via App Intents, les intégrer à des interfaces système comme Raccourcis et Spotlight, et préparer progressivement votre app à des flux de travail davantage pilotés par des assistants.

Idéal pour

  • Apps iOS qui proposent déjà des actions ou du contenu utiles, mais restent invisibles pour Raccourcis, Siri, Spotlight ou le reste du système
  • Équipes qui souhaitent exposer dès maintenant quelques actions à forte valeur ajoutée et développer progressivement des flux de travail mieux adaptés aux assistants
  • Apps comportant des objets bien définis, comme des comptes, des listes, des filtres, des destinations, des brouillons ou des médias, qui peuvent devenir des entités d’app au lieu de rester cantonnés à l’interface utilisateur

Contents

    ← Tous les cas d’utilisation

    Ajoutez des App Intents à une app iOS

    Utilisez Codex pour rendre les actions et le contenu de votre app accessibles à Raccourcis, Siri, Spotlight et aux expériences système plus récentes pilotées par des assistants.

    Utilisez Codex et le plugin Build iOS Apps pour identifier les actions et les entités que votre app doit exposer via App Intents, les intégrer à des interfaces système comme Raccourcis et Spotlight, et préparer progressivement votre app à des flux de travail davantage pilotés par des assistants.

    Avancé
    1 h

    Utilisez Codex et le plugin Build iOS Apps pour identifier les actions et les entités que votre app doit exposer via App Intents, les intégrer à des interfaces système comme Raccourcis et Spotlight, et préparer progressivement votre app à des flux de travail davantage pilotés par des assistants.

    Avancé
    1 h

    Idéal pour

    • Apps iOS qui proposent déjà des actions ou du contenu utiles, mais restent invisibles pour Raccourcis, Siri, Spotlight ou le reste du système
    • Équipes qui souhaitent exposer dès maintenant quelques actions à forte valeur ajoutée et développer progressivement des flux de travail mieux adaptés aux assistants
    • Apps comportant des objets bien définis, comme des comptes, des listes, des filtres, des destinations, des brouillons ou des médias, qui peuvent devenir des entités d’app au lieu de rester cantonnés à l’interface utilisateur

    Skills et plugins

    • Utilisez les Skills de compilation iOS et SwiftUI pour ajouter des App Intents, des entités d’app et des raccourcis d’app, puis vérifiez que l’app se compile toujours et achemine correctement les points d’entrée déclenchés par des intents.
    Skill Why use it
    Build iOS Apps Utilisez les Skills de compilation iOS et SwiftUI pour ajouter des App Intents, des entités d’app et des raccourcis d’app, puis vérifiez que l’app se compile toujours et achemine correctement les points d’entrée déclenchés par des intents.

    Prompt de démarrage

    Utilisez le plugin Build iOS Apps pour auditer cette app iOS et ajouter des App Intents pour les actions et les entités qui doivent être exposées au système. Contraintes : - Commencez par repérer les actions utilisateur les plus utiles et les objets fondamentaux de l’app qui doivent être accessibles hors de celle-ci dans Raccourcis, Siri, Spotlight, les widgets, les commandes ou les interfaces système plus récentes pilotées par des assistants. - Limitez la première implémentation. Sélectionnez un petit ensemble d’intents véritablement utiles sans ouvrir l’app complète, ainsi que les intents d’ouverture de l’app qui doivent mener directement à un écran ou à un flux de travail précis. - Définissez des entités d’app uniquement pour les données que le système doit réellement comprendre afin d’acheminer ces actions. Ne reproduisez pas toute la couche de modèles interne si un périmètre d’entités plus restreint suffit. - Ajoutez des raccourcis d’app lorsqu’ils facilitent la découverte de l’expérience, et choisissez des titres, des phrases et des représentations d’affichage adaptés à Siri, Spotlight et Raccourcis. - Si l’app doit traiter l’intent dans l’interface principale, transmettez proprement le résultat à l’app et expliquez comment sa scène réagit à ce transfert. - Compilez et validez l’app après la première implémentation, puis résumez les actions, les entités et les interfaces système désormais prises en charge. Livrables : - le périmètre d’intents et d’entités recommandé pour une première version - les intents, les entités et les raccourcis d’app implémentés - la manière dont l’app achemine ou traite ces intents à l’exécution - les expériences système Apple que cette implémentation rend accessibles dès maintenant et celles qui constituent la suite logique
    Utilisez le plugin Build iOS Apps pour auditer cette app iOS et ajouter des App Intents pour les actions et les entités qui doivent être exposées au système. Contraintes : - Commencez par repérer les actions utilisateur les plus utiles et les objets fondamentaux de l’app qui doivent être accessibles hors de celle-ci dans Raccourcis, Siri, Spotlight, les widgets, les commandes ou les interfaces système plus récentes pilotées par des assistants. - Limitez la première implémentation. Sélectionnez un petit ensemble d’intents véritablement utiles sans ouvrir l’app complète, ainsi que les intents d’ouverture de l’app qui doivent mener directement à un écran ou à un flux de travail précis. - Définissez des entités d’app uniquement pour les données que le système doit réellement comprendre afin d’acheminer ces actions. Ne reproduisez pas toute la couche de modèles interne si un périmètre d’entités plus restreint suffit. - Ajoutez des raccourcis d’app lorsqu’ils facilitent la découverte de l’expérience, et choisissez des titres, des phrases et des représentations d’affichage adaptés à Siri, Spotlight et Raccourcis. - Si l’app doit traiter l’intent dans l’interface principale, transmettez proprement le résultat à l’app et expliquez comment sa scène réagit à ce transfert. - Compilez et validez l’app après la première implémentation, puis résumez les actions, les entités et les interfaces système désormais prises en charge. Livrables : - le périmètre d’intents et d’entités recommandé pour une première version - les intents, les entités et les raccourcis d’app implémentés - la manière dont l’app achemine ou traite ces intents à l’exécution - les expériences système Apple que cette implémentation rend accessibles dès maintenant et celles qui constituent la suite logique

    Rendez visibles au système les éléments pertinents de votre app

    Les App Intents sont l’un des moyens les plus directs de rendre une app iOS plus utile en dehors de sa propre interface. Au lieu de considérer votre app comme un environnement fermé, qui ne fonctionne qu’après son lancement et quelques interactions, utilisez Codex pour exposer les actions et les objets qui doivent être accessibles à Raccourcis, Siri, Spotlight, aux widgets, aux commandes et aux expériences système plus récentes pilotées par des assistants.

    C’est utile dès aujourd’hui pour la découverte et l’automatisation, et cela prépare solidement votre app à un avenir davantage piloté par des assistants. Si votre app permet déjà de créer, d’ouvrir, de filtrer, d’acheminer ou de résumer un contenu utile, les App Intents offrent au système un moyen structuré de solliciter cette capacité.

    Commencez par les actions et les entités, pas par tous les écrans

    Pour une première implémentation d’App Intents, la meilleure approche ne consiste généralement pas à « reproduire toute l’app ». Demandez à Codex d’identifier :

    • les quelques actions qu’un utilisateur souhaiterait déclencher sans parcourir toute l’interface
    • les objets de l’app que le système doit comprendre pour acheminer correctement ces actions
    • les flux de travail qui doivent ouvrir l’app dans un état précis, par opposition à ceux qui doivent s’exécuter entièrement depuis une interface système

    Les recommandations d’Apple sur App Intents constituent ici un bon cadre : définissez l’action, puis le périmètre d’entités nécessaire au système, avant de rendre ces actions détectables et réutilisables dans les différentes expériences système. Les références les plus utiles sont Rendre les actions et le contenu détectables et largement disponibles, Créer votre premier intent d’app et l’exemple d’expérience système Adopter App Intents pour prendre en charge les expériences système.

    Raisonnez en termes d’interfaces système, pas seulement de raccourcis

    Les possibilités ne se limitent pas à « ajouter un raccourci ». Un ensemble d’App Intents bien conçu peut rendre votre app utile à plusieurs endroits :

    • Raccourcis, où les utilisateurs peuvent exécuter directement des actions ou les combiner dans des automatisations plus larges
    • Siri, où l’app peut exposer des verbes pertinents et des liens profonds au lieu de simplement s’ouvrir sans destination précise
    • Spotlight, où les entités d’app et les raccourcis d’app deviennent des points d’entrée système faciles à découvrir
    • les widgets, les Activités en direct, les commandes et les autres interfaces utilisateur pilotées par des intents
    • les expériences plus récentes destinées aux assistants, dans lesquelles le système comprend bien plus facilement des actions et des entités structurées que des parcours arbitraires dans l’interface

    Suivez un modèle d’architecture concret

    Cette approche fonctionne généralement mieux lorsque l’app adopte une structure de ce type :

    • une cible App Intents dédiée, plutôt que des types d’intent dispersés dans des fichiers de l’app sans rapport entre eux
    • des entrées AppShortcutsProvider pour des actions utilisateur importantes, comme rédiger une publication ou ouvrir l’app sur un onglet précis
    • de petits types AppEntity pour les éléments sur lesquels le système doit raisonner, comme les comptes, les listes et les filtres de fil d’actualité
    • une gestion des intents qui redirige proprement vers la scène principale de l’app, de sorte qu’un intent invoqué puisse ouvrir le bon parcours de rédaction ou faire basculer l’app sur le bon onglet

    C’est le modèle que je demanderais à Codex de suivre pour la plupart des apps : commencez par une petite couche d’actions exposée au système, limitez le périmètre des entités et mettez en place un transfert prévisible vers l’app à l’exécution lorsqu’un intent nécessite l’interface principale.

    Demandez à Codex de concevoir le premier ensemble d’intents à exposer

    Le prompt le plus efficace décrit à Codex les objets fondamentaux de votre app et les principales actions utilisateur, puis lui demande de choisir le plus petit ensemble initial d’App Intents qui soit utile, plutôt que de tout exposer aveuglément.

    Conseils pratiques

    Exposez les verbes dont les utilisateurs ont réellement besoin hors de l’app

    Pour commencer, les intents les plus adaptés sont généralement des actions comme rédiger, ouvrir, rechercher, filtrer, démarrer, continuer ou inspecter. Si une action n’est utile qu’après un long parcours de configuration dans l’app, elle n’a peut-être pas sa place dans la première implémentation d’App Intents.

    Définissez des entités plus restreintes que votre couche de modèles

    Le système n’a généralement pas besoin de votre modèle de persistance complet. Demandez à Codex de définir le plus petit ensemble d’entités d’app qui fournisse néanmoins à Siri, Raccourcis et Spotlight suffisamment de contexte pour acheminer et afficher correctement l’action.

    Considérez cette approche comme une infrastructure pour les assistants, pas seulement comme une fonctionnalité de raccourcis

    Même si votre première version n’apporte d’amélioration visible qu’à Shortcuts ou Siri, l’avantage le plus important est que votre application commence à exprimer 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 du système et à ceux pilotés par l’IA qu’une application dont les fonctionnalités ne sont définies que par des interactions tactiles et des hiérarchies de vues.

    Tech stack

    Need

    Exposition des actions

    Default options

    App Intents

    Why it's needed

    Les App Intents définissent le contrat avec le système qui permet aux actions de votre app d’apparaître dans Raccourcis, Siri, Spotlight, les widgets, les commandes et les interfaces système plus récentes destinées aux assistants.

    Need

    Interface de données de l’app

    Default options

    AppEntity, EntityQuery et représentations d’affichage

    Why it's needed

    Une couche d’entités restreinte et bien conçue permet au système de comprendre les objets de votre app sans exposer l’intégralité de votre couche de modèles.

    Need

    Couche de découverte

    Default options

    AppShortcutsProvider avec des phrases, des titres et des symboles explicites

    Why it's needed

    Les raccourcis d’app facilitent la découverte et l’exécution du premier ensemble d’actions exposées, sans demander aux utilisateurs de tout créer à partir de zéro.

    Need

    Boucle de validation

    Default options

    xcodebuild, vérifications dans le simulateur et contrôle ciblé du routage à l’exécution

    Why it's needed

    La difficulté ne consiste pas seulement à compiler la cible App Intents, mais aussi à démontrer que l’app s’ouvre ou redirige vers le bon emplacement lorsque le système invoque un intent.

    Need Default options Why it's needed
    Exposition des actions App Intents Les App Intents définissent le contrat avec le système qui permet aux actions de votre app d’apparaître dans Raccourcis, Siri, Spotlight, les widgets, les commandes et les interfaces système plus récentes destinées aux assistants.
    Interface de données de l’app AppEntity , EntityQuery et représentations d’affichage Une couche d’entités restreinte et bien conçue permet au système de comprendre les objets de votre app sans exposer l’intégralité de votre couche de modèles.
    Couche de découverte AppShortcutsProvider avec des phrases, des titres et des symboles explicites Les raccourcis d’app facilitent la découverte et l’exécution du premier ensemble d’actions exposées, sans demander aux utilisateurs de tout créer à partir de zéro.
    Boucle de validation xcodebuild , vérifications dans le simulateur et contrôle ciblé du routage à l’exécution La difficulté ne consiste pas seulement à compiler la cible App Intents, mais aussi à démontrer que l’app s’ouvre ou redirige vers le bon emplacement lorsque le système invoque un intent.

    Cas d’utilisation associés