Apple mostrou como as macros @Generable e @Guide no FoundationModels simplificam o desenvolvimento em Swift

Apple mostrou como os macros @Generable e @Guide no

FoundationModels simplificam o desenvolvimento em Swift

Apple continua melhorando sua abordagem para integrar inteligência artificial no Swift. O passo mais recente são os macros @Generable e @Guide, que permitem aos desenvolvedores trabalhar com geração estruturada de modelos de linguagem de forma type-safe.

O que são @Generable e @Guide?

@Generable é um macro que marca estruturas Swift para geração por modelos de linguagem. Em vez de obter texto bruto de um LLM e fazer parsing manualmente, os desenvolvedores agora podem especificar uma estrutura e pedir ao modelo que gere objetos que a correspondam. Essa abordagem é mais confiável do que a geração baseada em texto porque o modelo trabalha com um formato predefinido.

@Guide complementa @Generable fornecendo dicas no nível do campo. Com @Guide, os desenvolvedores podem especificar o que cada campo deve conter, dando ao modelo mais contexto para geração precisa. Por exemplo, se um campo espera um resumo, você pode dizer ao modelo: "Este campo deve conter uma descrição breve, não mais do que duas frases."

Como funciona a geração estruturada?

O processo é direto. Primeiro, você define uma estrutura Swift e a marca com @Generable. Em seguida, você usa uma LanguageModelSession para enviar um prompt ao modelo. O modelo entende a estrutura e retorna dados que correspondem à sua definição de tipo. Isso elimina a necessidade de parsing de strings e reduz a chance de erros.

Apple fornece suporte a streaming, então conforme o modelo gera dados, seu app recebe chunks progressivamente. Isso permite que as atualizações da UI aconteçam em tempo real em vez de esperar pela resposta completa. A integração com SwiftUI torna fácil vincular essas atualizações à interface.

Por que @Guide é importante

Sem @Guide, o modelo pode interpretar campos de forma ambígua. Com ele, os desenvolvedores ganham controle fino. Aqui estão os principais benefícios:

• Clareza — o modelo entende exatamente o que cada campo deve conter
• Validação — as dicas reduzem a probabilidade de dados incorretos ou irrelevantes
• Consistência — entre múltiplas gerações, os outputs permanecem previsíveis
• Eficiência — menos tentativas necessárias porque a primeira tentativa tem mais probabilidade de sucesso
• Segurança de tipos — integração com o sistema de tipos do Swift previne erros em tempo de execução

O quadro geral

A abordagem da Apple representa uma mudança de parsing de texto frágil para integração de IA estruturada e type-safe. Em vez de solicitar linguagem natural e esperar que o output possa ser analisado, os desenvolvedores agora trabalham com modelos de linguagem como geradores de dados. Isso torna as funcionalidades de IA mais confiáveis e mais fáceis de integrar em apps em produção. Os macros tratam da complexidade, deixando os desenvolvedores livres para focar na lógica de sua aplicação.