AppFunctions 總覽

Android 應用程式可透過 AppFunctions 分享特定功能，供系統和各種 AI 代理程式和助理探索及叫用。定義這些函式後，應用程式就能向 Android 作業系統提供服務、資料和動作，讓使用者透過 AI 代理程式和系統層級的互動完成工作。

AppFunctions 相當於 Model Context Protocol (MCP) 中的工具，但適用於行動裝置。MCP 的傳統用途是標準化代理連線至伺服器端工具的方式，而 AppFunctions 則為 Android 應用程式提供相同機制。您可以將應用程式功能公開為可協調的「工具」，授權應用程式 (呼叫端) 即可探索及執行這些工具，滿足使用者意圖。呼叫者必須具備 EXECUTE_APP_FUNCTIONS 權限，才能探索及執行 AppFunctions，且可包含代理程式、應用程式和 Gemini 等 AI 助理。

AppFunctions 適用於搭載 Android 16 以上版本的裝置。

應用實例

AppFunctions 提供強大的機制，可自動執行工作並簡化使用者互動。公開應用程式的功能後，使用者就能以自然語言完成複雜目標，通常不需要透過 UI 手動逐步導覽。

下列情境說明如何使用 AppFunctions，在各種應用程式類別中提供體驗：

• 工作管理與工作效率
  • 使用者要求：「今天下午 5 點提醒我在公司領取包裹」。
  • AppFunction 動作：呼叫端會找出相關的工作管理應用程式，並叫用函式來建立工作，根據使用者的提示自動填入標題、時間和地點欄位。
• 媒體與娛樂
  • 使用者要求：「建立新播放清單，收錄今年最熱門的爵士專輯」。
  • AppFunction 動作：呼叫端在音樂應用程式中執行播放清單建立函式，並傳遞「2026 年熱門爵士專輯」等內容做為查詢，立即生成及啟動內容。
• 跨應用程式工作流程
  • 使用者要求：「Find the noodle recipe from Lisa's email and add the ingredients to my shopping list」(找出 Lisa 電子郵件中的麵條食譜，然後將食材加入我的購物清單)。
  • AppFunction 動作：這項要求會使用多個應用程式的函式。 首先，來電者會使用電子郵件應用程式的搜尋功能擷取內容。接著，系統會擷取相關食材，並叫用購物清單應用程式的函式，填入使用者的清單。
• 日曆和行事曆
  • 使用者要求：「在日曆中新增下週一下午 6 點的媽媽生日派對」。
  • AppFunction 動作：獲得核准的代理程式應用程式會叫用日曆應用程式的「建立活動」函式，剖析「下週一」和「下午 6 點」等相關情境，建立項目，使用者不必手動開啟日曆。

AppFunctions 的運作方式

AppFunctions 是 Android 16 平台功能和隨附的 Jetpack 程式庫，可讓應用程式公開特定功能，供呼叫端 (例如代理應用程式) 存取及在裝置上執行。

下圖說明應用程式如何將 AppFunction 分享給代理程式，以及後續的執行流程。服務專員處理使用者要求時，可能會同時考量伺服器端遠端 MCP 工具和本機 AppFunctions。使用本機 AppFunctions 的詳細流程如下：

• AppFunction 宣告：Android 應用程式會公開其 AppFunction，例如「建立記事」或「傳送訊息」。
• 產生結構定義：AppFunctions Jetpack 程式庫會產生 XML 結構定義檔案，列出應用程式中所有已宣告的 AppFunctions。Android 作業系統會使用這個檔案為可用的 AppFunctions 建立索引。
• 擷取中繼資料：代理程式可以查詢 AppFunction 中繼資料，藉此擷取中繼資料。
• 選取及執行 AppFunction：代理程式會根據使用者提示，選取及執行適當的 AppFunction，並提供適當的參數。

AppFunctions Jetpack 程式庫可簡化公開應用程式功能的程序。開發人員可使用註解處理工具，為要公開的函式加上註解。呼叫端接著可以使用 AppFunctionManager 探索及叫用這些已編列索引的函式。

呼叫函式前，呼叫端應嘗試擷取 AppFunctionManager 的執行個體，確認裝置支援 AppFunctions 功能。支援後，呼叫端可以使用 isAppFunctionEnabled(packageName, functionId) 驗證目標應用程式是否已啟用特定函式。如要查詢其他套件中函式的狀態，必須使用 android.permission.EXECUTE_APP_FUNCTIONS permission。

應用程式不需驗證是否支援 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

常見問題

以下是 AppFunctions 的常見問題。

問：我是應用程式開發人員，今天可以導入 AppFunctions 嗎？

答：可以。只要按照前幾節的詳細說明，即可在應用程式中導入及測試 AppFunctions。

問：我在應用程式中實作了 AppFunctions，為什麼系統代理程式無法存取這些函式？

答：AppFunctions 為實驗功能，為仔細評估實驗階段的整體體驗品質，只有少數應用程式和系統代理程式可以存取整個管道。

問：我正在開發代理程式，我可以存取應用程式提供的 AppFunctions 嗎？

答：測試代理程式可以在開發環境中存取 AppFunctions。 在實驗階段，只有少數系統代理程式可以存取及執行正式作業環境中的 AppFunctions。

問：哪些系統代理程式可以存取 AppFunctions？

A：只有少數系統代理程式可以存取整個管道，而 AppFunctions 仍處於實驗階段。

問：如何為 AppFunctions 正式發布做好準備？

答：請考慮要向代理程式自動化公開哪些應用程式功能。您可以在應用程式中實作 AppFunctions。如要這麼做，請按照本頁面先前章節中的步驟操作，並呼叫 adb shell cmd app_function list-app-functions，確認這些函式已在裝置上註冊。

問：我是否能搶先體驗端對端代理式開發人員服務？

答：我們正在進行搶先體驗計畫 (EAP)，讓特定應用程式加入測試，確保開發人員能順利完成所有程序，在 Android 上推出正式版 AppFunctions。如有意整合 AppFunctions，請填寫這份搶先體驗計畫註冊表單。登記意願後，您「不會」自動取得完整整合功能的存取權。如果您的應用程式獲選加入 EAP，或是 AppFunctions 公開發布時，我們都會寄送電子郵件通知您。

問：如何對 AppFunctions 提供意見回饋？

答：如要提供 API 意見，請提出問題，並填寫搶先體驗計畫表單。