Need
アクションの公開
Default options
Why it's needed
App Intents は、アプリのアクションをシステムに公開するための共通インターフェースです。ショートカット、Siri、Spotlight、ウィジェット、コントロールのほか、アシスタントと連携する新しいシステム機能でもアクションを利用できます。
.md to the page URL.
Codex use case
Codex を使って、ショートカット、Siri、Spotlight のほか、アシスタントと連携する新しいシステム機能からも、アプリのアクションやコンテンツを利用できるようにします。
Codex と Build iOS Apps プラグインを使って、App Intents で公開するアクションとエンティティを選び、ショートカットや Spotlight などのシステム機能に組み込みます。これにより、アシスタントを介して実行できるワークフローを段階的に増やすための準備が整います。
Codex を使って、ショートカット、Siri、Spotlight のほか、アシスタントと連携する新しいシステム機能からも、アプリのアクションやコンテンツを利用できるようにします。
Codex と Build iOS Apps プラグインを使って、App Intents で公開するアクションとエンティティを選び、ショートカットや Spotlight などのシステム機能に組み込みます。これにより、アシスタントを介して実行できるワークフローを段階的に増やすための準備が整います。
Codex と Build iOS Apps プラグインを使って、App Intents で公開するアクションとエンティティを選び、ショートカットや Spotlight などのシステム機能に組み込みます。これにより、アシスタントを介して実行できるワークフローを段階的に増やすための準備が整います。
Related links
| Skill | Why use it |
|---|---|
| Build iOS Apps | iOS ビルドと SwiftUI のスキルを使って、App Intents、アプリのエンティティ、App Shortcuts を追加します。その後、アプリが引き続きビルドできることと、インテント経由で呼び出したときに目的の画面や処理に移ることを確認します。 |
App Intents は、iOS アプリの機能をアプリ自身の UI の外でも使えるようにするためのわかりやすい方法のひとつです。ユーザーがアプリを起動して画面を操作しなくても必要な機能を使えるように、Codex を活用しましょう。ショートカット、Siri、Spotlight、ウィジェット、コントロール、さらにはアシスタントを介した新しいシステム機能から利用できるようにしたいアクションとオブジェクトを公開します。
こうすると、ユーザーはアプリの機能を見つけやすくなり、操作も自動化できます。今後、アシスタントを介した操作が増えたときの備えにもなります。アプリにすでに作成、表示、絞り込み、適切な画面への誘導、要約といった便利な機能があれば、App Intents を通じて、システムはそれらの機能を構造化された形で呼び出せます。
App Intents を初めて導入する際は、アプリ全体の機能をそのまま再現しようとするよりも、まずは範囲を絞るのが効果的です。Codex に次の点を洗い出してもらいましょう。
設計の指針になるのが、Apple の App Intents ガイドです。まずアクションを定義し、次にシステムに公開する必要のあるエンティティとその情報を定めます。そのうえで、システムのさまざまな機能からアクションを見つけて再利用できるようにします。特に参考になるのは、アクションとコンテンツを見つけやすくし、幅広く利用できるようにする、初めてのアプリインテントの作成、そしてシステム機能との連携を示すサンプル App Intents を導入してシステム機能に対応する です。
App Intents の用途は、ショートカットをひとつ追加するだけにとどまりません。公開する機能を適切に設計すれば、さまざまな場面でアプリを活用できます。
多くの場合、次のようにアプリを構成するとうまくいきます。
AppShortcutsProvider に登録AppEntity 型として定義ほとんどのアプリでは、Codex にもこの構成で実装を依頼するとよいでしょう。まずはシステムから呼び出せるアクションを少数に絞り、エンティティとして公開する範囲も限定します。インテントの実行にアプリのメイン UI が必要な場合に備えて、実行時にどの画面へ処理を引き渡すかをあらかじめ決めておきます。
プロンプトでは、アプリの主要なオブジェクトと、ユーザーが行う主な操作を Codex に伝えます。そのうえで、すべてを一律に公開するのではなく、初回の導入で役に立つ最小限のアクションとエンティティを選ぶよう依頼すると効果的です。
最初のインテントには、作成、表示、検索、絞り込み、開始、再開、詳細の確認といった操作が適しています。アプリ内で何段階もの準備を済ませて初めて役に立つ操作は、App Intents の初回導入には向かないかもしれません。
通常、システムに永続化モデル全体を公開する必要はありません。Siri、ショートカット、Spotlight がアクションを正しく表示し、適切な処理につなぐために必要な情報を見極め、その情報だけを持つアプリのエンティティを定義するよう Codex に依頼しましょう。
初回リリースでユーザーが変化を実感できるのは、ショートカットや Siri だけかもしれません。それでも、アプリの機能を構造化されたアクションとエンティティで表現できるようになることには、より長期的な利点があります。タップ操作やビュー階層だけで機能を表現するアプリに比べ、将来、システムや AI が提供する新しい入口からもアプリの機能を呼び出しやすくなります。
Need
Default options
Why it's needed
Need
アクションの公開
Default options
Why it's needed
App Intents は、アプリのアクションをシステムに公開するための共通インターフェースです。ショートカット、Siri、Spotlight、ウィジェット、コントロールのほか、アシスタントと連携する新しいシステム機能でもアクションを利用できます。
Need
アプリデータの公開
Default options
AppEntity、EntityQuery、エンティティの表示形式
Why it's needed
必要なオブジェクトに絞ってエンティティ層を設計すれば、モデル層全体を公開せずに、システムがアプリのオブジェクトを認識できるようになります。
Need
アクションの見つけやすさ
Default options
わかりやすい呼び出しフレーズ、タイトル、シンボルを設定した AppShortcutsProvider
Why it's needed
App Shortcuts を用意しておくと、ユーザーは自分でショートカットを一から作成することなく、最初に公開したアクションを簡単に見つけて実行できます。
Need
ビルドと動作検証
Default options
xcodebuild、シミュレータでの動作確認、実行時のルーティングに絞った検証
Why it's needed
インテント用のターゲットをコンパイルしただけでは、実行時の動作まではわかりません。システムがインテントを呼び出したときに、アプリが想定どおりに開くか、目的の画面や処理に移るかを確認する必要があります。
| Need | Default options | Why it's needed |
|---|---|---|
| アクションの公開 | App Intents | App Intents は、アプリのアクションをシステムに公開するための共通インターフェースです。ショートカット、Siri、Spotlight、ウィジェット、コントロールのほか、アシスタントと連携する新しいシステム機能でもアクションを利用できます。 |
| アプリデータの公開 | AppEntity 、 EntityQuery 、エンティティの表示形式 | 必要なオブジェクトに絞ってエンティティ層を設計すれば、モデル層全体を公開せずに、システムがアプリのオブジェクトを認識できるようになります。 |
| アクションの見つけやすさ | わかりやすい呼び出しフレーズ、タイトル、シンボルを設定した AppShortcutsProvider | App Shortcuts を用意しておくと、ユーザーは自分でショートカットを一から作成することなく、最初に公開したアクションを簡単に見つけて実行できます。 |
| ビルドと動作検証 | xcodebuild 、シミュレータでの動作確認、実行時のルーティングに絞った検証 | インテント用のターゲットをコンパイルしただけでは、実行時の動作まではわかりません。システムがインテントを呼び出したときに、アプリが想定どおりに開くか、目的の画面や処理に移るかを確認する必要があります。 |