apple-foundation-models

Apple Foundation Models 技能

何时使用此技能

在以下情况下使用此技能：

• 端侧 AI：使用端侧语言模型构建 iOS/macOS 应用
• SystemLanguageModel：使用 Apple 的端侧大模型 API
• 引导式生成：根据提示词生成结构化 Swift 类型
• 工具调用：使用自定义工具扩展模型能力
• 提示词：为端侧模型编写有效的提示词
• 安全性：实现防护措施并处理敏感内容
• 本地化：支持多语言 AI 功能

此技能适用于 iOS 26.0+、iPadOS 26.0+、macOS 26.0+ 和 visionOS 26.0+。

描述

在 iOS/macOS 应用中使用 Apple Foundation Models 框架实现端侧 AI 和大模型功能时，使用此技能。涵盖 SystemLanguageModel、LanguageModelSession、引导式生成、工具调用和提示词模式。

快速参考

核心组件

高级

• Transcript
• Transcript.Entry
• Transcript.Response
• Transcript.ResponseFormat
• Transcript.Segment
• Transcript.StructuredSegment

API 参考

• FoundationModels
• GenerationID
• SystemLanguageModel
• SystemLanguageModel.Adapter
• SystemLanguageModel.Guardrails
• SystemLanguageModel.UseCase

入门

• SystemLanguageModel.Availability

引导式生成

• DynamicGenerationSchema
• Generable
• GenerationGuide
• GenerationSchema
• Guide

本地化

• LanguageModelFeedback

提示词

• Instructions
• InstructionsBuilder
• InstructionsRepresentable
• LanguageModelSession
• LanguageModelSession.GenerationError
• LanguageModelSession.ToolCallError
• Prompt
• PromptBuilder
• PromptRepresentable
• Transcript.Instructions
• Transcript.Prompt

工具调用

• Tool

核心概念

平台支持

• iOS 26.0+
• iPadOS 26.0+
• macOS 26.0+
• Mac Catalyst 26.0+
• visionOS 26.0+

端侧 AI

所有模型都完全在设备上运行，确保隐私并支持离线使用。

使用指南

1. 使用前检查模型是否可用
2. 明确设定模型行为的指令
3. 使用引导式生成输出结构化内容
4. 使用工具调用实现动态能力
5. 妥善处理错误

导航

详细的 API 文档按类别整理在 references/ 目录中：

• references/advanced.md - 高级
• references/api_reference.md - API 参考
• references/getting_started.md - 入门
• references/guided_generation.md - 引导式生成
• references/localization.md - 本地化
• references/prompting.md - 提示词
• references/tool_calling.md - 工具调用

最佳实践

• 提示词：编写具体、清晰的提示词
• 指令：预先定义模型的行为
• 安全性：为敏感内容启用防护措施
• 本地化：针对使用场景检查支持的语言
• 性能：使用 prewarm() 缩短响应时间
• 流式传输：使用 streamResponse() 为用户提供实时反馈

常见模式

基本会话

let model = SystemLanguageModel(useCase: .general)
let session = LanguageModelSession(model: model)
let response = try await session.respond(to: Prompt("Your question"))

引导式生成

struct Recipe: Generable {
    let title: String
    let ingredients: [String]
}

let recipe = try await session.respond(
    generating: Recipe.self,
    prompt: Prompt("Create a pasta recipe")
)

工具调用

struct WeatherTool: Tool {
    func call(arguments: String) async throws -> String {
        // Fetch weather data
    }
}

let session = LanguageModelSession(
    model: model,
    tools: [WeatherTool()]
)

参考文档

完整的 API 详情请参阅 references/ 目录中按类别整理的文档。