Apple Intelligence API 개발자 가이드 — 온디바이스 AI 활용법

Apple Intelligence 개요 — 온디바이스 AI와 Private Cloud Compute

Foundation Models 프레임워크 — Swift에서 온디바이스 LLM 사용

Foundation Models — 기본 텍스트 생성 (Swift)
import FoundationModels

// 가용성 확인
guard LanguageModelSession.isAvailable else {
    print("Foundation Models not available on this device")
    return
}

// 세션 생성
let session = LanguageModelSession()

// 비동기 텍스트 생성
Task {
    do {
        let prompt = "다음 Swift 코드의 버그를 찾아서 설명해줘: \(codeSnippet)"
        let response = try await session.respond(to: prompt)
        print(response.content)
    } catch {
        print("Error: \(error)")
    }
}

Foundation Models — 구조화된 출력 (Structured Output)
import FoundationModels

// 출력 스키마 정의
@Generable
struct BugReport: Codable {
    let severity: String  // "high", "medium", "low"
    let description: String
    let suggestedFix: String
}

// 구조화된 응답 요청
let session = LanguageModelSession()
Task {
    do {
        let report = try await session.respond(
            to: "Analyze this code for bugs: \(code)",
            generating: BugReport.self
        )
        print("Severity: \(report.content.severity)")
        print("Fix: \(report.content.suggestedFix)")
    } catch {
        print("Error: \(error)")
    }
}

App Intents와 Siri 확장 — 앱 기능을 AI 액션으로 노출

App Intents — 기본 Intent 정의 (Swift)
import AppIntents

struct CreateTaskIntent: AppIntent {
    static var title: LocalizedStringResource = "Create Task"
    static var description = IntentDescription("Creates a new task in the app")
    
    @Parameter(title: "Task Name")
    var taskName: String
    
    @Parameter(title: "Due Date")
    var dueDate: Date?
    
    func perform() async throws -> some IntentResult {
        // 앱 내 태스크 생성 로직
        let task = try await TaskManager.shared.create(
            name: taskName,
            dueDate: dueDate
        )
        return .result(value: task.id)
    }
}

// Info.plist 또는 AppShortcutsProvider 등록 필요
struct AppShortcuts: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: CreateTaskIntent(),
            phrases: ["Create task in \(.applicationName)", "Add \(\.$taskName) to my tasks"]
        )
    }
}

Writing Tools API와 Image Playground API

Image Playground API — 기본 통합 (Swift)
import ImagePlayground
import UIKit

class ViewController: UIViewController, ImagePlaygroundSheetControllerDelegate {
    
    func openImagePlayground() {
        // 가용성 확인
        guard ImagePlaygroundViewController.isAvailable else {
            print("Image Playground not available")
            return
        }
        
        let controller = ImagePlaygroundViewController()
        controller.delegate = self
        // 초기 개념(concept) 제공 가능
        controller.concepts = [
            .text("A developer coding at night with multiple monitors")
        ]
        present(controller, animated: true)
    }
    
    // 생성 완료 콜백
    func imagePlaygroundViewController(
        _ controller: ImagePlaygroundViewController,
        didCreateImageAt imageURL: URL
    ) {
        // imageURL: 생성된 이미지의 로컬 파일 URL
        let image = UIImage(contentsOfFile: imageURL.path)
        // 앱에서 이미지 활용
        controller.dismiss(animated: true)
    }
    
    func imagePlaygroundViewControllerDidCancel(
        _ controller: ImagePlaygroundViewController
    ) {
        controller.dismiss(animated: true)
    }
}

Writing Tools — 커스텀 텍스트 뷰 지원
import UIKit

class CustomTextView: UIView {
    // UITextInput 프로토콜 준수 필요
    // Writing Tools 활성화를 위한 최소 구현
    
    var writingToolsBehavior: UIWritingToolsBehavior = .complete
    // .complete: 모든 Writing Tools 기능 활성화
    // .limited: 교정 기능만
    // .none: Writing Tools 비활성화
}

// 표준 UITextView 사용 시 추가 설정 불필요
let textView = UITextView()
textView.writingToolsBehavior = .complete  // 기본값

개발자가 지금 준비할 것 — 실무 체크리스트