Apple mostró cómo las macros @Generable y @Guide en FoundationModels simplifican el desarrollo en Swift

Apple mostró cómo los macros @Generable y @Guide en

FoundationModels simplifican el desarrollo en Swift

Apple continúa mejorando su enfoque para integrar inteligencia artificial en Swift. El paso más reciente son los macros @Generable y @Guide, que permiten a los desarrolladores trabajar con generación estructurada de modelos de lenguaje de forma type-safe.

¿Qué son @Generable y @Guide?

@Generable es un macro que marca estructuras Swift para generación por modelos de lenguaje. En lugar de obtener texto bruto de un LLM y parsearlo manualmente, los desarrolladores ahora pueden especificar una estructura y pedir al modelo que genere objetos que la cumplan. Este enfoque es más confiable que la generación basada en texto porque el modelo trabaja con un formato predefinido.

@Guide complementa @Generable al proporcionar pistas a nivel de campo. Con @Guide, los desarrolladores pueden especificar qué debe contener cada campo, dando al modelo más contexto para generación precisa. Por ejemplo, si un campo espera un resumen, puedes decirle al modelo: "Este campo debe contener una descripción breve, no más de dos oraciones."

¿Cómo funciona la generación estructurada?

El proceso es directo. Primero, defines una estructura Swift y la marcas con @Generable. Luego utilizas una LanguageModelSession para enviar un prompt al modelo. El modelo entiende la estructura y devuelve datos que coinciden con tu definición de tipo. Esto elimina la necesidad de parseo de strings y reduce la posibilidad de errores.

Apple proporciona soporte para streaming, por lo que conforme el modelo genera datos, tu app recibe chunks progresivamente. Esto permite que las actualizaciones de la UI ocurran en tiempo real en lugar de esperar la respuesta completa. La integración con SwiftUI hace que sea fácil vincular estas actualizaciones a la interfaz.

Por qué @Guide es importante

Sin @Guide, el modelo podría interpretar campos de forma ambigua. Con él, los desarrolladores ganan control granular. Aquí están los beneficios principales:

• Claridad — el modelo entiende exactamente qué debe contener cada campo
• Validación — las pistas reducen la probabilidad de datos incorrectos o irrelevantes
• Consistencia — en múltiples generaciones, los resultados permanecen predecibles
• Eficiencia — se necesitan menos intentos porque el primer intento tiene más probabilidad de tener éxito
• Seguridad de tipos — la integración con el sistema de tipos de Swift previene errores en tiempo de ejecución

La perspectiva general

El enfoque de Apple representa un cambio de parseado de texto frágil a integración de IA estructurada y type-safe. En lugar de solicitar lenguaje natural y esperar que la salida pueda ser analizada, los desarrolladores ahora trabajan con modelos de lenguaje como generadores de datos. Esto hace que las características de IA sean más confiables y más fáciles de integrar en apps en producción. Los macros manejan la complejidad, dejando a los desarrolladores libres para enfocarse en la lógica de su aplicación.