Siriとショートカット

macOS、iPad、iPhone、Apple Vision Proで、Siriや「ショートカット」AppからCalíopeを操作します。

Calíopeには、システムの「ショートカット」AppとSiriから使える4つのAppインテントのアクションがあり、macOS、iPad、iPhone、Apple Vision Proで使えます。

使えるアクション：
- 「サーバに接続」 — 選んだサーバのプロファイルに接続します。
- 「SQLクエリーを実行」 — アクティブなセッションでSQLを実行し、結果を返します。
- 「データベースを一覧表示」 — アクティブなセッションで使えるデータベースの一覧を返します。
- 「パネルを開く」 — ワークスペースの9つのパネルのどれにでも直接移動します。

見つけ方：
「ショートカット」Appを開いて新しいショートカットを作成し、アクションのパネルで*Calíope*を検索します。4つのアクションがまとめて表示されます。

重要な条件：
アクションを使うには、ショートカットの実行時にCalíopeが開いていてアクティブである必要があります。バックグラウンドで自動実行されるスケジュールされたショートカットは、パスワードを読むためにシステムのキーチェーンにアクセスできません。そのため、ユーザが手動で起動したとき（Siri、ウィジェット、ショートカットのボタンなど）にだけ動作します。

キーワード： Siri、ショートカット、Appインテント、オートメーション、音声、アクション

音声のフレーズでCalíopeを開き、接続を確立します。

場所： Siri / ショートカット › アクション：サーバに接続

「サーバに接続」アクションは、接続マネージャを開かずに、選んだプロファイルにCalíopeを接続します。

Siriのフレーズ：
「Calíopeで[プロファイル名]に接続」
「Calíopeで接続」

Siriがフレーズの中のプロファイルを認識できないときは、保存されているすべてのプロファイルの選択肢を表示します。

アクションが行うこと：
1. 選んだプロファイルをローカルストレージから読み込みます（ユーザにパスワードを求めません）。
2. システムのキーチェーンから資格情報を取り出します。デバイスはすでにロック解除されているので、アクセスできます。
3. 接続を確立します。
4. アクティブなワークスペースとともにCalíopeを前面に出します。

パラメータ：サーバのプロファイル — Calíopeに保存されているすべてのプロファイルの選択肢。

Calíopeが開いていない場合：Siriは「このショートカットを使うにはCalíopeを開いてください」というメッセージを表示し、バックグラウンドでキーチェーンにアクセスしようとはしません。

キーワード： 接続、Siri、ショートカット、プロファイル、サーバ、音声

アクティブなセッションでSQLを実行し、結果をテキストで受け取ります。

場所： Siri / ショートカット › アクション：SQLクエリーを実行

「SQLクエリーを実行」アクションは、アクティブなCalíopeのセッションにSQL文を送り、結果をプレーンテキストで返します。ショートカットの後続のステップでそのまま使えます。

Siriのフレーズ：
「Calíopeでクエリーを実行」
「Calíopeでデータベースを照会」

パラメータ：SQL — 実行するクエリー。ショートカットの前のステップの出力（たとえば、Calíopeの「AIアシスタント」が生成したテキストや、手で入力したテキスト）を受け取れます。

結果の形式：
- SELECT：タブ区切りの値で、1行に1つの行。最初の行には列名が入ります。
- INSERT / UPDATE / DELETE：影響を受けた行数を示すテキスト。
- エラー：ショートカットはサーバのメッセージ付きのエラーを投げ、ショートカットのエラー処理の設定に従って止まるか続行します。
- 環境タグ付きの接続：タグが書き込み前の確認を求める場合、Siriは確認できないので、書き込みは実行されず、ショートカットはエラーを投げずに確認が必要だと答えます。読み出し専用のタグでは、ショートカットはエラーを投げます。読み取りはどの場合も通ります（トピック「環境タグ」を参照）。

便利なショートカットの例：
1. クエリーSELECT table_name FROM information_schema.tables WHERE table_schema = 'my_db'を入れた「テキスト」アクション
2. Calíopeの「SQLクエリーを実行」アクション
3. テーブルの一覧を得るための「テキストを分割」アクション（区切り：改行）
4. 「結果を表示」アクション

条件：Calíopeにアクティブなセッション（すでにサーバに接続しているもの）が必要です。リレーショナルでないセッションでは、ショートカットはそのセッションでは使えないと答えます。

キーワード： 実行、クエリー、SQL、ショートカット、結果、SELECT、自動化

アクティブなセッションのデータベースの一覧を取得して、ほかのステップで使います。

場所： Siri / ショートカット › アクション：データベースを一覧表示

「データベースを一覧表示」アクションは、アクティブなサーバに問い合わせ、アクセスできるすべてのデータベースの名前を改行で区切って返します。

Siriのフレーズ：
「Calíopeでデータベースを一覧表示」
「Calíopeにはどんなデータベースがありますか？」

結果：1行に1つのデータベースを並べたテキスト。「ショートカット」の「テキストを分割」アクションと組み合わせると、繰り返し処理できる一覧になります。

便利なショートカットの例：
1. Calíopeの「データベースを一覧表示」アクション
2. 「テキストを分割」アクション（区切り：改行）
3. ユーザにデータベースを選んでもらう「リストから選択」アクション
4. SHOW TABLES IN [選択した結果]を指定したCalíopeの「SQLクエリーを実行」アクション

