하루인포팁

생활·건강·지원금·IT까지, 하루에 필요한 정보를 한 번에

iOS 27.3 시리 AI 앱 연동: 스키마냐 ToolIntent냐 고르는 기준

iOS 27.3 시리 AI 앱 연동: 스키마냐 ToolIntent냐 고르는 기준

작성자

카테고리:

약 18분 소요

Siri AI 앱 연동은 App Intents 스키마를 먼저 검토하고, 맞지 않는 동작만 ToolIntent로 노출하는 순서가 기본입니다. iOS 27.3 프리뷰의 구조와 제약을 정리했습니다.

이 글에는 네이버 브랜드커넥트 제휴 링크가 포함되어 있습니다. 링크를 통해 구매가 이루어지면 작성자가 일정액의 수수료를 지급받습니다. 제품 선택과 구매는 독자의 판단이며, 이 글은 특정 제품의 효과를 보증하지 않습니다.


시리 AI 앱 연동, 무엇을 기준으로 비교해야 할까

시리 AI 앱 연동, 무엇을 기준으로 비교해야 할까

시리 AI 앱 연동의 첫 판단은 간단합니다. App Intents 스키마가 맞으면 스키마를 채택하고, 맞지 않는 동작만 @AppIntent(.tool)로 노출하면 됩니다. 애플은 2026년 11월 3일 iOS·iPadOS·macOS·visionOS 27.3 베타와 함께 Developer Preview를 열어 모든 개발자에게 Siri AI 연동을 허용했습니다. 이 글은 2026년 11월 7일에 확인한 문서를 기준으로 연동 구조와 도입 순서를 다루며, 약관이 공개되지 않은 수익 모델은 판단 대상에서 뺐습니다.

연동 코드를 지금 쓸 수 있어도 사용자에게 바로 배포할 수 있는 건 아닙니다. 프리뷰 문서에 따르면 이 기능은 내부 TestFlight 테스터와 개발 서명 빌드에서만 동작합니다. 외부 TestFlight와 App Store 배포판에서는 연동 코드가 있어도 켜지지 않습니다.

일정도 넓게 잡아야 합니다. 애플은 고객 제공을 “in a few months”, App Store 제출을 “in the spring”이라고만 밝혔고, 정확한 날짜는 공개하지 않았습니다. 고객 제공 시점은 매체마다 표현이 갈리니 애플 원문을 기준으로 계획하는 편이 안전합니다.

그래서 비교 기준은 네 가지로 좁혀집니다. 스키마가 동작을 표현할 수 있는지, Siri가 콘텐츠를 찾을 수 있는지, 순서와 안전 조건을 어디서 보장할지, 어떤 환경에서 호출되는지입니다. 네 답은 앱 구조에 따라 서로 다를 수 있으니 기능 단위로 나눠서 판단해야 합니다.


비교 기준 정리

App Intents 연동은 콘텐츠, 스키마, 커스텀 도구, 설명의 4층으로 나눠 보면 정리가 쉽습니다. 어느 한 층이 비면 다른 층을 잘 구현해도 Siri가 동작을 고르지 못할 수 있습니다. 11월 프리뷰에서 새로 열린 핵심은 커스텀 도구 층입니다.

층 구현 수단 판단 기준 주의점
콘텐츠 AppEntity, IndexedEntity 콘텐츠를 시스템 시맨틱 인덱스에 넣을 수 있는가 인덱싱이 어려우면 EntityStringQuery로 앱이 직접 검색해 반환
스키마 시스템 정의 도메인 주요 도메인 13개 안에 동작이 들어가는가 단축어 전용 9개는 Apple Intelligence와 Siri에서 발견되지 않음
커스텀 도구 @AppIntent(.tool), ToolIntent 스키마 밖 동작인가 주요 도메인 스키마를 이미 채택한 인텐트에는 붙이지 않음
설명 title, description 파라미터와 엔터티 속성까지 설명했는가 Siri가 이 값에 의존하므로 라우팅 품질에 직접 영향

스키마 도메인은 주요 13개, 단일 목적 2개, 단축어 전용 9개로 나뉩니다. 단일 목적 2개는 Assistant와 Visual intelligence입니다. 도메인 총수보다 단축어 전용 여부를 먼저 확인합니다. 스키마를 채택해도 이쪽에 속하면 Siri가 찾지 못합니다.

