AppFunctions 概览

借助 AppFunctions，您的 Android 应用可以分享特定的功能，供系统和各种 AI 智能体及助理发现和调用。通过定义这些功能，您可以让应用向 Android 操作系统提供服务、数据和操作，从而让用户能够通过 AI 代理和系统级互动完成任务。

AppFunctions 相当于 Model Context Protocol (MCP) 中的移动版工具。虽然 MCP 传统上标准化了代理连接到服务器端工具的方式，但 AppFunctions 为 Android 应用提供了相同的机制。这样，您就可以将应用的功能公开为可编排的“工具”，授权的应用（调用方）可以发现并执行这些工具，以实现用户意图。调用方必须具有 EXECUTE_APP_FUNCTIONS 权限才能发现和执行 AppFunction，并且可以包括代理、应用和 AI 助理（例如 Gemini）。

AppFunctions 适用于搭载 Android 16 或更高版本的设备。

用例示例

AppFunctions 提供了一种强大的机制来自动执行任务并简化用户互动。通过公开应用的功能，您可以让用户使用自然语言完成复杂的目标，而无需通过界面进行逐步手动导航。

以下场景说明了如何使用 AppFunctions 在各种应用类别中打造体验：

  • 任务管理和工作效率
    • 用户请求：“提醒我今天下午 5 点在工作场所取包裹”。
    • AppFunction 操作：调用方识别相关的任务管理应用，并调用一个函数来创建任务，根据用户的提示自动填充标题、时间和位置字段。
  • 媒体和娱乐
    • 用户请求：“创建一个包含今年热门爵士专辑的新播放列表”。
    • AppFunction 操作：调用方在音乐应用中执行播放列表创建函数，传递“2026 年热门爵士专辑”等上下文作为查询，以立即生成并启动内容。
  • 跨应用工作流程
    • 用户请求：“查找 Lisa 的电子邮件中的面条食谱，并将食材添加到我的购物清单”。
    • AppFunction 操作：此请求使用来自多个应用的功能。首先，调用方使用电子邮件应用的搜索功能检索内容。然后，它会提取相关食材，并调用购物清单应用的功能来填充用户的清单。
  • 日历和日程安排
    • 用户请求：“将妈妈的生日派对添加到我的日历中，时间是下周一下午 6 点”。
    • AppFunction 操作：经批准的智能应用调用日历应用的“创建活动”函数，解析“下周一”和“下午 6 点”等相关情境，以创建条目，而无需用户手动打开日历。

AppFunction 的运作方式

AppFunctions 是一项 Android 16 平台功能以及一个配套的 Jetpack 库，可让应用公开特定功能，以便调用方（例如代理应用）在设备上访问和执行这些功能。

下图展示了应用如何将 AppFunction 共享给 Agent 并随后执行的典型流程。代理在处理用户请求时，可能会同时考虑服务器端远程 MCP 工具和本地 AppFunctions。使用本地 AppFunctions 的详细流程如下：

  • AppFunction 声明：Android 应用构建为公开其 AppFunction，例如“创建笔记”或“发送消息”。
  • 架构生成：AppFunctions Jetpack 库会生成一个 XML 架构文件，其中列出了应用中声明的所有 AppFunctions。Android 操作系统会使用此文件来为可用的 AppFunctions 编制索引。
  • 元数据检索：代理可以通过查询来检索 AppFunction 元数据。
  • AppFunction 选择和执行：根据用户提示，代理将选择并执行具有相应形参的相应 AppFunction。
一张图表，显示了 AppFunction 从应用曝光到 Agent 执行的典型流程。
图 1：AppFunctions 的公开方式以及代理随后执行这些函数的方式的典型流程。

AppFunctions Jetpack 库可简化应用功能的公开。借助注解处理器，开发者可以为要公开的函数添加注释。然后，调用方可以使用 AppFunctionManager 发现并调用这些已编入索引的函数。

您的应用无需验证是否支持 AppFunction 功能；Jetpack 库会自动处理此问题。例如，AppFunctionManager 可以验证相应功能是否受支持。

以下示例展示了具有创建、修改和列出笔记功能的应用的 AppFunctions。

/**
 * A note app's [AppFunction]s.
 */
class NoteFunctions(
    private val noteRepository: NoteRepository
) {
    /**
     * Lists all available notes.
     *
     * @param appFunctionContext The context in which the AppFunction is executed.
     */
    @AppFunction(isDescribedByKDoc = true)
    suspend fun listNotes(appFunctionContext: AppFunctionContext): List<Note>? {
        return noteRepository.appNotes.ifEmpty { null }?.toList()
    }

    /**
     * Adds a new note to the app.
     *
     * @param appFunctionContext The context in which the AppFunction is executed.
     * @param title The title of the note.
     * @param content The note's content.
     */
    @AppFunction(isDescribedByKDoc = true)
    suspend fun createNote(
        appFunctionContext: AppFunctionContext,
        title: String,
        content: String
    ): Note {
        return noteRepository.createNote(title, content)
    }

    /**
     * Edits a single note.
     *
     * @param appFunctionContext The context in which the AppFunction is executed.
     * @param noteId The target note's ID.
     * @param title The note's title if it should be updated.
     * @param content The new content if it should be updated.
     */
    @AppFunction(isDescribedByKDoc = true)
    suspend fun editNote(
        appFunctionContext: AppFunctionContext,
        noteId: Int,
        title: String?,
        content: String?,
    ): Note? {
        return noteRepository.updateNote(noteId, title, content)
    }
}

/**
 * A note.
 */
@AppFunctionSerializable(isDescribedByKDoc = true)
data class Note(
    /** The note's identifier */
    val id: Int,
    /** The note's title */
    val title: String,
    /** The note's content */
    val content: String
)
AppFunctionsApiSnippets.kt