条件：Calíopeにアクティブなセッション（すでにサーバに接続しているもの）が必要です。リレーショナルでないセッションでは、ショートカットはそのセッションでは使えないと答えます。

キーワード： 一覧、データベース、ショートカット、Siri、表示、利用可能

Siriのフレーズで、9つのパネルのどれにでも直接移動します。

場所： Siri / ショートカット › アクション：パネルを開く

「Calíopeでパネルを開く」アクションは、アプリを前面に出して選んだパネルをアクティブにします。タブバーを手で移動する必要はありません。

Siriのフレーズ：
「Calíopeで[パネル]を開く」
「Calíopeの[パネル]を表示」

使えるパネル：

フレーズの例：
「Hey Siri、Calíopeでダッシュボードを開く」
「Hey Siri、Calíopeのバックアップを表示」

条件：Calíopeにアクティブなセッション（すでにサーバに接続しているもの）が必要です。リレーショナルでないセッションでは、ショートカットはそのセッションでは使えないと答えます。Calíopeが開いていなければ、Siriは「このショートカットを使うにはCalíopeを開いてください」というメッセージを表示します。

キーワード： 開く、パネル、ダッシュボード、バックアップ、ユーザ、プロセス、ログ、スニペット、AI、Siri、ショートカット、移動、ワークスペース

Calíopeのアクションを組み合わせて、ワークフロー全体を自動化します。

Calíopeの4つのアクションは、互いに、またシステムのほかのアクションと組み合わせて、「ショートカット」Appで一連のワークフローを作れます。

例：「おはよう、データベース」

1回タップするだけでサーバに接続し、ダッシュボードを開くショートカットを作ります：

1. Calíopeの「サーバに接続」アクション → 本番環境のプロファイルを選ぶ
2. 「Calíopeでパネルを開く」アクション → *ダッシュボード*を選ぶ

「Calíope本番を開く」と名前を付け、コントロールセンターに追加するか、iPadのホーム画面にウィジェットとして置きます。

例：「テーブルの簡易レポート」

1. Calíopeの「サーバに接続」アクション → プロファイルを選ぶ
2. Calíopeの「SQLクエリーを実行」アクション → SQL：SELECT table_name, table_rows FROM information_schema.tables WHERE table_schema = DATABASE() ORDER BY table_rows DESC LIMIT 10
3. 「結果を表示」アクション

ヒント：ショートカットで「Siriに追加」オプションを有効にすると、独自のフレーズを割り当て、デフォルトのフレーズの代わりにSiriの音声で起動できます。

制限：Calíopeのショートカットは、スケジュールされたオートメーション（時刻、アラーム、場所への到着）では動作しません。ユーザが対話的に起動したときにだけ動作します。

キーワード： 連結、組み合わせ、ショートカット、オートメーション、ワークフロー、Siri、複数、順序

一からショートカットを作らなくても自動的に表示される、定義済みのアクション。

場所： Spotlight › Calíopeのショートカット

「ショートカット」Appから手動で使えるAppIntentのほかに、CalíopeはCaliopeShortcutsを通じて、あらかじめ用意したAppShortcutsの一式を公開しています。何も作らなくても、Spotlightと「ショートカット」Appの「ショートカットの候補」のセクションに自動で表示されます。

呼び出し方
- Spotlight：Spotlightを開き（macOSでは⌘＋スペース、iPadとiPhoneでは下にスワイプ）、ショートカットの名前を入力し始めます：サーバに接続、SQLクエリーを実行、データベースを一覧表示、パネルを開く…。結果に、Calíopeのアイコン付きでショートカットが表示されます。
- Siri：ショートカットに割り当てられたフレーズを話します。デフォルトのフレーズは「Calíopeで接続」「Calíopeでクエリーを実行」などです。
- 「ショートカット」App：Calíopeの項目の中の「Appショートカット」にあり、自分のギャラリーに追加できます。

定義済みのショートカット
1. 「サーバに接続」 — Calíopeを開き、選んだプロファイルに接続します。
2. 「SQLクエリーを実行」 — アクティブなセッションでクエリーを実行します。
3. 「データベースを一覧表示」 — アクティブなセッションのデータベースの名前を返します。
4. 「Calíopeでパネルを開く」 — ワークスペースのパネル（ダッシュボード、カタログ、バックアップなど）に直接移動します。

フレーズのカスタマイズ
- 「ショートカット」Appを開いてCalíopeのショートカットを見つけ、「Siriに追加」ボタンをタップします。そこで自分の言語で独自のフレーズを録音し、Siriに認識させられます。

手動のインテントとの違い
- AppShortcutsは、システムが自動で提案する*パッケージ化された*ショートカットです。
- 単独のAppIntentは、より複雑なショートカットの中に自分でアクションとして追加するものです（「連結したショートカットを作成」を参照）。

キーワード： Appショートカット、組み込みショートカット、Spotlight、Siri、候補、プリインストール、CaliopeShortcuts、カスタムフレーズ、インテント、ギャラリー

保存した各接続は別名やホストでSpotlightから見つけられ、結果を開くとその接続につながります。

Calíopeは保存した各接続を、その別名とホストとともにSpotlightに公開します。ユーザ、ポート、デフォルトのデータベースは公開しません。インデックスはローカルで、デバイスの外には出ません。

結果を開くとCalíopeが開き、その接続で接続します。インデックスは接続が変わるたびにすべて作り直されるので、削除した接続はSpotlightから消えます。

キーワード： Spotlight、検索、接続、別名、ホスト