アプリの適切な部分をシステムに公開

App Intents は、iOS アプリをアプリ自身の UI の外でも役立つものにする、最もわかりやすい方法の 1 つです。アプリを、ユーザーが起動して画面を操作した後でしか使えない閉じた存在として扱うのではなく、Codex を使って、Shortcuts、Siri、Spotlight、ウィジェット、コントロール、新しいアシスタント主導のシステム体験から利用できるようにすべきアクションとオブジェクトを公開します。

これは、現在の見つけやすさと自動化に役立つだけでなく、アシスタントの活用がさらに進む将来に向けた有力な準備策にもなります。アプリが、何か価値のあるものを作成したり、開いたり、絞り込んだり、ルーティングしたり、要約したりできるなら、App Intents によって、システムはその機能を構造化された形で呼び出せます。

すべての画面ではなく、アクションとエンティティから着手

初回の App Intents 対応で通常最適なのは、「アプリ全体を再現する」ことではありません。Codex に次の点を特定させます:

• インターフェース全体をたどらずに、ユーザーが実行したい少数のアクション
• それらのアクションを正しくルーティングするために、システムが理解する必要があるアプリのオブジェクト
• アプリを特定の状態で開くべきワークフローと、システムサーフェス上で直接完了すべきワークフロー

Apple の App Intents ガイダンスは、ここでの優れた枠組みです。アクションを定義し、システムに必要なエンティティサーフェスを定義してから、そのアクションをシステム体験全体で見つけやすく、再利用できるようにします。特に役立つ資料は、アクションとコンテンツを見つけやすくし、幅広く利用可能にする、最初の App Intent の作成、そしてシステム体験のサンプルである App Intents を導入してシステム体験に対応する です。

ショートカットだけでなくシステムサーフェスを意識

可能性は「ショートカットを 1 つ追加する」だけにとどまりません。App Intents のサーフェスを適切に設計すれば、次のようなさまざまな場所でアプリを役立てられます:

• Shortcuts では、ユーザーがアクションを直接実行したり、組み合わせてより大規模なオートメーションを作成したりできます
• Siri では、単にアプリを開くだけでなく、意味のある動詞やディープリンクを公開できます
• Spotlight では、アプリエンティティと App Shortcuts が、見つけやすいシステムエントリポイントになります
• ウィジェット、Live Activities、コントロールなど、インテント主導の UI サーフェス
• 新しいアシスタント向け体験では、構造化されたアクションやエンティティは、自由形式の UI フローよりもシステムにとってはるかに理解しやすくなります

実際のアプリに即したパターン

通常は、アプリに次のような構造を採用すると、最も効果的です:

• 無関係なアプリファイルにインテント型を分散させず、App Intents 専用のターゲットを用意
• AppShortcutsProvider に追加する、投稿の作成や特定のタブでのアプリ起動など、価値の高いユーザーアクションのエントリ
• アカウント、リスト、タイムラインフィルターなど、システムが判断に使う対象を表す小規模な AppEntity 型
• 呼び出されたインテントが適切な作成フローを開いたり、アプリを適切なタブに切り替えたりできるよう、メインのアプリシーンへ適切に戻すインテント処理

ほとんどのアプリで Codex に採用させたいのは、このパターンです。システム向けの小規模なアクションレイヤーから始め、エンティティサーフェスを必要最小限に抑え、インテントがメイン UI を必要とする場合は、実行時に予測可能な方法でアプリへ引き継ぐよう接続します。

Codex による最初のインテントサーフェス設計

ここで最も効果的なプロンプトは、アプリの中核オブジェクトと主要なユーザーアクションを Codex に伝え、すべてを闇雲に公開するのではなく、最初の App Intents サーフェスとして有用な最小構成を選ばせるものです。

実践的なヒント

ユーザーが実際にアプリ外で使いたい動詞を公開

最初のインテントには通常、「作成する」「開く」「検索する」「絞り込む」「開始する」「続行する」「確認する」といったものが適しています。アプリ内で長いセットアップフローを終えた後にしか役立たないアクションは、初回の App Intents 対応には向かない場合があります。

エンティティはモデルレイヤーより小さく

通常、システムに永続化モデル全体は必要ありません。Siri、Shortcuts、Spotlight が、アクションを正しくルーティングして表示するのに十分なコンテキストを得られる、最小限のアプリエンティティサーフェスを Codex に定義させます。

ショートカット機能にとどまらないアシスタント基盤としての位置づけ

初回リリースで目に見える改善が Shortcuts や Siri に限られるとしても、より本質的な成果は、アプリが自身の機能を構造化されたアクションとエンティティとして表現し始めることです。これにより、機能がタップ操作とビュー階層だけで表現されているアプリよりも、将来のシステムや AI 主導のエントリポイントに対応しやすくなります。