apple-foundation-models

Apple Foundation Models スキル

このスキルを使用する場面

以下について支援が必要な場合に、このスキルを使用します。

• オンデバイス AI：オンデバイス言語モデルを使用した iOS／macOS アプリの構築
• SystemLanguageModel：Apple のオンデバイス LLM API の利用
• ガイド付き生成：プロンプトから構造化された Swift 型を生成
• ツール呼び出し：カスタムツールでモデルの機能を拡張
• プロンプト作成：オンデバイスモデルに効果的なプロンプトを作成
• 安全性：ガードレールの実装とセンシティブなコンテンツへの対応
• ローカライズ：多言語 AI 機能のサポート

このスキルは iOS 26.0 以降、iPadOS 26.0 以降、macOS 26.0 以降、visionOS 26.0 以降を対象としています。

説明

iOS／macOS アプリでオンデバイス AI と LLM 機能を利用するために、Apple の Foundation Models フレームワークを使用する際にこのスキルを使用します。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/ ディレクトリにあるカテゴリ別のドキュメントを参照してください。