Karuiアプリアイコン

KN002:ショートカット経由でアプリからPrivate Cloud Computeを利用する

Karui

KaruiのPrivate Cloud分類が、ユーザーのショートカット経由でAppleのPrivate Cloud Computeに問い合わせる仕組みと、それを使った通知のモード。

2026年9月28日 · iOS 27.0 · iPhone 17 Proで計測

概要

Karuiは、iOS 27の新しい通知トリガーを使った、プライベートなiPhone向けの通知フィルターです。バックグラウンドで動作している間は、オンデバイスモデルにレート制限がかかります(技術ノートKN001を参照)。そのような場合、KaruiはPrivate Cloud Computeに問い合わせることができます。リクエストを送るのはKaruiではなく、ユーザーのショートカットの「モデルを使用」アクションです。Karuiはプロンプトを用意し、回答を反映します。

往復の流れ

  1. ショートカットのオートメーションが、通知ごとにKaruiの分類用App Intentを実行します。
  2. インテントが通知を分類し、履歴の項目ID、セカンドオピニオンを求めるフラグ、作成済みのプロンプトを含むエンティティを返します。
  3. フラグが立っていれば、ショートカットがそのプロンプトでPrivate Cloud Computeの「モデルを使用」を実行します。
  4. ショートカットがIDとモデルの回答を2つ目のインテントに渡し、分類を更新します。回答が「重要」ならユーザーに通知します。

ショートカットが読み取るのは、エンティティの次のプロパティです。

struct TriageOutcomeEntity: TransientAppEntity {
    @Property(title: "Record ID")
    var recordID: String?

    @Property(title: "Wants Second Opinion")
    var wantsSecondOpinion: Bool

    @Property(title: "Second Opinion Prompt")
    var secondOpinionPrompt: String?
}

回答の読み取り

「モデルを使用」はプレーンテキストを返すため、プロンプトでは次の3行だけを求めます(期限リマインダーがオンの場合は、やることと期日を加えた5行)。

Category: Important, Neutral, or Spam
Confidence: a number from 0.0 through 1.0
Reason: the reason, in at most 20 words

それでもパーサーは、余分な言葉、欠けた行、日本語で書かれたラベルを許容します。ラベル付きの行がなければ、回答の中で最初に現れる分類の語で判定します。

問い合わせのタイミング

Private Cloud分類の回答には、Karuiが直接問い合わせてもショートカット経由でも2〜3秒かかるため、「問い合わせのタイミング」には2つの選択肢があります。

どちらのモードでも、重要な連絡先からのメッセージ、自分へのメンション、ワンタイムコードなど、ルールですでに判断した通知については問い合わせません。緊急アラームが回答を待つこともありません。

「お知らせする前に」では、保留中の通知は、既知の識別子を付けて20秒後に予約したローカル通知です。Karui自身の呼び出しかショートカットの2つ目のインテントから回答が届くと、Karuiはまだ配信されていなければそれを取り消し、クラウドが同意した場合だけ通知します。回答が届かなければ、保留中の通知を取り消すものがないため、iOSがそのまま配信します。すでに配信されていてクラウドが同意しなければ、Karuiが削除します。

以前のバージョンには「常に」もあり、すぐに通知してからあとで修正していました。問い合わせが多く、後述するPrivate Cloud Compute自体の上限に達することがあったため、この設定は現在「お知らせする前に」として読み込まれます。

Private Cloud Computeにも上限がある

Appleは、Private Cloud Computeにユーザーごとの1日の上限があり、iCloudアカウント単位で数えられ、iCloud+ではより多く使えることを文書化していますが、上限の大きさは公表していません。Karuiが直面したのは、それとは別の、デバイスごとの短期的な上限のようです。以前の「常に」モードをオンにした2時間分のログでは、Private Cloud Computeは午前7時17分から8時32分までに10件のリクエストに回答し、その後の6件は拒否されました。理由はショートカット自体のログに記録されています。

InferenceError::rateLimited::PrivateCloudComputeError: deniedDueToUserDeviceRateLimit

拒否された「モデルを使用」ステップでショートカットは止まり、上限が解除されるまで、通知のたびにショートカットが「現在、リクエストを完了できません。」という通知を表示します。通知自体には問題はありません。オンデバイスモデルまたはルールがすでに判定しています。

Karuiにはステップの失敗は見えず、回答が返ってこないことしか分かりません。そこで、30秒たっても回答のないリクエストを失敗とみなし、30分間フラグを立てるのをやめます。失敗が続くたびに停止時間を2倍にし、最長4時間までとします。回答が1件でも届けば停止は終わります。まとめて拒否された場合は1回と数え、「お知らせする前に」では、停止中は届かない回答を待たずにすぐ通知します。

Karui自身の呼び出しはオンデバイスの上限を共有する

Private Cloud Computeのエンタイトルメントがあれば、iOS 27ではアプリがPrivateCloudComputeLanguageModelに直接問い合わせられ、ショートカットを経由せずに済みます。Karuiは2026年10月の1日間、ショートカットと並行してこれを試しました。トリアージインテントからの126件で、ほぼすべてがバックグラウンドでした。

Karuiのオンデバイスモデルがレート制限された直後は、Private Cloud Computeも必ず拒否しました。該当する64件はすべて同じLanguageModelError.rateLimitedで、約13ミリ秒で失敗しており、拒否はAppleのサーバーではなくiPhone側で起きています。そのたびにモデルは利用可能で、クォータも上限未満と報告していたため、どちらからも拒否は予測できません。オンデバイスモデルが制限されていないときは、62件中56件に回答があり、中央値は2.2秒でした。

つまり、アプリ自身によるPrivate Cloud Computeの呼び出しは、オンデバイスモデルと同じバックグラウンドの上限を使っているようです。ショートカットの「モデルを使用」ステップは違います。ショートカット側の上限で動くため、同じ期間に、Karui自身の呼び出しが拒否された通知の半分以上に回答しました。

現在のKaruiは、オンデバイスモデルが直前にレート制限されていないときだけPrivate Cloud Computeに直接問い合わせます。多くの場合、ショートカットの2〜3秒とエラーのバナーを省けます。オンデバイスモデルが制限されていたときや、Karui自身の呼び出しが失敗したときは、これまでどおりショートカットが問い合わせます。

アプリ内からの問い合わせ

Karuiはバックグラウンドでショートカットを実行できないため、やり直しには通知トリガーを使います。Karuiで分類をやり直すと、アプリは項目IDを含む静かな通知を送ります。通知トリガーはKarui自身の通知でも作動するため、ユーザーのオートメーションが実行され、分類のインテントが目印を認識してその項目のプロンプトを返し、あとはショートカットのいつもの手順で処理されます。

送信される内容

プロンプトに含まれるのは、通知の本文とアプリ、それがユーザーの重要なアプリかどうか、ユーザーの名前、ハンドル、ニックネーム、分類用の語句だけです。ルールで判定された通知、連絡先の情報、カレンダーの予定がiPhoneの外に出ることはありません。

改訂履歴

← 技術ノート一覧