如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

为 iOS 应用添加 App Intents

使用 Codex,让快捷指令、Siri、聚焦搜索以及由助手驱动的新系统功能都能调用应用中的操作、访问其中的内容。

难度 Advanced
时间跨度 1h

使用 Codex 和 Build iOS Apps 插件,确定应用应通过 App Intents 向系统提供哪些操作和实体,将它们接入快捷指令、聚焦搜索等系统功能,并为后续支持更多由助手驱动的工作流程做好准备。

最适合

  • 已有实用操作或内容,但快捷指令、Siri、聚焦搜索或其他系统功能仍无法发现这些操作或内容的 iOS 应用
  • 希望先向系统开放几项高价值操作,再逐步支持更便于助手执行的工作流程的团队
  • 包含账户、列表、筛选条件、目的地、草稿或媒体等明确对象的应用。这些对象可以定义为应用实体,供应用界面以外的系统功能使用。

目录

    ← 所有使用场景

    为 iOS 应用添加 App Intents

    使用 Codex,让快捷指令、Siri、聚焦搜索以及由助手驱动的新系统功能都能调用应用中的操作、访问其中的内容。

    使用 Codex 和 Build iOS Apps 插件,确定应用应通过 App Intents 向系统提供哪些操作和实体,将它们接入快捷指令、聚焦搜索等系统功能,并为后续支持更多由助手驱动的工作流程做好准备。

    Advanced
    1h

    使用 Codex 和 Build iOS Apps 插件,确定应用应通过 App Intents 向系统提供哪些操作和实体,将它们接入快捷指令、聚焦搜索等系统功能,并为后续支持更多由助手驱动的工作流程做好准备。

    Advanced
    1h

    最适合

    • 已有实用操作或内容,但快捷指令、Siri、聚焦搜索或其他系统功能仍无法发现这些操作或内容的 iOS 应用
    • 希望先向系统开放几项高价值操作,再逐步支持更便于助手执行的工作流程的团队
    • 包含账户、列表、筛选条件、目的地、草稿或媒体等明确对象的应用。这些对象可以定义为应用实体,供应用界面以外的系统功能使用。

    技能与插件

    • 使用 iOS 构建技能和 SwiftUI 技能添加 App Intents、应用实体和 App Shortcuts,然后验证应用是否仍能正常构建,以及通过意图进入应用时能否到达正确的位置。
    技能 使用理由
    Build iOS Apps 使用 iOS 构建技能和 SwiftUI 技能添加 App Intents、应用实体和 App Shortcuts,然后验证应用是否仍能正常构建,以及通过意图进入应用时能否到达正确的位置。

    起始提示词

    使用 Build iOS Apps 插件检查这个 iOS 应用,为需要向系统开放的操作和实体添加 App Intents。 约束条件: - 首先梳理对用户最有价值的操作和应用的核心对象,确定哪些应当能在应用之外通过快捷指令、Siri、聚焦搜索、小组件、控件或由助手驱动的新系统功能使用。 - 控制首轮实现的范围。选取少量无需打开完整应用就有实际用途的意图。如果某些意图需要打开应用并通过深层链接直达特定页面或工作流程,也应将其纳入。 - 只为系统理解和路由这些操作所需的数据定义应用实体。如果少量实体就已足够,无需照搬整个内部模型层。 - 如果添加 App Shortcuts 能让用户更容易发现某项操作,就为该操作添加 App Shortcuts。选择适合在 Siri、聚焦搜索和快捷指令中使用的标题、调用短语和显示形式。 - 如果需要在应用主界面中处理意图,请将结果传回应用,并说明应用场景收到结果后如何响应。 - 首轮实现完成后,构建并验证应用,然后总结目前支持哪些操作、实体和系统功能。 交付内容: - 建议首个版本向系统提供的意图和实体 - 已实现的意图、实体和 App Shortcuts - 应用在运行时如何路由或处理这些意图 - 本次实现支持哪些 Apple 系统功能,以及接下来适合接入哪些功能
    使用 Build iOS Apps 插件检查这个 iOS 应用,为需要向系统开放的操作和实体添加 App Intents。 约束条件: - 首先梳理对用户最有价值的操作和应用的核心对象,确定哪些应当能在应用之外通过快捷指令、Siri、聚焦搜索、小组件、控件或由助手驱动的新系统功能使用。 - 控制首轮实现的范围。选取少量无需打开完整应用就有实际用途的意图。如果某些意图需要打开应用并通过深层链接直达特定页面或工作流程,也应将其纳入。 - 只为系统理解和路由这些操作所需的数据定义应用实体。如果少量实体就已足够,无需照搬整个内部模型层。 - 如果添加 App Shortcuts 能让用户更容易发现某项操作,就为该操作添加 App Shortcuts。选择适合在 Siri、聚焦搜索和快捷指令中使用的标题、调用短语和显示形式。 - 如果需要在应用主界面中处理意图,请将结果传回应用,并说明应用场景收到结果后如何响应。 - 首轮实现完成后,构建并验证应用,然后总结目前支持哪些操作、实体和系统功能。 交付内容: - 建议首个版本向系统提供的意图和实体 - 已实现的意图、实体和 App Shortcuts - 应用在运行时如何路由或处理这些意图 - 本次实现支持哪些 Apple 系统功能,以及接下来适合接入哪些功能

    让系统发现并使用应用中的相关操作和对象

    App Intents 为 iOS 应用提供了一种直接的方式,让用户在应用界面之外也能使用它的功能。用户无需事事都先启动应用,再点按界面找到所需功能。您可以让 Codex 将合适的操作和对象开放给快捷指令、Siri、聚焦、小组件、控制项,以及由助手驱动的新一代系统功能。

    这样既方便用户发现应用功能、实现自动化,也能为助手在未来承担更多操作做好准备。如果您的应用已经能让用户撰写内容、打开项目、筛选结果、跳转到目标位置或生成摘要,App Intents 就能让系统以结构化的方式请求应用执行这些操作。

    从操作和实体入手,无需逐个映射界面

    首次接入 App Intents 时,通常无需把整个应用照搬一遍。请让 Codex 找出:

    • 用户希望跳过应用内导航、直接触发的少数几项操作
    • 系统需要识别哪些应用对象,才能将这些操作路由到正确的目标
    • 哪些工作流应打开应用并进入特定状态,哪些应直接在系统界面中完成

    Apple 的 App Intents 指南给出了设计思路:先定义操作,再确定需要向系统提供哪些实体信息,最后让用户能在不同的系统功能中发现并复用这些操作。可重点参考让操作和内容易于发现并可在多处使用、创建您的第一个应用意图,以及演示如何集成系统功能的示例采用 App Intents 支持系统功能。

    设计时兼顾快捷指令和其他系统入口

    App Intents 的用途远不止“添加一条快捷指令”。设计好应用开放的操作和实体,用户就能从多个入口使用应用功能:

    • 在快捷指令中,用户可以直接运行操作,也可以将多个操作组合成更大的自动化流程
    • 通过 Siri,用户可以调用应用提供的具体操作,或通过深层链接直达相应位置,而不只是启动应用
    • 在聚焦中,用户可以搜索到应用实体和应用快捷指令,并将它们作为进入应用的入口
    • 小组件、实时活动、控制项,以及其他由意图驱动的界面也可以提供这些操作
    • 在面向助手的新一代系统功能中,与应用各自的界面操作流程相比,系统更容易理解结构化的操作和实体

    采用适合实际应用的结构

    应用采用以下结构时,接入 App Intents 通常效果最好:

    • 为 App Intents 设置独立的构建目标,避免将意图类型分散在互不相关的应用文件中
    • 为撰写帖子、打开应用并进入特定标签页等重要用户操作定义 AppShortcutsProvider 条目
    • 为系统需要理解的对象定义精简的 AppEntity 类型,例如账号、列表和时间线筛选条件
    • 在处理意图时,将需要应用界面的操作路由回应用主场景,让用户调用意图后能进入相应的撰写流程,或切换到正确的标签页

    对于大多数应用,我会请 Codex 采用这种模式:先向系统开放少量操作,只提供必要的实体信息,并明确运行时的交接方式,以便意图需要主界面时将控制权交还给应用。

    让 Codex 设计首批对外开放的意图

    编写提示词时,最好先向 Codex 说明应用的核心对象和用户最重要的操作,再请它选出第一版 App Intents 需要开放的操作和实体。范围应尽可能小,同时又能满足实际需求,避免一开始就开放所有功能。

    实用建议

    开放用户确实想在应用外执行的操作

    适合作为首批意图的操作通常包括撰写、打开、查找、筛选、启动、继续或检查。如果用户必须先在应用内完成一连串设置,某项操作才有用,那么它可能不适合纳入首批 App Intents。

    实体只需包含模型层中的必要信息

    系统通常无需了解应用完整的持久化模型。请让 Codex 仅向系统提供必要的应用实体信息,同时确保 Siri、快捷指令和聚焦有足够的上下文来正确路由和展示操作。

    为助手打好基础,兼顾快捷指令之外的用途

    即使首个版本中用户能看到的改进仅限于快捷指令或 Siri,应用也已经能用结构化的操作和实体来描述自身功能。相比只能通过点按操作和视图层级来体现功能的应用,您的应用将更容易接入未来的系统入口和由 AI 驱动的入口。

    技术栈

    需求

    向系统开放操作

    默认选项

    App Intents

    为什么需要

    App Intents 定义了应用向系统提供操作的接口,让应用中的操作可以出现在快捷指令、Siri、聚焦搜索、小组件、控件以及面向助手的新系统功能中。

    需求

    向系统提供应用数据

    默认选项

    AppEntity、EntityQuery 和实体的显示形式

    为什么需要

    通过精简且设计合理的实体层,系统就能理解应用中的对象,无需公开整个模型层。

    需求

    让用户发现操作

    默认选项

    使用 AppShortcutsProvider,并提供清晰的调用短语、标题和图标

    为什么需要

    有了 App Shortcuts,用户可以更轻松地找到并运行首批开放的操作,无需从头创建快捷指令。

    需求

    构建与验证

    默认选项

    使用 xcodebuild 构建应用,在模拟器中检查,并重点验证运行时的跳转行为

    为什么需要

    编译意图的构建目标只是第一步。更难的是验证系统调用意图时,应用能否按预期打开或跳转到正确的位置。

    需求 默认选项 为什么需要
    向系统开放操作 App Intents App Intents 定义了应用向系统提供操作的接口,让应用中的操作可以出现在快捷指令、Siri、聚焦搜索、小组件、控件以及面向助手的新系统功能中。
    向系统提供应用数据 AppEntity 、 EntityQuery 和实体的显示形式 通过精简且设计合理的实体层,系统就能理解应用中的对象,无需公开整个模型层。
    让用户发现操作 使用 AppShortcutsProvider ,并提供清晰的调用短语、标题和图标 有了 App Shortcuts,用户可以更轻松地找到并运行首批开放的操作,无需从头创建快捷指令。
    构建与验证 使用 xcodebuild 构建应用,在模拟器中检查,并重点验证运行时的跳转行为 编译意图的构建目标只是第一步。更难的是验证系统调用意图时,应用能否按预期打开或跳转到正确的位置。

    相关使用场景