AppFunctions는 Android MCP 통합을 간소화하는 Jetpack 라이브러리가 함께 제공되는 Android 플랫폼 API입니다. 이를 통해 앱이 온디바이스 MCP 서버처럼 작동하여 Google Gemini와 같은 에이전트 및 어시스턴트와 함께 사전 대응형 기능에서 사용할 수 있는 도구 역할을 하는 함수를 제공할 수 있습니다. Gemini로 AppFunctions를 테스트하고 게시하려면 연결된 앱 플랫폼 개발자 프리뷰를 신청하세요. 가입한 후 연결된 앱 만들기 및 관리의 단계를 따릅니다.
이러한 AppFunction을 정의하면 앱이 Android OS에 내장된 레지스트리에 서비스, 데이터, 작업을 제공할 수 있으므로 사용자가 에이전트 및 시스템 수준 상호작용을 통해 작업을 완료할 수 있습니다.
AppFunctions는 모델 컨텍스트 프로토콜(MCP) 내에서 도구의 모바일 버전 역할을 합니다. MCP는 일반적으로 에이전트가 서버 측 도구에 연결하는 방식을 표준화하지만, AppFunctions는 Android 앱에 동일한 메커니즘을 제공합니다. 이를 통해 승인된 앱(호출자)이 사용자 의도를 충족하기 위해 검색하고 실행할 수 있는 조정 가능한 '도구'로 앱의 기능을 노출할 수 있습니다. 호출자는 AppFunction을 검색하고 실행할 수 있는 EXECUTE_APP_FUNCTIONS 권한이 있어야 하며, 여기에는 에이전트, 앱, Gemini와 같은 AI 어시스턴트가 포함될 수 있습니다.
AppFunctions는 Android 16 이상을 실행하는 기기에서 사용할 수 있습니다.
사용 사례
AppFunctions는 작업을 자동화하고 사용자 상호작용을 간소화하는 강력한 메커니즘을 제공합니다. 앱의 기능을 개방하면 사용자가 자연어를 사용하여 복잡한 목표를 달성할 수 있으며, UI를 통한 단계별 수동 탐색의 필요성을 대체할 수 있습니다.
다음 시나리오는 AppFunctions를 사용하여 다양한 앱 카테고리 내에서 환경을 유도하는 방법을 보여줍니다.
작업 관리 및 생산성
- 사용자 요청: "오늘 오후 5시에 직장에서 택배 수령하라고 알림 설정해 줘"
- AppFunction 작업: 호출자가 관련 작업 관리 앱을 식별하고 함수를 호출하여 작업을 만들고 사용자의 프롬프트를 기반으로 제목, 시간, 위치 필드를 자동으로 채웁니다.
/** * Create a new task or reminder with a title, due time, and location. * * @param title The descriptive title of the task (e.g., "Pick up my package"). * @param dueDateTime The specific date and time when the task should be completed. * @param location The physical location associated with the task (e.g., "Work"). * @return The created Task */ @AppFunctionDeclaration(isDescribedByKDoc = true) suspend fun createTask( title: String, dueDateTime: LocalDateTime? = null, location: String? = null, ): Task = TODO()
미디어 및 엔터테인먼트
- 사용자 요청: "올해의 인기 재즈 앨범으로 새 재생목록을 만들어 줘"
- AppFunction 작업: 호출자가 음악 앱 내에서 재생목록 생성 함수를 실행하여 '2026년 최고의 재즈 앨범'과 같은 컨텍스트를 쿼리로 전달하여 재생목록을 즉시 생성합니다.
/** * Create a new music playlist based on a natural language query. * * @param query The description used to generate the playlist (e.g., "top jazz albums from 2026"). * @return The final created playlist based on songs. */ @AppFunctionDeclaration(isDescribedByKDoc = true) suspend fun createPlaylistFromQuery( query: String, ): Playlist = TODO()
앱 간 워크플로
- 사용자 요청: "리사의 이메일에서 국수 레시피를 찾아서 쇼핑 목록에 재료를 추가해 줘"
- AppFunction 작업: 이 요청은 여러 앱의 함수를 사용합니다. 먼저 호출자는 이메일 앱의 검색 기능을 사용하여 콘텐츠를 검색합니다. 그런 다음 관련 재료를 추출하고 쇼핑 목록 앱의 함수를 호출하여 사용자의 목록을 채웁니다.
/** * Search for emails matching a query or sender name to retrieve content like recipes. * * @param query The search term or contact name (e.g., "Lisa noodle recipe"). * @return A list of matching email summaries containing the requested information. */ @AppFunctionDeclaration(isDescribedByKDoc = true) suspend fun searchEmails( query: String, ): List<EmailSummary> = TODO() /** * Add a list of items or ingredients to the user's active shopping list. * * @param items The names of the ingredients or products to add to the list. * @return The final shopping list with new items added */ @AppFunctionDeclaration(isDescribedByKDoc = true) suspend fun addItemsToShoppingList( items: List<String>, ): ShoppingList = TODO()
캘린더 및 일정 예약
- 사용자 요청: "다음 주 월요일 오후 6시에 엄마 생일 파티를 내 캘린더에 추가해 줘"
- AppFunction 작업: 승인된 에이전트형 앱이 캘린더 앱의 '일정 만들기' 함수를 호출하여 '다음 주 월요일', '오후 6시'와 같은 관련 컨텍스트를 파싱하여 사용자가 수동으로 캘린더를 열지 않고도 항목을 만듭니다.
/** * Schedule a new event on the user's primary calendar. * * @param title The name of the calendar event (e.g., "Mom's birthday party"). * @param startDateTime The specific date and time the event is scheduled to begin. * @return The created Event object. */ @AppFunctionDeclaration(isDescribedByKDoc = true) suspend fun createCalendarEvent( title: String, startDateTime: LocalDateTime, ): Event = TODO()
AppFunctions 작동 방식
다음 다이어그램은 앱에서 에이전트로 AppFunctions를 공유하고 이후에 실행하는 일반적인 흐름을 보여줍니다. 에이전트는 사용자 요청을 처리할 때 서버 측 원격 MCP 도구와 로컬 AppFunctions를 모두 고려할 수 있습니다. 로컬 AppFunctions를 사용하는 자세한 흐름은 다음과 같습니다.
- AppFunction 선언: Android 앱은 AppFunction을 사용하여 '메모 작성' 또는 '메시지 전송'과 같은 기능을 사용할 수 있도록 빌드됩니다.
- 스키마 생성: AppFunctions Jetpack 라이브러리는 앱에 선언된 모든 AppFunctions를 나열하는 XML 스키마 파일을 생성합니다. Android OS는 이 파일을 사용하여 사용 가능한 AppFunctions의 색인을 생성합니다.
- 메타데이터 검색: 에이전트는 AppFunction 메타데이터를 쿼리하여 검색할 수 있습니다. 개발자는 함수별 KDoc 외에도 앱 메타데이터에서 앱 수준 운영 패턴과 제약 조건을 정의하여 여러 도구에서 에이전트 조정을 안내할 수 있습니다.
- AppFunction 선택 및 실행: 에이전트는 사용자 프롬프트를 기반으로 적절한 매개변수를 사용하여 적절한 AppFunction을 선택하고 실행합니다.
AppFunctions Jetpack 라이브러리를 사용하면 앱의 기능을 간편하게 노출할 수 있습니다.
주석 프로세서를 사용하면 에이전트에서 사용할 수 있도록 하려는 함수에 주석을 추가할 수 있습니다. 그러면 호출자는 AppFunctionManager를 사용하여 이러한 색인 생성 함수를 검색하고 호출할 수 있습니다.
함수를 호출하기 전에 호출자는 AppFunctionManager 인스턴스를 가져오려고 시도하여 기기가 AppFunctions 기능을 지원하는지 확인해야 합니다. 지원되면 호출자는 isAppFunctionEnabled(packageName,functionId)를 사용하여 대상 앱 내에서 특정 기능이 사용 설정되어 있는지 확인할 수 있습니다. 다른 패키지의 함수 상태를 쿼리하려면 android.permission.EXECUTE_APP_FUNCTIONS 권한이 필요합니다.
앱은 AppFunction 기능이 지원되는지 확인할 필요가 없습니다. 이는 Jetpack 라이브러리 내에서 자동으로 처리됩니다. 예를 들어 AppFunctionManager는 기능이 지원되는지 여부를 확인할 수 있습니다.
다음은 메모를 만들고 수정하고 나열하는 기능이 있는 메모 작성 앱의 AppFunctions 예입니다.
@RequiresApi(36) @AndroidEntryPoint @AppFunctionServiceEntryPoint( serviceName = "TaskAppFunctionService", appFunctionXmlFileName = "task_app_function_service", ) abstract class BaseTaskAppFunctionService : AppFunctionService() { @Inject internal lateinit var taskRepository: TaskRepository /** * Creates a task with a title, content, or both. * * @param createTaskParams The title and content of the task. At least one * of them is required. * @return The created task, including its ID. */ @AppFunctionDeclaration(isDescribedByKDoc = true) suspend fun createTask( createTaskParams: CreateTaskParams, ): Task = withContext(Dispatchers.IO) { // Developers can use predefined exceptions to let the agent know // why it failed. if (createTaskParams.title == null && createTaskParams.content == null) { throw AppFunctionInvalidArgumentException("A task needs a title, content, or both.") } val id = taskRepository.createTask( createTaskParams.title, createTaskParams.content ) return@withContext taskRepository .getTask(id) ?.toTask() ?: throw AppFunctionElementNotFoundException("Task not found for ID = $id") } // Maps internal TaskEntity private fun TaskEntity.toTask() = Task(id = id, title = title, content = description) }
/** The title and content of a new task. */ @AppFunctionSerializable(isDescribedByKDoc = true) data class CreateTaskParams( /** The title of the task. */ val title: String?, /** The content of the task. */ val content: String?, ) /** The user-created task. */ @AppFunctionSerializable(isDescribedByKDoc = true) data class Task( /** The ID of the task. */ val id: String, /** The title of the task. */ val title: String, /** The content of the task. */ val content: String, )
샘플, 기술, 테스트 도구
AppFunctions 기술을 향상하는 데 도움이 되는 다음 리소스를 제공합니다.
- AppFunctions 샘플을 살펴보고 기기에서 모든 기능이 어떻게 작동하는지 확인하고 살펴보세요.
- AppFunctions 에이전트 기술을 사용하여 4단계 수명 주기에 걸쳐 개발을 가속화합니다.
- 탐색: 코드베이스를 분석하여 AI 조정을 위한 고가치 기능을 식별하고 추천합니다.
- 구현 및 구성: Kotlin 구현을 생성하고 시스템 메타데이터와 빌드 종속 항목을 구성합니다.
- KDoc 미세 조정: AI 에이전트 및 Android MCP를 위한 함수 및 속성 문서를 최적화합니다.
- 테스트 및 디버깅: 기기 내 로컬 평가 및 디버깅을 위한 ADB 명령어를 제공합니다.
- 생략된 기본값, 기본 스레드 호출,
AppFunctionException오류, 모델 생성 입력을 포함한 함수 동작 방식과 에이전트가 함수를 선택하고 호출하는 방식을 모두 테스트합니다. 단위, ADB, 에이전트 테스트에 관한 자세한 내용은 AppFunction 통합 확인을 참고하세요. - Gemini가 AppFunctions를 사용하는 방식을 테스트하려면 연결된 앱 만들기 및 관리의 단계를 따르세요.
자주 묻는 질문(FAQ)
다음 섹션에서는 AppFunctions에 관해 자주 묻는 질문(FAQ)을 다룹니다.
앱 개발자입니다. 지금 AppFunctions를 구현할 수 있나요?
예, 이전 섹션에 설명된 안내에 따라 앱 내에서 AppFunctions를 구현하고 테스트할 수 있습니다.
AppFunctions와 MCP의 차이점은 무엇인가요?
두 가지 모두 AI 에이전트가 도구를 조정할 수 있지만 아키텍처, 지연 시간, 필요한 개발자 노력에 상당한 차이가 있습니다. AppFunctions는 로컬에서 실행되는 Android 전용 내장 OS 수준 후크입니다. 반면 표준 MCP 서버는 클라우드 실행 및 네트워크 왕복에 의존하는 플랫폼 제약이 없는 솔루션입니다.
간단히 말해, AppFunctions를 사용하여 개발하면 기존 앱 상태를 온디바이스에서 직접 사용할 수 있으며 Android 앱 외부에서 서비스를 유지할 필요가 없습니다.
앱에 AppFunctions를 구현했습니다. Gemini 또는 다른 AI 에이전트가 액세스할 수 없는 이유는 무엇인가요?
- Android에서 Gemini와 함께 AppFunctions를 사용하려면 연결된 앱 플랫폼 개발자 프리뷰를 통해 Google Connected Console에서 앱을 등록하고 제출하세요. 연결된 앱이 게시될 때까지 연결된 앱의 테스터 목록에 있는 테스터만 제출한 App Bundle 버전에서만 앱을 사용할 수 있습니다. 설정 단계는 연결된 앱 및 Android MCP에 관한 Google Connected Console 가이드를 참고하세요.
- 자체 에이전트에서 AppFunctions를 호출하는 경우: 앱은 자체 패키지 내에 선언된 AppFunctions를 호출할 수 있습니다. 다른 앱의 AppFunctions를 검색하고 호출하려면 권한이 있는
EXECUTE_APP_FUNCTIONS권한이 필요합니다. 이 권한은 Android에서 승인된 시스템 어시스턴트에게만 부여됩니다.
AppFunctions의 정식 버전에 대비하여 앱을 어떻게 준비해야 하나요?
앱의 어떤 기능을 에이전트 자동화에 노출할지 고려하세요.
앱에서 AppFunctions를 구현할 수 있습니다. 이렇게 하려면 이 페이지의 이전 섹션에 있는 단계를 따르고 앱의 패키지 이름으로 adb shell cmd app_function list-app-functions --package를 호출하여 기기에 등록되어 있는지 확인합니다.
Gemini를 사용하여 AppFunctions를 테스트하고 게시하려면 어떻게 해야 하나요?
연결된 앱 플랫폼 개발자 프리뷰에 참여하세요. 액세스 권한을 요청하려면 프리뷰를 신청하세요. 가입한 후 Google Connected Console에서 Android MCP 연결 앱을 만들고, App Bundle을 테스트 트랙에 업로드하고, 두 트랙에 동일한 테스터를 추가합니다. 자세한 내용은 연결된 앱 만들기 및 관리를 참조하세요.
AppFunctions에 관한 의견을 제공하려면 어떻게 해야 하나요?
문제를 신고하여 API에 관한 의견을 제공할 수 있습니다.