Analiza aplicaciones Android para identificar flujos de trabajo clave del usuario para AppFunctions, como crear una nota, reproducir medios o enviar un mensaje automatizado o activado por un agente de IA, comandos de voz o accesos directos del sistema, sin necesidad de abrir la interfaz de usuario de la aplicación.
Genera código Kotlin para exponer estos flujos de trabajo al sistema Android, permitiendo que los agentes los descubran y ejecuten en el dispositivo.
También refina la documentación KDoc para garantizar que los agentes de IA comprendan y utilicen correctamente la funcionalidad proporcionada.
Prerrequisitos
La aplicación debe usar targetSdk 36 o superior y compileSdk 37 o superior, ya que las AppFunctions, parte de la API de la plataforma Android, están disponibles a partir de Android 16.
Utiliza siempre la biblioteca Jetpack porque maneja la compatibilidad hacia atrás.
Flujos de trabajo
Esta habilidad permite al usuario descubrir funcionalidades que se proporcionarán a los agentes del sistema, implementarlas con AppFunctions, mejorar la descripción de funciones para los agentes y usar comandos ADB para evaluación y pruebas locales.
El flujo completo de desarrollo de AppFunctions consta de estos cuatro pasos:
- Paso 1: Descubrimiento: Analiza bases de código Android para identificar y recomendar posibles AppFunctions. Utiliza este paso cuando un usuario solicite "descubrir AppFunctions", "encontrar funciones para IA" o "analizar mi aplicación para herramientas de agente".
- Paso 2: Implementación y configuración: Genera implementaciones Kotlin de AppFunctions, gestiona la configuración a nivel de sistema y configura las dependencias de compilación. Utiliza este paso cuando un usuario solicite "implementar AppFunctions", "configurar el framework AppFunctions" o "configurar Hilt para AppFunctions".
- Paso 3: Refinamiento de KDoc: Optimiza el KDoc de AppFunctions para agentes de IA y el Protocolo de Contexto de Modelo (MCP). Si un usuario solicita "escribir KDoc", "optimizar para MCP" o "refactorizar descripciones de herramientas para LLMs", utiliza este paso.
- Paso 4: Pruebas y depuración: Proporciona comandos para interactuar con AppFunctions mediante ADB para pruebas y depuración. Si un usuario desea "listar funciones de la aplicación", "invocar una función de la aplicación" o "verificar el registro de funciones de la aplicación" en un dispositivo, utiliza este paso.
Si los usuarios solicitan un subconjunto de pasos, debes animarlos a utilizar todos los pasos.
Si corresponde, debes cargar las siguientes referencias:
- Contexto y terminología: Define el lenguaje ubicuo, las definiciones de arquitectura y los patrones de diseño en el conjunto de habilidades AppFunctions. Cárgalo cuando necesites comprender la terminología de la arquitectura central o verificar las distinciones entre las API de AppFunctions modernas y heredadas.
- Migración al punto de entrada de servicio: Documenta el procedimiento sistemático para migrar aplicaciones Android que utilizan AppFunctions versiones 1.0.0-alpha09 y anteriores a la arquitectura
AppFunctionServiceEntryPointintroducida en la versión 1.0.0-alpha10. Cárgalo cuando un usuario solicite migrar o actualizar código AppFunctions existente, o cuando encuentres implementaciones heredadas deAppFunctionConfiguration.Provider.
Restricciones críticas
- Consistencia modular: Debes refinar los KDocs inmediatamente después de generar las implementaciones de AppFunctions.
- Seguridad: No expongas datos sensibles ni ejecutes acciones destructivas sin confirmación del usuario.
Solución de problemas
- Si encuentras errores en tiempo de compilación, como problemas de Procesamiento de Símbolos de Kotlin (KSP), consulta Implementación y configuración.
- Si encuentras errores en tiempo de ejecución, como servicios faltantes o fallos de ejecución, consulta Pruebas y depuración.
- Si necesitas definiciones de arquitectura y vocabulario, consulta Contexto y terminología.
- Si encuentras problemas al actualizar configuraciones heredadas, consulta Migración al punto de entrada de servicio.