跳到主要内容
返回使用场景

Codex 使用场景

添加 iOS App Intents

使用 Codex 让你应用的操作和内容可供 Shortcuts、Siri、Spotlight 以及较新的助手驱动型系统体验使用。

高级1 小时iOS代码
在 Codex app 中尝试官方来源

概览

使用 Codex 和 Build iOS Apps plugin 来识别你的应用应通过 App Intents 暴露的操作和实体，将它们接入 Shortcuts 和 Spotlight 等系统入口，并让你的应用随着时间推移为更多助手驱动的工作流做好准备。

适合场景

  • 已经拥有有用操作或内容、但在 Shortcuts、Siri、Spotlight 或更广泛系统中仍不可见的 iOS 应用
  • 希望现在先暴露少量高价值操作，并逐步构建出对助手更友好的工作流的团队
  • 拥有清晰对象（如账户、列表、筛选器、目的地、草稿或媒体）的应用，这些对象可以成为应用实体，而不是继续被锁在 UI 内部

为系统和助手入口添加 App Intents

使用 Build iOS Apps plugin 审查这个 iOS 应用，并为应该暴露给系统的操作和实体添加 App Intents。

约束：
- 先识别该应用最有价值的用户操作，以及应该在应用外部通过 Shortcuts、Siri、Spotlight、小组件、控件或较新的助手驱动型系统入口提供的核心对象。
- 让第一轮工作保持聚焦。选择一小组在不打开完整应用的情况下也确实有用的 intents，以及任何应该深度链接到特定屏幕或工作流的 open-app intents。
- 仅为系统实际需要理解并用于路由这些操作的数据定义应用实体。如果更小的实体范围已经足够，就不要映射整个内部模型层。
- 在能让体验更易被发现的地方添加 App Shortcuts，并选择在 Siri、Spotlight 和 Shortcuts 中都说得通的标题、短语和显示表示。
- 如果应用需要在主 UI 内处理 intent，请将结果干净地路由回应用中，并说明应用场景如何对这次交接作出响应。
- 完成第一轮后构建并验证应用，然后总结现在已支持哪些操作、实体和系统入口。

交付内容：
- 首个版本推荐的 intent 和实体范围
- 已实现的 intents、实体和 App Shortcuts
- 应用在运行时如何路由或处理这些 intents
- 这现在解锁了哪些 Apple 系统体验，以及哪些是合乎逻辑的下一步

让你应用中合适的部分对系统可见

App Intents 是让 iOS 应用在自身 UI 之外变得更有用的最清晰方式之一。不要把你的应用当成一个封闭的目的地，只能等用户启动后再点来点去；而是使用 Codex 暴露那些应可供 Shortcuts、Siri、Spotlight、小组件、控件以及较新的助手驱动型系统体验使用的操作和对象。

这在今天有助于提升可发现性和自动化能力，同时也是为更加助手驱动的未来做准备的有力一步。如果你的应用已经知道如何组合、打开、筛选、路由或总结某些有价值的内容，那么 App Intents 就为系统提供了一种结构化方式来请求这些能力。

从操作和实体开始，而不是从每个屏幕开始

最佳的第一轮 App Intents 实践通常不是“映射整个应用”。让 Codex 帮你识别：

  • 用户希望在不导航完整界面的情况下触发的少数几个操作
  • 系统为了正确路由这些操作而需要理解的应用对象
  • 哪些工作流应该以特定状态打开应用，哪些则应该直接从系统入口完成

Apple 的 App Intents 指南在这里是一个很好的框架：定义操作，定义系统所需的实体范围，然后让这些操作在各类系统体验中可被发现和复用。最有用的参考资料包括 让操作和内容可被发现并广泛使用、创建你的第一个 App Intent 以及系统体验示例 采用 App Intents 以支持系统体验。

按系统入口来思考，而不只是按快捷指令来思考

机会不止于“添加一个快捷指令”。一个好的 App Intents 范围可以让你的应用在多个地方都变得有用：

  • Shortcuts，用户可以直接运行操作，或将其组合进更大的自动化流程中
  • Siri，应用可以暴露有意义的动词和深度链接，而不只是被笼统地打开
  • Spotlight，应用实体和应用快捷方式可以成为可发现的系统入口点
  • 小组件、Live Activities、控件，以及其他由 intent 驱动的 UI 入口
  • 较新的面向助手的体验，在这些场景中，结构化的操作和实体比任意的 UI 流程更容易被系统理解

遵循真实应用的模式

当应用采用如下结构时，通常效果最好：

  • 使用专门的 App Intents target，而不是把 intent 类型分散到无关的应用文件中
  • 为高价值用户操作（如撰写帖子或在特定标签页打开应用）提供 AppShortcutsProvider 条目
  • 为系统需要推理的内容定义小型 AppEntity 类型，例如账户、列表和时间线筛选器
  • 将 intent 处理干净地路由回主应用场景，使被调用的 intent 能打开正确的撰写流程，或将应用切换到正确的标签页

这就是我会建议 Codex 为大多数应用遵循的模式：从一个小而精的面向系统的操作层开始，保持实体范围收敛，并在 intent 需要主 UI 时，把可预测的运行时交接接回应用。

让 Codex 设计第一版 intent 范围

这里最有效的提示词，是把你应用的核心对象和主要用户操作告诉 Codex，然后让它选择最小但有用的第一版 App Intents 范围，而不是盲目地暴露所有内容。

实用建议

暴露用户真的想在应用外执行的动词

好的第一批 intents 通常是像 compose、open、find、filter、start、continue 或 inspect 这样的操作。如果一个操作只有在应用内经过很长的设置流程后才有用，那它可能不适合出现在第一轮 App Intents 中。

让实体比你的模型层更精简

系统通常并不需要你的完整持久化模型。让 Codex 定义最小的应用实体范围，只要仍能为 Siri、Shortcuts 和 Spotlight 提供足够的上下文，以便正确路由和展示操作即可。

把它视为助手基础设施，而不仅仅是快捷指令功能

即使你的第一个版本在表面上只明显改善了 Shortcuts 或 Siri，更深层的收益在于：你的应用开始以结构化的操作和实体来表达自身能力。与那些能力只被编码在点击路径和视图层级中的应用相比，这会让你的应用更容易参与未来的系统入口和 AI 驱动入口。