Siri AI 개발자 프리뷰: 내 앱 액션을 시리에 연결하는 법
Apple이 2026년 11월 3일 Siri AI 개발자 프리뷰를 열었다. @AppIntent(.tool) 한 줄로 앱 액션을 시리에 연결하는 방법과 앱 스킬, 테스트 범위, 제한을 Apple 문서 기준으로 정리했다.

Q. Siri AI에 내 앱을 연결하려면 지금 뭘 해야 하나요? 2026년 11월 3일 열린 Siri AI 개발자 프리뷰에 참가하면 된다. 기존 App Intent에
@AppIntent(.tool)매크로 한 줄을 붙이면 Siri가 앱 액션을 부를 수 있고, 복잡한 요청은 SKILL.md로 가르친다. 지금은 테스트만 가능하고 앱스토어 제출은 2027년 봄에 열린다.
⚠️ 정확도 가드레일: 이 글은 2026년 11월 20일 기준이다. 사실은 Apple Developer News·Documentation에서 직접 확인했다. Xcode 버전은 2차 정리 기준, 별도 entitlement 필요 여부는 Apple 문서에 없어 확인하지 못했다.
30초 요약
- 프리뷰는 2026년 11월 3일 시작했고, iOS·iPadOS·macOS·visionOS 27.3 베타에서 모든 개발자에게 열렸다.
- 기존 App Intent에
@AppIntent(.tool)을 붙이면 Siri가 호출할 수 있는 도구 인텐트가 된다. - 여러 단계를 조합하는 복잡한 요청은 SKILL.md 앱 스킬로 순서와 주의사항을 가르친다.
- 테스트는 개발 서명 빌드와 내부 TestFlight에서만 가능하고, 외부 TestFlight와 앱스토어 버전에서는 동작하지 않는다.
- 한국어는 출시 언어 6개에 포함되지만, EU iOS·iPadOS·watchOS에서는 쓸 수 없다.
프리뷰 핵심: 모든 개발자에게 열렸다
Siri AI 개발자 프리뷰는 2026년 11월 3일, iOS 27.3·iPadOS 27.3·macOS 27.3·visionOS 27.3 베타와 함께 시작됐다. Apple은 "어떤 개발자든" App Intents로 앱의 콘텐츠와 액션을 Siri AI로 가져올 수 있다고 밝혔다. 개인 맥락 이해·화면 인식·자연어를 앞세운 완전히 새로워진 Siri다. Apple이 든 예시는 배송 조회·예약·주문처럼, 말 한마디로 앱 액션을 실행하는 흐름이다. 고객 출시는 "수개월 내", 앱스토어 제출은 봄이다.

도구 인텐트: 기존 인텐트에 매크로 한 줄이면 된다
연결의 출발점은 도구 인텐트다. Siri는 개발자가 명시적으로 제공한 동작만 수행한다. 새 인텐트든 기존 인텐트든 @AppIntent(.tool) 매크로를 추가하면, 그 인텐트는 Siri가 호출할 수 있는 도구가 된다. 매크로는 ToolIntent 프로토콜 conformance를 추가한다. Apple 문서의 쇼핑 앱 예시다.
@AppIntent(.tool)
struct AddToCart: AppIntent {
static var title: LocalizedStringResource = "Add to Cart"
@Parameter(title: "Item") var item: ProductEntity
func perform() async throws -> some IntentResult {
Cart.shared.add(item, quantity: 1)
return .result()
}
}
예외도 있다. 이미 앱 스키마 도메인의 기본 스키마에 conform해서 Siri에 제공되는 인텐트에는 붙이지 않는다. 메시징 앱의 sendMessage가 예다. perform() 구현이 없어 커스텀 동작을 하지 않는 인텐트도 대상이 아니다. 단축어만 지원하는 스키마는 @AppIntent(.tool, schema:)로 바꾼다.
주의할 점이 하나 있다. 도구 인텐트를 하나라도 추가하면 App Shortcuts는 Siri에서 쓸 수 없게 된다. 그래서 도구 인텐트가 App Shortcuts가 제공하던 기능을 Siri에 제공하도록 만들어야 한다. App Shortcuts 자체는 지우지 말 것. Spotlight나 액션 버튼에서는 계속 쓸 수 있다.
인텐트와 파라미터, 엔티티에는 제목과 설명을 달아야 한다. Siri가 동작을 이해하고, 인텐트를 구별하고, 파라미터를 채우는 기준이기 때문이다. 엔티티는 Spotlight에 제공해야 Siri가 찾을 수 있다. Spotlight 시맨틱 인덱스에는 스키마에 맞는 엔티티뿐 아니라 어떤 엔티티든 올릴 수 있게 됐다.

