AI, Conheça o App: Testando as Funções do Aplicativo Android

A nova API de Funções do Aplicativo é a próxima fronteira para o Android. Ela basicamente transforma seu aplicativo em um provedor de dados em dispositivo para agentes IA. Em vez de se basear em pesquisas web genéricas, a IA pode agora conversar diretamente com seu aplicativo para obter informações altamente personalizadas e específicas do usuário.

É fácil de implementar, há até uma habilidade dedicada de agente AppFunctions que ajudará você a integrá-la mais rapidamente mas como testá-la?

Desafios de Teste das Funções do Aplicativo

No momento da escrita deste artigo (começo de agosto de 2026), a API Funções do Aplicativo está em prévia privada com testadores confiáveis, então você não pode simplesmente adicioná-la ao seu aplicativo e testar imediatamente com Gemini ou qualquer outro app IA no seu dispositivo ou emulador. Mas se, como eu, quiser ficar à frente da curva AI (e dos seus concorrentes!), você pode preparar o seu app agora. Dessa forma, quando for lançada para os usuários, o seu app estará pronto para começar a conversar com Gemini!

Há alguns métodos que você pode usar. Primeiro, vamos ver o que o Gemini vê...

Para minhas demonstrações, estou usando um pequeno app, Game Night Guru, que consulta um banco de dados local de jogos de tabuleiro e recomendará o que os usuários devem jogar com base no tamanho do grupo e nos interesses. Também permitirá aos usuários acompanhar o que eles já jogaram e gostaram.

Testar a Integração das Funções do Aplicativo via ADB

Antes de trazer a IA para o jogo, vamos verificar se o sistema operacional Android registrou com sucesso as Funções do Aplicativo que foram construídas.

O primeiro passo é instalar o Android Debug Bridge (ADB) se você ainda não tiver, para poder se comunicar com seu dispositivo.

Observação: Para que as Funções do Aplicativo funcionem, você precisará usar uma Imagem de Sistema de 36.0 (codinome Baklava) ou um dispositivo executando Android 16 ou superior.

Mantenha em mente que você precisa garantir que seu dispositivo tenha o depuragem USB habilitada, o que requer as Opções de Desenvolvedor estarem ativadas.

Execute este comando no terminal para listar todas as Funções do Aplicativo atualmente registradas em seu dispositivo:

adb shell cmd app_function list-app-functions

Você receberá uma lista longa com todas as funções disponíveis no dispositivo de cada aplicativo!

Para facilitar a localização do seu aplicativo, você pode filtrá-lo especificamente usando grep:

adb shell cmd app_function list-app-functions | grep -A 20 dev.katiebarnett.gamenightguru

Note: Certifique-se de substituir o nome do pacote pelo seu próprio nome de pacote de aplicativo. Você também pode modificar o número após -A no comando grep (a bandeira --after-context) para ver mais ou menos da definição da função.

Cuidado — se você estiver escrevendo suas próprias Funções de Aplicativo, qualquer pessoa com um dispositivo conectado a adb ou um aplicativo que atua como agente pode ver todas as definições/schemas das funções, então não inclua linguagem ou informações proprietárias que você não quer que outras pessoas vejam!

Agora que sabemos que o Android vê nossa função, como podemos testar se a chamada realmente funciona?

Download & Instalação do Agente de Teste

A Google fornece um aplicativo Agente de Teste privilegiado que atua como uma substituição para o Gemini. Isso nos permite testar fluxos de trabalho end-to-end sem precisar de um sistema de produção completo.

1. Para usar o agente de teste, certifique-se de que as Opções do Desenvolvedor estão habilitadas em seu emulador ou dispositivo.
2. Baixe ou clone o código-fonte do repositório App Functions Github.
3. Abra o terminal (ou use o Terminal do Android Studio) e mude para a pasta do agente onde você salvou o código-fonte do repositório App Functions:
   cd appfunctions/agent
4. Construa e instale o agente em seu dispositivo conectado usando o script fornecido: ./run_privileged.sh --build

Nota Importante para Usuários do Windows: Como este é um script de shell .sh, ele não será executado no Prompt de Comando padrão ou PowerShell. Você deve executar esse comando usando Git Bash (que é instalado automaticamente se você tiver o Git para Windows) ou WSL (Windows Subsystem for Linux).

Usando o Agente de Teste

A primeira coisa que podemos fazer é verificar se o agente vê as Funções do Aplicativo. Usando a lista suspensa, verifique quais aplicativos têm funções de aplicativo. Você pode inserir parâmetros e obter os resultados exatos que a função retorna (sem envolvimento da IA ainda) e executar funções que atualizam os dados.

Agora sabemos que ele pode ver nosso aplicativo e as Funções do Aplicativo disponíveis, vamos conectá-lo ao Gemini!

Obtenha uma Chave da API do Gemini

Para dar ao nosso Agente de Teste um cérebro, precisamos de uma chave da API do Gemini. Usaremos a camada gratuita, então não há necessidade de adicionar um cartão de crédito ou se inscrever em um plano profissional.

1. Acesse a página de Chaves da API do Google AI Studio.
2. Faça login com sua conta do Google.
3. Clique em Criar chave da API no canto superior direito.
4. Crie ou escolha um projeto e nomeie sua chave. Clique em Criar chave.
5. Copie a chave gerada usando o ícone de cópia ou o botão Copiar chave.

Teste em Tempo Real!

Aqui é onde a mágica acontece. Vamos perguntar ao agente uma pergunta em linguagem natural e assistir enquanto ele dispara a função específica do nosso aplicativo.

1. Abra o aplicativo AppFunctions Testing Agent no seu dispositivo Android/emuador.
2. Navegue até a tela de Configurações. Cole sua chave da API Gemini na tela de configuração do agente.

3. Navegue até o Demo do Agente, digite uma solicitação em linguagem natural que atenda à função que você deseja testar. Por exemplo:

“Tenho 4 amigos vindo para duas horas e amamos jogos de estratégia. O que devemos jogar?”

4. Pressione enviar

Você verá o agente processar a solicitação (note-se que pode demorar mais do que no vídeo acima!), descobrir a função de aplicativo queryGames, mapear