호출 맥락도 별도 기준입니다. 앱이 포그라운드이거나 Live Activity가 활성 상태이거나 Siri 앱 대화에서 이미 앱을 언급했다면 앱 이름을 말하지 않아도 됩니다. 반대로 앱이 백그라운드면 요청에 앱 이름이 들어가야 합니다. 음성 명령 예시나 온보딩 문구도 이 조건에 맞춰 설계합니다.

화면 맥락은 표시되는 항목 수로 갈립니다. WWDC26 세션 240에 따르면 주된 항목이 하나면 UserActivity, 여러 항목이 보이면 View annotations를 씁니다. 목록 화면과 상세 화면이 함께 있는 앱은 화면마다 다른 방식을 적용해야 합니다.

실행 조건은 설계 단계에서 확인해 둡니다. WWDC26 세션 345 기준으로 인텐트 실행 한도는 30초이며, 더 오래 걸리면 LongRunningIntent로 넘길 수 있습니다. 많은 엔터티를 다룰 때는 해석된 엔터티 대신 식별자 배열을 넘기는 EntityCollection이 있고, 기기 간 안정적인 ID가 필요하면 SyncableEntity로 선언합니다.

용어 풀이
1. ToolIntent — @AppIntent(.tool)을 붙여 스키마 밖 동작을 Siri의 도구로 노출한 인텐트입니다.
2. 앱 스킬 — 여러 동작을 조합하는 방법을 SKILL.md로 Siri에 알려주는 지침 묶음입니다.


옵션·유형별 비교

옵션·유형별 비교

같은 연동이라도 구현 수단마다 해결하는 문제가 다릅니다. 스키마와 ToolIntent는 무엇을 실행할지를, 엔터티 쿼리는 무엇을 찾을지를, 앱 스킬은 어떻게 조합할지를 맡습니다. 서로 대체 관계가 아니라 층이 다른 도구입니다.

구현 수단 맡는 역할 적합한 경우 제약
스키마 채택 표준 동작 연결 주요 도메인에 들어가는 기능 도메인 밖 동작은 표현 불가
ToolIntent 커스텀 동작 노출 앱 고유 기능 설명 품질이 호출 품질을 좌우
IndexedEntity 콘텐츠 검색 시스템 인덱스에 넣을 수 있는 콘텐츠 인덱싱 가능한 데이터여야 함
EntityStringQuery 앱 내부 직접 검색 인덱싱이 어려운 데이터 앱이 검색 결과를 직접 반환
앱 스킬 복합 동작 안내 여러 인텐트를 조합하는 작업 실행 순서를 보장하지 않음

앱 스킬의 형식은 Skills.skillsbundle/Skills/<이름>/SKILL.md이고 앱 타깃당 번들은 1개입니다. name은 1-64자, description은 한 줄 1,024자 이내, 본문은 10,000자 이내입니다. Siri는 description만 보고 적용 여부를 판단한 뒤 본문을 읽으므로 description이 사실상 호출 조건입니다.

제약도 분명합니다. Agent Skills 형식의 부분집합이라 스크립트와 참조 파일은 지원하지 않습니다. 검증은 실기기나 내부 TestFlight에서 해야 하며 시뮬레이터는 쓸 수 없습니다. 번들에 컴파일 오류가 있으면 앱 스킬 전체가 제공되지 않으므로 스킬을 하나씩 나눠 관리해도 오류는 전체에 영향을 줍니다.

스키마에 맞지 않는 엔터티도 이제 Spotlight 시맨틱 인덱스에서 찾아 보여줄 수 있습니다. 앱 간 동작도 지원하지만, 한 앱의 콘텐츠를 다른 앱으로 옮겨 실행하려면 엔터티가 Transferable을 따라야 합니다. 공유 대상이 될 엔터티는 초기에 이 조건을 넣어두는 편이 나중의 수정 범위를 줄입니다.

SiriKit을 당장 걷어낼 필요는 없습니다. 블로그에서는 폐기로 설명하는 글이 보이지만, SiriKit 문서는 최상위 수준에서 deprecated 표시 없이 “legacy support”로 안내합니다. 다만 새 기능을 쓰려면 App Intents가 필요하니 신규 연동을 SiriKit으로 시작할 이유는 적습니다.

플랫폼끼리 비교하면 가장 큰 차이는 연결 위치입니다. 2026년 11월 7일 기준으로 세 플랫폼 모두 연동 수수료는 확인되지 않았습니다.

