如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

為 iOS App 加入 App Intents

使用 Codex,讓「捷徑」、Siri、Spotlight 和較新的系統助理功能都能使用 App 中的動作與內容。

難度 Advanced
任務時間跨度 1h

使用 Codex 和 Build iOS Apps 外掛程式,找出 App 應透過 App Intents 提供哪些動作與實體,再將它們整合到「捷徑」和 Spotlight 等系統介面,讓 App 日後能支援更多由助理執行的工作流程。

最適合的對象

  • 已具備實用動作或內容,但使用者還無法透過「捷徑」、Siri、Spotlight 或其他系統功能找到這些動作或內容的 iOS App
  • 希望先開放幾項對使用者特別有價值的動作,再逐步支援更多適合由助理執行的工作流程的團隊
  • 具有明確物件的 App,例如帳號、清單、篩選條件、目的地、草稿或媒體項目。這些物件可定義為 App 實體,讓使用者也能在 App 介面以外使用。

目錄

    ← 所有應用案例

    為 iOS App 加入 App Intents

    使用 Codex,讓「捷徑」、Siri、Spotlight 和較新的系統助理功能都能使用 App 中的動作與內容。

    使用 Codex 和 Build iOS Apps 外掛程式,找出 App 應透過 App Intents 提供哪些動作與實體,再將它們整合到「捷徑」和 Spotlight 等系統介面,讓 App 日後能支援更多由助理執行的工作流程。

    Advanced
    1h

    使用 Codex 和 Build iOS Apps 外掛程式,找出 App 應透過 App Intents 提供哪些動作與實體,再將它們整合到「捷徑」和 Spotlight 等系統介面,讓 App 日後能支援更多由助理執行的工作流程。

    Advanced
    1h

    最適合的對象

    • 已具備實用動作或內容,但使用者還無法透過「捷徑」、Siri、Spotlight 或其他系統功能找到這些動作或內容的 iOS App
    • 希望先開放幾項對使用者特別有價值的動作,再逐步支援更多適合由助理執行的工作流程的團隊
    • 具有明確物件的 App,例如帳號、清單、篩選條件、目的地、草稿或媒體項目。這些物件可定義為 App 實體,讓使用者也能在 App 介面以外使用。

    技能與外掛程式

    • 使用 iOS 建置技能和 SwiftUI 技能加入 App Intents、App 實體與 App Shortcuts,再確認 App 仍可成功建置,且從各個意圖進入 App 時都能到達正確的位置。
    技能 使用理由
    Build iOS Apps 使用 iOS 建置技能和 SwiftUI 技能加入 App Intents、App 實體與 App Shortcuts,再確認 App 仍可成功建置,且從各個意圖進入 App 時都能到達正確的位置。

    入門提示詞

    使用 Build iOS Apps 外掛程式檢視這個 iOS App,找出應提供給系統的動作與實體,並為它們加入 App Intents。 實作要求: - 先找出對使用者最有價值的 App 動作與核心物件,確認哪些應開放給「捷徑」、Siri、Spotlight、小工具、控制項或較新的系統助理介面,讓使用者能在 App 以外使用。 - 第一輪先選少數幾個無須開啟完整 App 就能派上用場的意圖。若有意圖應開啟 App 並透過深層連結直達特定畫面或工作流程,也一併納入。 - 只為系統理解及分派這些動作時確實需要的資料定義 App 實體。如果少數實體就已足夠,無須重現整個內部模型層。 - 在有助於使用者找到動作的地方加入 App Shortcuts,並選用在 Siri、Spotlight 和「捷徑」中都容易理解的標題、短語與顯示方式。 - 如果意圖需要在 App 的主介面中處理,請將結果傳回 App,並說明 App 的場景如何接手處理。 - 完成第一輪實作後,建置並驗證 App,再列出目前支援的動作、實體與系統介面。 交付項目: - 建議首版提供的意圖與實體 - 已實作的意圖、實體與 App Shortcuts - App 在執行時如何分派或處理這些意圖 - 這次實作已支援哪些 Apple 系統功能,以及接下來適合整合哪些功能
    使用 Build iOS Apps 外掛程式檢視這個 iOS App,找出應提供給系統的動作與實體,並為它們加入 App Intents。 實作要求: - 先找出對使用者最有價值的 App 動作與核心物件,確認哪些應開放給「捷徑」、Siri、Spotlight、小工具、控制項或較新的系統助理介面,讓使用者能在 App 以外使用。 - 第一輪先選少數幾個無須開啟完整 App 就能派上用場的意圖。若有意圖應開啟 App 並透過深層連結直達特定畫面或工作流程,也一併納入。 - 只為系統理解及分派這些動作時確實需要的資料定義 App 實體。如果少數實體就已足夠,無須重現整個內部模型層。 - 在有助於使用者找到動作的地方加入 App Shortcuts,並選用在 Siri、Spotlight 和「捷徑」中都容易理解的標題、短語與顯示方式。 - 如果意圖需要在 App 的主介面中處理,請將結果傳回 App,並說明 App 的場景如何接手處理。 - 完成第一輪實作後,建置並驗證 App,再列出目前支援的動作、實體與系統介面。 交付項目: - 建議首版提供的意圖與實體 - 已實作的意圖、實體與 App Shortcuts - App 在執行時如何分派或處理這些意圖 - 這次實作已支援哪些 Apple 系統功能,以及接下來適合整合哪些功能

    讓系統能找到並使用 App 中合適的功能與內容

    要讓使用者在 iOS App 的介面之外也能使用它的功能,App Intents 是最直接的做法之一。使用者原本得先開啟 App,再逐步點選才能完成操作。你可以請 Codex 把合適的動作與物件提供給「捷徑」、Siri、Spotlight、小工具、控制項,以及較新的助理驅動式系統功能。

    這樣一來,使用者現在就能更容易找到 App 的功能,並將操作自動化。App 也能為未來更多由助理驅動的互動做好準備。如果你的 App 已經能撰寫、開啟、篩選或摘要使用者需要的內容,或將使用者導向適當的位置,App Intents 就能讓系統以結構化的方式呼叫這些功能。

    先盤點動作與實體,無須逐一對應每個畫面

    第一次導入 App Intents 時,通常不必「把整個 App 照搬過來」。請 Codex 找出:

    • 使用者希望直接執行、不必在 App 介面中逐步點選的幾個動作
    • 系統需要辨識哪些 App 物件,才能將這些動作導向正確的位置
    • 哪些工作流程應該開啟 App 並進入指定狀態,哪些應該直接在系統介面中完成

    可以依循 Apple 的 App Intents 指引:先定義動作,再定義系統需要存取的實體,接著讓使用者能在不同的系統功能中找到並重複使用這些動作。最值得參考的是讓動作與內容易於探索並可在多處使用、建立第一個 App 意圖,以及示範如何整合系統功能的範例採用 App Intents 以支援系統體驗。

    設計時一併考量捷徑以外的系統介面

    App Intents 的用途遠超過「新增一個捷徑」。妥善設計 App 提供的動作與實體,就能讓使用者從多種系統介面使用 App 的功能:

    • 在「捷徑」中,使用者可以直接執行動作,也可以將多個動作組合成更完整的自動化流程。
    • 透過 Siri,使用者除了開啟 App,還能說出具體要執行的動作,或透過深層連結直達 App 中的特定位置。
    • 在 Spotlight 中,使用者可以搜尋 App 實體與 App 捷徑,直接從系統進入相關功能。
    • 小工具、即時動態、控制項,以及其他由意圖驅動的介面,都能使用這些功能。
    • 在較新的助理互動中,相較於各個 App 自訂的介面操作流程,系統更容易理解結構化的動作與實體。

    採用實際 App 的架構

    App 採用以下架構時,整合效果通常最好:

    • 設立專用的 App Intents 建置目標,集中管理意圖型別,以免分散在不相關的 App 檔案中。
    • 在 AppShortcutsProvider 中為重要的使用者動作建立項目,例如撰寫貼文,或開啟 App 並直接顯示指定的分頁。
    • 為系統需要辨識及處理的物件定義精簡的 AppEntity 型別,例如帳號、清單和時間軸篩選條件。
    • 讓意圖處理邏輯將操作交回 App 的主要場景,這樣呼叫意圖時,就能開啟對應的撰寫流程,或將 App 切換到正確的分頁。

    對大多數 App,我會請 Codex 採用這個模式:先建立一個只向系統提供少數動作的介面層,只開放必要的實體資訊,並明確定義交接方式,讓意圖在執行時若需要主要介面,就能將操作交回 App。

    請 Codex 設計第一版意圖介面

    撰寫提示詞時,先告訴 Codex 你的 App 有哪些核心物件,以及使用者最常執行哪些重要動作。再請它挑出第一版 App Intents 需要提供的最小實用範圍,避免一開始就開放所有功能。

    實用技巧

    提供使用者確實想在 App 外執行的動作

    適合優先支援的意圖通常是撰寫、開啟、尋找、篩選、開始、繼續或檢視。如果某個動作必須先在 App 內完成一連串設定才有用,就未必適合納入第一版 App Intents。

    實體只需涵蓋模型層的一部分

    系統通常不需要完整的持久化模型。請 Codex 為 App 實體定義最精簡的介面,同時確保 Siri、「捷徑」和 Spotlight 能取得足夠的上下文,將動作導向正確的位置並正確顯示動作。

    將 App Intents 視為支援助理的基礎架構,而不只是捷徑功能

    即使第一版只有「捷徑」或 Siri 的使用體驗有明顯改善,更長遠的好處是 App 開始能以結構化的動作與實體描述自身功能。如果 App 的功能只能透過點選操作和檢視階層來表達,就較難整合到未來的系統入口或由 AI 驅動的入口。

    技術堆疊

    需求

    提供 App 動作

    預設選項

    App Intents

    為何需要

    App Intents 定義了 App 向系統提供動作的方式,讓這些動作能出現在「捷徑」、Siri、Spotlight、小工具、控制項和較新的系統助理介面中。

    需求

    提供 App 資料

    預設選項

    AppEntity、EntityQuery 與實體的顯示方式

    為何需要

    只要定義少數結構清楚的實體,系統就能理解 App 中的物件,無須開放整個模型層。

    需求

    讓使用者容易找到動作

    預設選項

    使用 AppShortcutsProvider,搭配清楚的短語、標題與符號

    為何需要

    App Shortcuts 讓使用者更容易找到並執行首批開放的動作,無須自己從頭建立捷徑。

    需求

    建置與執行驗證

    預設選項

    使用 xcodebuild 建置,在模擬器中檢查,並針對意圖執行時的導向行為進行驗證

    為何需要

    除了編譯意圖的建置目標,更難的是實際驗證系統呼叫意圖時,App 能否如預期開啟或導向正確的位置。

    需求 預設選項 為何需要
    提供 App 動作 App Intents App Intents 定義了 App 向系統提供動作的方式,讓這些動作能出現在「捷徑」、Siri、Spotlight、小工具、控制項和較新的系統助理介面中。
    提供 App 資料 AppEntity 、 EntityQuery 與實體的顯示方式 只要定義少數結構清楚的實體,系統就能理解 App 中的物件,無須開放整個模型層。
    讓使用者容易找到動作 使用 AppShortcutsProvider ,搭配清楚的短語、標題與符號 App Shortcuts 讓使用者更容易找到並執行首批開放的動作,無須自己從頭建立捷徑。
    建置與執行驗證 使用 xcodebuild 建置,在模擬器中檢查,並針對意圖執行時的導向行為進行驗證 除了編譯意圖的建置目標,更難的是實際驗證系統呼叫意圖時,App 能否如預期開啟或導向正確的位置。

    相關應用案例