앱 스킬: 복잡한 요청은 SKILL.md로 가르친다
도구 인텐트 하나는 동작 하나다. "신발을 찾아 장바구니에 담고 결제·배송 방식을 골라 확인까지 해줘" 같은 복잡한 요청은 인텐트 여러 개를 올바른 순서로 엮어야 한다. 그 간극을 메우는 게 앱 스킬이다. 여러 도구 인텐트를 어떻게 조합하는지, 여러 인텐트가 가능할 때 어느 것을 우선할지, 무엇을 피해야 하는지 Siri에게 알려준다.
만드는 방법은 정해져 있다. Xcode 프로젝트에 Skills.skillsbundle을 추가하고, Skills 폴더 안에 스킬 이름의 하위 폴더를 만든 뒤 SKILL.md 파일 하나만 넣는다. 스킬 이름은 소문자·숫자·하이픈만 쓰고 1~64자이며, 폴더 이름과 일치해야 한다. SKILL.md는 앞부분 메타데이터와 마크다운 본문으로 나뉜다. description은 필수, 한 줄, 1,024자 이하다. Siri는 이 설명만 보고 스킬이 요청에 맞는지 판단한다. 본문은 10,000자 이하의 지침이다.
테스트 범위: 지금은 개발 빌드와 내부 TestFlight만
프리뷰 통합은 지금 당장 써볼 수 있지만, 쓸 수 있는 곳이 정해져 있다. Xcode로 개발 프로파일로 서명한 빌드를 Apple Intelligence 지원 기기에서 직접 실행하거나, 내부 테스터에게 TestFlight로 배포한다. 시뮬레이터가 아니라 실기기로 확인해야 한다.
외부 TestFlight 테스터와 앱스토어에서 받은 버전에서는 Siri AI 개발자 프리뷰 기능이 동작하지 않는다. 실제 사용자에게 닿는 건 봄 제출이 열린 뒤다.

제한과 언어: 한국어는 되지만 EU는 안 된다
Siri AI는 Apple Intelligence 지원 기기에서, 지원 언어로 설정했을 때 쓸 수 있다. 출시 언어는 영어·프랑스어·일본어·한국어·포르투갈어·스페인어 6개다. 한국어가 첫날부터 포함됐다. 번체 중국어·노르웨이어·터키어·베트남어는 곧 추가된다.
제한도 명확하다. EU에서는 iOS·iPadOS·watchOS에서 쓸 수 없고, 13세 미만도 제외된다. 서버 측 모델 기능에는 일일 사용량 제한이 있고, Apple은 나중에 유료 확장 접근을 제공하겠다고 밝혔다.

시작 체크리스트: Xcode부터 Siri Evaluations까지
지금 시작한다면 순서다. 첫째, 27.3 베타가 깔린 Apple Intelligence 지원 기기를 준비한다. 둘째, 앱의 핵심 기능부터 도구 인텐트로 만든다. 셋째, 인텐트·파라미터·엔티티마다 제목과 설명을 빠짐없이 단다. 넷째, 복잡한 흐름이 있으면 앱 스킬을 하나 만들어 순서와 주의사항을 적는다. 다섯째, 실기기에서 직접 요청해보고, 내부 TestFlight로 팀원에게 돌린다.
검증 도구도 두 가지다. Xcode의 Siri Integration Advisor는 App Intents 구현에 대한 피드백을 준다. Siri Evaluations 프레임워크는 Siri에 보낼 요청을 스크립트로 짜고, Siri가 어떻게 처리하는지 측정한다.
토리스의 판단
이 프리뷰의 가치는 "시리가 내 앱을 부른다"는 한 줄이 아니라, 호출을 설계하는 규칙이 문서로 나와 있다는 점이다. 도구 인텐트 한 줄, SKILL.md의 1,024자 설명과 10,000자 본문, 테스트 범위와 제한까지 숫자와 경계가 정해져 있다. 한국 사용자를 겨냥한 앱이라면 봄 제출 전에 실기기에서 한 번 돌려보는 게 맞다. 다만 프리뷰 기간에 API가 바뀔 수 있고 약관·사용 정책이 아직 안 나왔다. 결제·개인정보처럼 되돌리기 어려운 동작은 내부 테스트에서 실패하는 경우를 먼저 확인하는 게 안전하다. 앱에 음성 경험을 붙이는 작업이 필요하면 토리스 스튜디오에서 같이 설계할 수 있다.
출처
광고
YOUTUBE · TORIS STUDIO