Escolha quais partes do aplicativo disponibilizar ao sistema

O framework App Intents oferece uma das maneiras mais diretas de tornar um aplicativo iOS mais útil fora da própria interface. Use o Codex para disponibilizar as ações e os objetos do aplicativo no Atalhos, na Siri, no Spotlight, em widgets, em controles e em recursos mais recentes do sistema que usam assistentes. Assim, quem usa o aplicativo pode acessar esses recursos sem precisar primeiro abri-lo e navegar pelas telas.

Hoje, isso já facilita a descoberta de recursos e a automação de tarefas. Também prepara o aplicativo para um futuro em que os assistentes terão um papel maior. Se o aplicativo já permite criar, abrir, filtrar, encaminhar ou resumir algo de interesse para o usuário, o App Intents dá ao sistema uma forma estruturada de solicitar essa operação.

Comece pelas ações e entidades que vale a pena expor

Na primeira integração com o App Intents, raramente vale a pena “reproduzir todas as telas do aplicativo”. Peça ao Codex que identifique

• as poucas ações que o usuário gostaria de executar sem percorrer toda a interface
• os objetos do aplicativo que o sistema precisa reconhecer para encaminhar essas ações corretamente
• quais fluxos devem abrir o aplicativo em um estado específico e quais devem ser concluídos diretamente pela interface do sistema

A documentação da Apple sobre o App Intents sugere uma sequência para esse trabalho. Defina a ação, determine quais entidades o sistema precisa conhecer e disponibilize as ações para que possam ser encontradas e reutilizadas em diferentes recursos do sistema. As referências mais úteis são Como facilitar a descoberta de ações e conteúdo e ampliar sua disponibilidade, Como criar a primeira intenção do aplicativo e o exemplo Como integrar o App Intents aos recursos do sistema.

Considere as interfaces do sistema além dos atalhos

A integração vai além de “adicionar um atalho”. Ao escolher bem as ações e entidades que vai expor pelo App Intents, você pode tornar o aplicativo útil em vários contextos:

• no Atalhos, onde os usuários podem executar ações diretamente ou combiná-las em automações maiores
• na Siri, onde o aplicativo pode oferecer comandos para ações específicas e links diretos que levam o usuário além da tela inicial
• no Spotlight, onde os usuários podem encontrar entidades e atalhos do aplicativo e acessá-los pelo sistema
• em widgets, Atividades ao Vivo, controles e outras interfaces que usam intenções
• em recursos mais recentes voltados a assistentes, nos quais o sistema consegue interpretar ações e entidades estruturadas com muito mais facilidade do que sequências arbitrárias de interação com a interface

Adote uma estrutura que funcione na prática

Em geral, a integração funciona melhor quando o aplicativo se organiza da seguinte forma:

• um alvo de compilação dedicado ao App Intents para manter os tipos de intenção juntos, sem espalhá-los por arquivos do aplicativo que têm outras funções
• entradas em AppShortcutsProvider para ações importantes para o usuário, como escrever uma publicação ou abrir o aplicativo em uma aba específica
• tipos AppEntity pequenos para representar objetos que o sistema precisa interpretar, como contas, listas e filtros da linha do tempo
• um mecanismo que encaminhe as intenções à cena principal do aplicativo, para que uma intenção, ao ser acionada, possa abrir o fluxo de criação adequado ou mudar para a aba correta

Para a maioria dos aplicativos, eu pediria ao Codex que seguisse esse padrão. Comece com uma pequena camada de ações acessíveis ao sistema, limite as informações que as entidades expõem e defina como transferir o controle de volta ao aplicativo de forma previsível quando uma intenção precisar da interface principal durante a execução.

Peça ao Codex que defina o conjunto inicial de intenções

Para escrever um bom prompt, descreva os objetos centrais do aplicativo e as principais ações dos usuários. Em seguida, peça ao Codex que escolha o menor conjunto de ações e entidades que já seja útil expor pelo App Intents. Isso evita disponibilizar tudo sem critério.

Dicas práticas

Disponibilize ações que os usuários queiram executar fora do aplicativo

Criar conteúdo, abrir, encontrar, filtrar, iniciar, continuar ou inspecionar algo costumam ser boas opções para as primeiras intenções. Se uma ação só for útil depois de uma configuração demorada no aplicativo, talvez seja melhor deixá-la para uma etapa posterior da integração com o App Intents.

Exponha nas entidades apenas parte da camada de modelos

Em geral, o sistema não precisa do modelo de persistência completo. Peça ao Codex que exponha apenas as informações das entidades do aplicativo de que a Siri, o Atalhos e o Spotlight precisam para encaminhar e exibir a ação corretamente.

Use a integração como infraestrutura para assistentes, além de oferecer atalhos

Mesmo que, na primeira versão, os usuários só percebam melhorias no Atalhos ou na Siri, o aplicativo passa a expressar seus recursos por meio de ações e entidades estruturadas. Isso facilita a integração com futuros pontos de acesso oferecidos pelo sistema ou por IA, em comparação com um aplicativo cujos recursos só estão representados em sequências de toques e hierarquias de visualizações.