항목 Apple Siri AI Google Gemini OpenAI ChatGPT
연결 방식 앱 내 App Intents, 기기에 인덱싱 AppFunctions(Android MCP) 또는 클라우드 MCP 원격 MCP 서버 기반 플러그인
상태 프리뷰, 봄 제출 Connected Apps Platform 프리뷰, 단계적 개방 디렉터리 제출 가이드 공개
조건 Apple Intelligence 기기, 27.3 베타 Android 16 이상, AppFunctions는 실험적 프리뷰 검증된 개인·조직만 제출
수익 규정 약관 미공개 공개 문서에 명시 없음 실물 상품만 거래 가능, 디지털 판매·광고 금지

Google은 Search와 Gemini를 한곳에서 관리하는 플랫폼을 2026년 10월 28일 프리뷰로 열면서 연결 앱이 50개 이상 출시됐다고 밝혔습니다. 스킬 형식은 Agent Skills 부분집합이라 지침 일부를 옮길 수 있습니다. 그러나 도구 정의는 플랫폼별로 따로 만들어야 합니다.


상황별 추천

상황별 추천

스키마에 맞는 표준 기능이 중심인 앱이라면 주요 도메인 13개부터 대조합니다. 맞는 인텐트는 스키마를 채택하고 @AppIntent(.tool)을 붙이지 않습니다. 시간은 스키마 구현보다 엔터티 속성 설명과 인덱싱 범위를 다듬는 데 쓰는 편이 낫습니다.

앱 고유 기능이 핵심인 앱이라면 ToolIntent가 주력입니다. 이때 설명문은 주석이 아니라 Siri의 라우팅 입력으로 다뤄야 합니다. 인텐트, 파라미터, 엔터티 속성마다 title과 description을 채우고, Xcode의 Siri Integration Advisor와 Siri Evaluations 프레임워크(베타)로 회귀 시험을 만듭니다.

서버에만 있어 인덱싱이 어려운 데이터를 다루는 앱이라면 EntityStringQuery를 씁니다. 응답이 오래 걸리면 30초 한도를 먼저 측정하고, 넘을 가능성이 있는 작업만 LongRunningIntent로 분리합니다.

결제·삭제처럼 되돌리기 어려운 동작이 있는 앱이라면 안전 조건을 perform()과 인증 정책에 둡니다. 현재 공개 문서에는 커스텀 동작의 실행 전 사용자 확인 흐름이나 파괴적 동작 표시 API 안내가 보이지 않습니다. 시스템이 대신 막아줄 것으로 가정하지 말고 코드로 방어해야 합니다.

같은 서버 기능을 웹과 여러 AI에 재사용하려는 팀이라면 MCP 계열이 유리합니다. 반대로 기기 안의 개인 맥락과 화면 맥락이 중요한 앱은 애플의 구조가 맞습니다. 두 시장을 모두 노린다면 핵심 로직을 공유 계층으로 분리하고 플랫폼별 도구 정의만 얇게 두는 구성을 검토할 만합니다.

한국어 사용자가 주력인 앱이라면 영어 시험 결과를 그대로 믿지 않는 편이 좋습니다. 한국어는 2026년 10월 26일 27.2에서 추가됐고 Siri AI는 여전히 베타입니다. 한국어 커스텀 인텐트의 인식 품질을 측정한 독립 시험도 공개되지 않았으니 한국어 발화로 직접 평가 세트를 구성해야 합니다.

대상 사용자 범위도 함께 봅니다. 지원 기기는 iPhone 16 전 모델 이후와 iPhone 15 Pro·Pro Max 등입니다. EU의 iOS·iPadOS·watchOS, 중국 본토 계정, 13세 미만은 쓸 수 없으며 EU의 macOS·visionOS는 가능합니다. 프리뷰 지원 OS 4개에 watchOS가 없다는 점도 Apple Watch 중심 앱의 일정에 반영해야 합니다.


자주 하는 실수

자주 하는 실수

첫째, 앱 스킬로 실행 순서를 보장하려는 실수입니다. 애플은 스킬이 여러 동작을 “a single experience”로 결합한다고 설명하지만, 문서에는 “You can’t use app skills to enforce deterministic behavior”라고 적혀 있습니다. 스킬 목록대로 순차 실행되지 않으므로 인증 후 결제처럼 필수 순서는 코드에서 강제해야 합니다.

둘째, 인증 정책 선언만으로 민감한 엔터티가 보호된다고 믿는 실수입니다. 기본값은 인증 없음이고 정책을 따로 선언해야 합니다. 게다가 27.3 베타 릴리스 노트에는 정책을 정의해도 Siri AI가 잠금 해제를 요청하지 않을 수 있다는 알려진 문제(190573761)가 있습니다. 금융·건강 데이터를 다루는 앱은 실기기에서 별도로 시험해야 합니다.

