Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design
Codex

Anwendungsfall für Codex

App Intents für iOS hinzufügen

Stelle die Aktionen und Inhalte deiner App mit Codex für die App „Kurzbefehle“, Siri, Spotlight und neuere assistentengestützte Systemfunktionen bereit.

Schwierigkeitsgrad Advanced
Zeithorizont 1h

Finde mit Codex und dem Plugin „Build iOS Apps“ heraus, welche Aktionen und Entitäten deine App über App Intents bereitstellen sollte. Binde sie in die App „Kurzbefehle“ und in Systemfunktionen wie Spotlight ein. So bereitest du deine App schrittweise auf weitere assistentengestützte Abläufe vor.

Besonders geeignet für

  • iOS-Apps, deren nützliche Aktionen oder Inhalte in der App „Kurzbefehle“, in Siri, in Spotlight oder im übrigen System noch nicht verfügbar sind
  • Teams, die zunächst einige besonders nützliche Aktionen bereitstellen und nach und nach weitere Abläufe mit Assistenten ermöglichen möchten
  • Apps mit klar definierten Objekten wie Konten, Listen, Filtern, Zielen, Entwürfen oder Medien, die sich als App-Entitäten auch außerhalb der App-Oberfläche nutzen lassen

Inhalt

    ← Alle Anwendungsfälle

    App Intents für iOS hinzufügen

    Stelle die Aktionen und Inhalte deiner App mit Codex für die App „Kurzbefehle“, Siri, Spotlight und neuere assistentengestützte Systemfunktionen bereit.

    Finde mit Codex und dem Plugin „Build iOS Apps“ heraus, welche Aktionen und Entitäten deine App über App Intents bereitstellen sollte. Binde sie in die App „Kurzbefehle“ und in Systemfunktionen wie Spotlight ein. So bereitest du deine App schrittweise auf weitere assistentengestützte Abläufe vor.

    Advanced
    1h

    Finde mit Codex und dem Plugin „Build iOS Apps“ heraus, welche Aktionen und Entitäten deine App über App Intents bereitstellen sollte. Binde sie in die App „Kurzbefehle“ und in Systemfunktionen wie Spotlight ein. So bereitest du deine App schrittweise auf weitere assistentengestützte Abläufe vor.

    Advanced
    1h

    Besonders geeignet für

    • iOS-Apps, deren nützliche Aktionen oder Inhalte in der App „Kurzbefehle“, in Siri, in Spotlight oder im übrigen System noch nicht verfügbar sind
    • Teams, die zunächst einige besonders nützliche Aktionen bereitstellen und nach und nach weitere Abläufe mit Assistenten ermöglichen möchten
    • Apps mit klar definierten Objekten wie Konten, Listen, Filtern, Zielen, Entwürfen oder Medien, die sich als App-Entitäten auch außerhalb der App-Oberfläche nutzen lassen

    Skills und Plug-ins

    • Nutze die Skills für iOS-Builds und SwiftUI, um App Intents, App-Entitäten und App Shortcuts hinzuzufügen. Prüfe anschließend, ob der Build weiterhin gelingt und die App bei jedem Intent-Aufruf zum vorgesehenen Ziel navigiert.
    Skill Nutzen
    Build iOS Apps Nutze die Skills für iOS-Builds und SwiftUI, um App Intents, App-Entitäten und App Shortcuts hinzuzufügen. Prüfe anschließend, ob der Build weiterhin gelingt und die App bei jedem Intent-Aufruf zum vorgesehenen Ziel navigiert.

    Prompt für den Einstieg

    Use the Build iOS Apps plugin to audit this iOS app and add App Intents for the actions and entities that should be exposed to the system. Constraints: - Start by identifying the app's highest-value user actions and core objects that should be available outside the app in Shortcuts, Siri, Spotlight, widgets, controls, or newer assistant-driven system surfaces. - Keep the first pass focused. Pick a small set of intents that are genuinely useful without opening the full app, plus any open-app intents that should deep-link into a specific screen or workflow. - Define app entities only for the data the system actually needs to understand and route those actions. Do not mirror the entire internal model layer if a smaller entity surface is enough. - Add App Shortcuts where they make the experience more discoverable, and choose titles, phrases, and display representations that would make sense in Siri, Spotlight, and Shortcuts. - If the app needs to handle the intent inside the main UI, route the result back into the app cleanly and explain how the app scene reacts to that handoff. - Build and validate the app after the first pass, then summarize which actions, entities, and system surfaces are now supported. Deliver: - the recommended intent and entity surface for a first release - the implemented intents, entities, and App Shortcuts - how the app routes or handles those intents at runtime - which Apple system experiences this unlocks now and which ones are logical next steps
    Use the Build iOS Apps plugin to audit this iOS app and add App Intents for the actions and entities that should be exposed to the system. Constraints: - Start by identifying the app's highest-value user actions and core objects that should be available outside the app in Shortcuts, Siri, Spotlight, widgets, controls, or newer assistant-driven system surfaces. - Keep the first pass focused. Pick a small set of intents that are genuinely useful without opening the full app, plus any open-app intents that should deep-link into a specific screen or workflow. - Define app entities only for the data the system actually needs to understand and route those actions. Do not mirror the entire internal model layer if a smaller entity surface is enough. - Add App Shortcuts where they make the experience more discoverable, and choose titles, phrases, and display representations that would make sense in Siri, Spotlight, and Shortcuts. - If the app needs to handle the intent inside the main UI, route the result back into the app cleanly and explain how the app scene reacts to that handoff. - Build and validate the app after the first pass, then summarize which actions, entities, and system surfaces are now supported. Deliver: - the recommended intent and entity surface for a first release - the implemented intents, entities, and App Shortcuts - how the app routes or handles those intents at runtime - which Apple system experiences this unlocks now and which ones are logical next steps

    Mach ausgewählte Funktionen und Inhalte deiner App für das System zugänglich

    Mit App Intents kannst du Funktionen einer iOS-App auch außerhalb ihrer eigenen Oberfläche nutzbar machen. So muss niemand erst die App öffnen und sich durch mehrere Ansichten tippen. Nutze Codex, um ausgewählte Aktionen und Objekte für die App „Kurzbefehle“, Siri, Spotlight, Widgets, Steuerelemente und neuere assistentengestützte Systemfunktionen bereitzustellen.

    Schon heute lassen sich diese Funktionen dadurch leichter finden und automatisieren. Zugleich bereitest du deine App auf eine Zukunft vor, in der Assistenten mehr Aufgaben übernehmen. Wenn sich mit deiner App bereits Inhalte verfassen, öffnen, filtern, weiterleiten oder zusammenfassen lassen, kann das System diese Funktionen über die strukturierte Schnittstelle von App Intents gezielt anfordern.

    Beginne mit Aktionen und Entitäten, bevor du einzelne Ansichten betrachtest

    Bei der ersten Integration von App Intents ist es meist wenig sinnvoll, die gesamte App nachzubilden. Bitte Codex, folgende Fragen zu klären:

    • Welche wenigen Aktionen möchten Menschen auslösen, ohne durch die gesamte App navigieren zu müssen?
    • Welche Objekte der App muss das System kennen, um diese Aktionen dem richtigen Ziel zuzuordnen?
    • Bei welchen Abläufen soll sich die App in einem bestimmten Zustand öffnen, und welche sollen sich direkt über die Systemoberfläche abschließen lassen?

    Apples Dokumentation zu App Intents gibt dir dafür eine Orientierung. Definiere zuerst die Aktion und lege fest, welche Entitäten das System dafür kennen muss. Sorge anschließend dafür, dass sich die Aktionen in verschiedenen Systemfunktionen finden und wiederverwenden lassen. Besonders hilfreich sind die Anleitungen Aktionen und Inhalte auffindbar und systemweit verfügbar machen und Deinen ersten App Intent erstellen sowie das Beispiel Systemfunktionen mit App Intents unterstützen.

    Denk über Kurzbefehle hinaus

    Mit App Intents kannst du mehr erreichen, als nur einen Kurzbefehl hinzuzufügen. Über eine gut gestaltete Schnittstelle lassen sich Funktionen deiner App an mehreren Stellen nutzen:

    • In der App „Kurzbefehle“ lassen sich Aktionen direkt ausführen oder zu umfangreicheren Automatisierungen kombinieren.
    • Siri kann konkrete Aktionen deiner App aufrufen und über Deep Links direkt zum gewünschten Inhalt springen, statt lediglich die App zu öffnen.
    • In Spotlight lassen sich App-Entitäten und App-Kurzbefehle finden und als direkter Einstieg in die App nutzen.
    • Auch Widgets, Live-Aktivitäten, Steuerelemente und andere Oberflächenelemente können Intents auslösen.
    • Bei neueren Systemfunktionen, die mit Assistenten arbeiten, kann das System strukturierte Aktionen und Entitäten wesentlich leichter interpretieren als beliebige Bedienabläufe in der App.

    Orientiere dich an einem Muster aus der Praxis

    In der Praxis bewährt sich meist folgende Struktur:

    • ein eigenes Target für App Intents, damit die Intent-Typen an einer Stelle definiert sind, statt über Dateien ohne fachlichen Zusammenhang verteilt zu sein
    • Einträge in AppShortcutsProvider für besonders nützliche Aktionen, etwa um einen Beitrag zu verfassen oder die App mit einem bestimmten Tab zu öffnen
    • kleine AppEntity-Typen für Objekte, mit denen das System arbeiten muss, etwa Konten, Listen und Timeline-Filter
    • eine Intent-Verarbeitung, die Aufrufe gezielt an die Hauptszene der App weiterleitet, sodass ein Intent die passende Ansicht zum Verfassen öffnen oder zum richtigen Tab wechseln kann

    Für die meisten Apps würde ich Codex bitten, diesem Muster zu folgen. Stelle dem System zunächst nur wenige Aktionen und die dafür nötigen Entitäten bereit. Implementiere eine feste Übergabe an die App, wenn ein Intent zur Laufzeit deren Hauptoberfläche benötigt.

    Lass Codex eine erste Schnittstelle für App Intents entwerfen

    Beschreibe im Prompt die zentralen Objekte deiner App und die Aktionen, die für die Nutzung am wichtigsten sind. Bitte Codex dann, für die erste Integration die kleinste sinnvolle Auswahl an Aktionen und Entitäten zu treffen, statt pauschal alles bereitzustellen.

    Praktische Tipps

    Stelle Aktionen bereit, die Menschen auch außerhalb der App ausführen möchten

    Für erste Intents eignen sich oft Aktionen wie Verfassen, Öffnen, Suchen, Filtern, Starten, Fortsetzen oder Prüfen. Ist eine Aktion erst nach vielen vorbereitenden Schritten in der App sinnvoll, eignet sie sich möglicherweise erst für eine spätere Integration.

    Beschränke Entitäten auf einen Ausschnitt deines Datenmodells

    Das System benötigt in der Regel nicht dein gesamtes Persistenzmodell. Bitte Codex, für die Entitäten deiner App nur die Informationen bereitzustellen, die Siri, die App „Kurzbefehle“ und Spotlight brauchen, um die Aktion dem richtigen Ziel zuzuordnen und korrekt anzuzeigen.

    Schaffe mit App Intents auch eine Grundlage für Assistenten

    Selbst wenn sich in der ersten Version nur die Nutzung der App „Kurzbefehle“ oder die Interaktion mit Siri spürbar verbessert, kann deine App ihre Funktionen nun als strukturierte Aktionen und Entitäten bereitstellen. Dadurch lässt sie sich leichter in künftige System- und KI-Funktionen integrieren als eine App, deren Möglichkeiten sich nur aus der Abfolge von Tippgesten und der Hierarchie ihrer Ansichten erschließen.

    Tech-Stack

    Was du brauchst

    Aktionen bereitstellen

    Standardoptionen

    App Intents

    Warum du es brauchst

    App Intents bilden die Schnittstelle, über die deine App ihre Aktionen für die App „Kurzbefehle“, Siri, Spotlight, Widgets, Steuerelemente und neuere Systemfunktionen für Assistenten bereitstellen kann.

    Was du brauchst

    App-Daten bereitstellen

    Standardoptionen

    AppEntity, EntityQuery und Angaben zur Darstellung

    Warum du es brauchst

    Mit wenigen, klar definierten Entitäten kann das System die Objekte deiner App erkennen, ohne dass du das gesamte interne Datenmodell offenlegen musst.

    Was du brauchst

    Aktionen auffindbar machen

    Standardoptionen

    AppShortcutsProvider mit verständlichen Sprachbefehlen, Titeln und Symbolen

    Warum du es brauchst

    Mit App Shortcuts lassen sich die ersten bereitgestellten Aktionen leichter finden und ausführen, ohne dass man die Kurzbefehle selbst erstellen muss.

    Was du brauchst

    Build und Verhalten prüfen

    Standardoptionen

    xcodebuild, Tests im Simulator und gezielte Prüfungen der Navigation zur Laufzeit

    Warum du es brauchst

    Prüfe nach dem Kompilieren des Intents-Targets, ob sich die App an der richtigen Stelle öffnet oder dorthin navigiert, wenn das System einen Intent aufruft.

    Was du brauchst Standardoptionen Warum du es brauchst
    Aktionen bereitstellen App Intents App Intents bilden die Schnittstelle, über die deine App ihre Aktionen für die App „Kurzbefehle“, Siri, Spotlight, Widgets, Steuerelemente und neuere Systemfunktionen für Assistenten bereitstellen kann.
    App-Daten bereitstellen AppEntity , EntityQuery und Angaben zur Darstellung Mit wenigen, klar definierten Entitäten kann das System die Objekte deiner App erkennen, ohne dass du das gesamte interne Datenmodell offenlegen musst.
    Aktionen auffindbar machen AppShortcutsProvider mit verständlichen Sprachbefehlen, Titeln und Symbolen Mit App Shortcuts lassen sich die ersten bereitgestellten Aktionen leichter finden und ausführen, ohne dass man die Kurzbefehle selbst erstellen muss.
    Build und Verhalten prüfen xcodebuild , Tests im Simulator und gezielte Prüfungen der Navigation zur Laufzeit Prüfe nach dem Kompilieren des Intents-Targets, ob sich die App an der richtigen Stelle öffnet oder dorthin navigiert, wenn das System einen Intent aufruft.

    Verwandte Anwendungsfälle