셋째, 베타의 일부 성공 사례를 실제 연동 품질로 일반화하는 실수입니다. Cult of Mac의 2026년 7월 8일 보도에 따르면 iOS 27 베타 3에서 Siri가 Tessie 앱으로 Tesla 배터리를 조회했지만 Tesla 공식 앱으로는 되지 않았습니다. 이 내용은 개발자 게시물을 매체가 전한 것으로, 재현에 실패한 테스터도 있어 지원이 들쭉날쭉해 보인다는 평가가 붙었습니다. 프리뷰 앱을 직접 만들어 측정한 독립 벤치마크도 아직 공개되지 않았습니다.

마지막으로 프리뷰 기간에는 API와 Siri 동작이 바뀔 수 있습니다. 약관과 수수료도 애플은 “More to share soon”이라고만 밝혔습니다. 봄까지는 수익 모델을 확정하지 말고 평가 체계부터 갖추는 순서가 합리적입니다.


정리

시리 AI 앱 연동은 스키마 우선, 부족한 동작만 ToolIntent, 조합은 앱 스킬, 안전 조건은 코드라는 순서로 설계하면 됩니다. 2026년 11월 7일 기준으로 프리뷰 빌드는 내부 TestFlight와 개발 서명 환경에서만 동작하고, App Store 제출은 봄으로만 안내돼 있습니다. 지금은 기능을 층별로 분류하고 설명문을 다듬은 뒤, 실기기와 한국어 발화로 회귀 시험을 만들면 됩니다.

구현 수단은 Siri가 찾을 수 있는가, 맞게 고르는가, 틀려도 안전한가 세 가지를 기준으로 고르면 됩니다.



함께 보면 좋은 제품

위 링크는 제휴 링크이며, 제품 선택은 독자의 판단입니다.

참고 자료

조사 기준일: 2026년 11월 07일

본문의 수치는 아래 자료에서 확인한 것입니다. 제조사 공식 자료(T1)와 전문 매체 실측(T2)을 구분해 표기했습니다. 가격·공급 상황은 변동이 크므로 기준일 이후의 값은 다시 확인해야 합니다.

공식 자료 (2026-11-07 확인)
– Siri AI is now open to all developers: https://developer.apple.com/news/?id=gdk2umrf
– Siri AI Developer Preview: https://developer.apple.com/documentation/appintents/siri-ai-developer-preview
– Bringing custom actions and content to Siri: https://developer.apple.com/documentation/appintents/bringing-custom-actions-and-content-to-siri
– Orchestrating complex actions with app skills: https://developer.apple.com/documentation/appintents/orchestrating-complex-actions-with-app-skills
– App schema domains: https://developer.apple.com/documentation/appintents/app-schema-domains
– SiriKit: https://developer.apple.com/documentation/sirikit
– iOS & iPadOS 27.3 Beta Release Notes: https://developer.apple.com/documentation/ios-ipados-release-notes/ios-ipados-27_3-release-notes
– WWDC26 세션 240: https://developer.apple.com/videos/play/wwdc2026/240/
– WWDC26 세션 345: https://developer.apple.com/videos/play/wwdc2026/345/
– What’s new in iOS 27: https://developer.apple.com/ios/whats-new/
– Apple Newsroom 2026-06-08: https://www.apple.com/newsroom/2026/06/apple-aids-app-development-with-new-intelligence-frameworks-and-advanced-tools/
– Apple Newsroom 2026-09-14: https://www.apple.com/newsroom/2026/09/siri-ai-a-profoundly-more-capable-and-personal-assistant-is-here/
– Apple Newsroom 2026-10-26: https://www.apple.com/newsroom/2026/10/siri-ai-is-available-in-more-languages-starting-today/
– How to get Siri AI: https://support.apple.com/en-us/127893
– About iOS 27 Updates: https://support.apple.com/en-us/149076
– Apple Developer Releases: https://developer.apple.com/news/releases/
– AppFunctions 개요: https://developer.android.com/ai/appfunctions
– Connected Apps 관리 문서: https://developer.android.com/ai/appfunctions/create-manage-connected-apps
– Android Developers Blog 2026-05-26: https://android-developers.googleblog.com/2026/05/android-ai-intelligence-system.html


코멘트

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다