QuickAgent - ガイド

QuickAgent ユーザーガイド

QuickAgent はローカルファーストの AI エージェントワークスペースです。目標を永続的な Run に変え、Workspace Profile でその Run の範囲を制限し、慎重を要する操作の前には確認を求め、検証済みの結果を Artifacts に保存します。

使いはじめる

開く 設定 > AIを開いてプロバイダーを追加し、接続テストを実行します。
開く 設定 > Workspace Profiles。使用してよいプロバイダー、ツール、接続先、ファイルのルート、Knowledge のソース、Memory の範囲を選びます。
次を選択します: New Chatを選び、プロファイルを選択して、会話の上部に表示されるプロバイダーの送信先を確認します。
達成したい結果を記述します。この Run に必要なファイル、フォルダー、メディア、Knowledge、Memory だけを追加してください。
計画、承認、Critical の確認、Data Send Preview が表示されたら内容を確認します。
Timeline で作業の進行を確認します。完成した出力は次から開けます: Artifacts から開き、監査証跡は次で確認できます: 履歴.

ヒント: 範囲を絞った Workspace Profile から始めましょう。QuickAgent が具体的な「利用できない理由」を示したときにだけ、ツールやルートを広げてください。

画面の構成

セクション	用途
Chats	会話、プロバイダーの送信先、Context Tray、計画、承認、実行中の Run Timeline。
Runs	計画中、実行中、一時停止中、予約済み、失敗、完了のすべてのタスク。
Approval Inbox	判断が必要な、保留中の操作・Critical・Data Send の確認事項。
Artifacts	Run によって作成された、検証済みのファイル、レポート、ログ、メディア、テーブル、操作マニフェスト。
Automations	スケジュール、モニター、Webhook、アプリのイベント、ショートカット／App Intent のトリガー。
Skills	型付きの入力、許可されたツール、必要な接続、リスク、出力を備えた、再利用可能な指示。
Connections	プロバイダー、ブラウザープロファイル、ファイル／VFS のルート、SSH、MCP、HTTP/SaaS、ホームブリッジ、通知チャネル。
Knowledge	インデックス化したフォルダー、QuickNote の内容、Web クリップ、PDF、Office のファイル。
履歴	追記のみの安全判断、ツールの実行内容、送信先、タイムスタンプ。
設定	外観、言語、AI、ツール、安全設定、Workspace Profiles、ショートカット、権限、ヘルプ、Pro。

プロバイダーと Workspace Profiles

QuickAgent は、OS が対応機能を提供している場合の System AI、Ollama・LM Studio・DeskLLM などのローカルプロバイダー、LAN 上やカスタムの OpenAI 互換エンドポイント、Anthropic や Gemini などの設定済みクラウドプロバイダーを利用できます。利用可否は実際の機能テストで判定されるため、プロバイダー名があるだけで使用可能とは限りません。

Workspace Profile は Run の権限の枠組みです。選択したプロバイダー／モデル、許可されたツール、接続先、ファイルのルート、Knowledge のソース、Memory の範囲、安全設定の上書き、予算をスナップショットとして保持します。後から設定を変更するとスナップショットは古くなり、再確認が必要になります。

送信先のルール: QuickAgent が、端末内やローカルのプロバイダーから黙ってクラウドへ切り替えることはありません。使用中の送信先は Chat と、すべての Data Send の確認画面に常に表示されます。

Run、承認、復旧

Run の操作

一時停止 は、永続的なチェックポイントでの安全な停止を要求します。
再開は、同じ Run と完了済みの作業を引き継いで続行します。
停止はプロバイダーとツールの処理を中止します。停止した処理や結果が不確かな外部への影響が、成功として報告されることはありません。
再試行 は、QuickAgent が安全に再試行できる境界を特定できた場合にのみ利用できます。

安全レベル

レベル	意味
Safe	使用中のプロファイル内での読み取り、確認、変換。
Approve	通常の書き込みまたは外部への操作を確認します。
次を確認してください:	影響が大きい、または元に戻しにくい変更を確認します。
Critical	毎回強い確認を求めます。ルールによって自動承認されることはありません。

承認画面には、正確な対象、送信先、提案された引数、リスク、取り消しの可否が表示されます。引数を編集すると、QuickAgent は編集後の操作を改めて検証し、リスクを判定し直します。

結果が不確かな場合: 処理が中断された後は、まず対象のシステムを確認してください。操作を繰り返しても問題ないと判断できる場合にのみ「確認しました — 再試行」を選んでください。「再開」だけでは、結果が不確かな外部への処理が繰り返されることはありません。

マルチエージェントの Run

複雑な目標では、プランナー、役割別のワーカー、レビュアー、セキュリティレビュアーを使えます。Timeline には引き継ぎ、レビュー、再試行、フォールバック、最終応答の区切りがすべて表示されます。ワーカーが受け取れるのは、Skill のツール、Workspace Profile のツール、役割ごとのツール、現在利用可能なツールの 4 つすべてに共通する範囲だけです。

全体および役割ごとの予算により、呼び出し回数、時間、コスト、ネットワーク転送量、トークン数が制限されます。予算に達すると QuickAgent は一時停止し、現在の上限と提案された上限を表示して、明示的な確認を経た場合にのみ引き上げます。承認された予算と完了した役割の履歴は、再起動後も保持されます。

コンテキスト、Knowledge、AI Memory

Context Tray

ファイル、フォルダー、画像、動画のフレーム、音声、ボイスメモ、QuickNote の内容、Knowledge、Workspace Memory を追加できます。QuickAgent は対応する内容を抽出または要約し、添付がプロバイダーへ直接送信されるかどうかを表示します。

Knowledge

Knowledge のソースはチャットとは別にインデックス化されます。Run が検索できるのは、その Workspace Profile で許可されたソースのみで、引用元の情報も保持されます。

Memory

Memory は自動的なチャット履歴ではなく、意図的に登録するものです。User、Workspace、Project、Tool/Connection の各スコープは分離されています。作成・編集・削除のたびに新たな承認が必要で、承認のプレビューにはスコープと提案された値がそのまま表示されます。

ツールと接続

利用可能なカタログには、ファイル／VFS の操作、Office・PDF・構造化データ、メディアと OCR、ブラウザーとコンピューター操作、開発用コマンド、SSH、MCP、HTTP と SaaS、スマートホームのブリッジ、通知、スケジュール、モニター、自動化の制御が含まれます。接続した MCP サーバーは、スキーマの検証と QuickAgent によるリスクの再評価を経て、動的にツールを追加することがあります。

設定 > Tools には、各ツールが利用可能な理由、または無効になっている理由が表示されます。よくある理由は、接続の未設定、OS の権限、非対応のプラットフォーム、Workspace Profile による制限、未テストのエンドポイント、プロバイダーの機能が利用できないことなどです。

コンピューター操作: 画面キャプチャとアクセシビリティ／入力制御は別々の権限です。表示されるプレビューと緊急停止はいつでも使える状態にしておいてください。モバイル環境では、デスクトップと同じ無制限の操作はできません。

Automations

自動化は、プラットフォームが対応していれば、時刻、ファイル／フォルダー、Web、Webhook、メール、カレンダー、ネットワーク、ホスト、デバイス、センサー、位置情報、アプリのイベント、ショートカット／App Intent、コマンド、手動のいずれかをきっかけに開始できます。トリガーは通常の Run を作成するだけで、Workspace Profile、承認、Critical、Data Send の各チェックを迂回することはありません。

デスクトップでの監視は、アプリのプロセスが動作している間のみ継続します。
モバイル環境では、アプリがフォアグラウンドに戻った時点で、実行時期を過ぎた処理を追いつかせます。
OS レベルでの確実な実行が必要な場合は、ショートカット／App Intent または信頼できるイベント中継をご利用ください。
キューに入ったイベント、一時停止、キャンセル、削除はすべて明示的に扱われるため、イベントが黙って破棄されることはありません。

Skills と Skill Pack

Skill には、結果重視のプロンプト、型付きの変数、推奨プロバイダー、許可されたツール、必要な接続と機能、リスクの上限、想定される Artifacts が保存されます。使用前に QuickAgent が入力内容と実際の権限を表示しますが、このプレビュー自体が権限を付与するわけではありません。

組み込みの 7 つの Pack が、Office、コーディング、スマートホーム、リサーチ、ブラウザー自動化、身のまわりの事務、インシデント対応向けの実用的な Skill を提供します。Skill はインストール、更新、アンインストール、カスタマイズ、複製、読み込み、書き出しができます。読み込んだ JSON には、信頼性、発行者、署名、権限、リスク、プラットフォーム、競合のプレビューが表示されます。「両方を残す」を選ぶと、他の発行者の信頼性を引き継がず、未署名のローカル派生版が作成されます。

Artifacts、履歴、取り消し

Artifacts には、出力データ本体、メタデータ、バージョン、来歴、生成元の Run、操作マニフェストが保存されます。プラットフォームの対応状況に応じて、開く、共有する、書き出す、保存場所を表示するといった操作ができます。対象となる操作では確認付きの取り消しが利用でき、破壊的な処理や結果が不確かな処理が自動的に再実行されることはありません。

履歴は追記のみです。Safe、Approve、Confirm、Critical で絞り込めるほか、外部に記録が必要な場合は監査ログを書き出せます。

設定

一般: 外観、言語、Workspace Profiles、ショートカット、ヘルプ、権限。
AI: プロバイダー、エンドポイント、モデル、認証情報、接続テスト。
ツール: カタログの利用可否、プラットフォームの対応状況、設定が必要な理由。
安全設定: 承認ルール、Data Send の挙動、デバイス認証、スコープ付き Memory のポリシー。
詳細: トラブルシューティング用の復旧機能と診断情報。

キーボードショートカット

macOS では、表示されている Ctrl のショートカットが、適切な場面ではプラットフォームの Command キーに割り当てられます。アプリ内のショートカットページが正式な一覧で、カスタマイズにも対応しています。

ショートカット	操作
`Ctrl` + `N`	New Chat
`Ctrl` + `L`	入力欄にフォーカスする
`Ctrl` + `Shift` + `Space`	実行中の Run を一時停止／再開する
`Ctrl` + `.`	実行中の Run を停止する
`Ctrl` + `1` … `9`	履歴から Chats を開く
`Ctrl` + `,`	設定を開く
`F1`	ヘルプ & プライバシーを開く
`Esc`	ダイアログを閉じる、または現在の非破壊的な操作をキャンセルする

プラットフォームに関する注意

プラットフォーム	重要な制約
macOS	Debug でも Release でもサンドボックス内で動作します。ファイルへのアクセスは、選択したルートとセキュリティスコープ付きブックマークを使用します。画面収録とアクセシビリティは別々のシステム権限です。ローカルプロセスやショートカットの連携は、機能テストを経て利用可否が判定されます。
Windows	ファイル、Office/PDF/データ、ブラウザー、開発、リモート、デスクトップ操作の各機能は、インストール済みのランタイムと権限に依存します。Apple 専用の連携機能は、理由を明示したうえで利用できません。
iPhone / iPad	ファイルはシステムのピッカーを使用します。カメラ、マイク、音声認識、写真、ローカルネットワーク、通知は、必要な場面で許可を求めます。バックグラウンドでの監視は保証されないため、ショートカット／App Intent やフォアグラウンド復帰時の追いつき処理をご利用ください。
Android	ファイルとフォルダーは Storage Access Framework を使用します。バックグラウンド処理は Android の制限に従います。サービスが宣言されているだけでは、アクセシビリティによる入力制御が許可済みとは扱われません。
Web	ネイティブの永続化が必要な機能ではセッション限りのストレージを使用し、非対応のデバイス、ファイルのルート、ローカルプロセス、バックグラウンドの各機能は明示的に無効になります。

ヒント & コツ

範囲を絞った Workspace Profile から始め、Run が具体的な要件を示したときにだけツール、接続先、ファイルのルートを追加しましょう。

リクエストごとに、期待する結果、想定する Artifact、確認の区切りを明確にしておくと、進行状況を追いやすくなります。

繰り返し使うインデックス済みのソースには Knowledge を、その Run だけで必要な素材には Context を使いましょう。

外部への影響が不確かな場合は、再試行の前に送信先を確認してください。「再開」で自動的に繰り返されることはありません。

トラブルシューティング

症状	確認すること
プロバイダーが利用できない	設定 > AI を開いてください。設定内容、認証、モデルの対応状況、エンドポイントへの到達性、タイムアウト、レート制限の詳細を確認し、接続テストを実行します。
ツールが無効になっている	設定 > Tools を開き、表示されている理由を確認してください。現在のプラットフォーム、権限、接続テスト、Workspace Profile、選択中のルートを見直します。
Run が止まっているように見える	Runs と Timeline を開いてください。一時停止中、入力待ち、承認待ち、Critical の確認待ち、Data Send の確認待ち、予算の確認待ちの可能性があります。停止はいつでも行えます。
権限が変更された	ヘルプ > 概要または設定を開き、続いてシステム設定を開いてください。戻ったら、影響を受けた接続やツールを再テストします。
外部への操作の結果が不確か	対象のシステムを確認してください。再試行が適切だと確認できるまでは、Run を一時停止のままにするか停止してください。
自動化がバックグラウンドで実行されなかった	モバイルの OS は任意のタイミングでのポーリングを保証していません。フォアグラウンドに戻して追いつかせるか、ショートカット／App Intent や信頼できるイベントソースを設定してください。
Artifact を開けない／書き出せない	データ本体がまだ残っているか、そのプラットフォームがその操作に対応しているか、選択した保存先の権限がまだ有効かを確認してください。

プライバシー、権限、ライセンス

QuickAgent は会話、Run、承認、Knowledge のメタデータ、Skills、設定をローカルに保存します。認証情報はプラットフォームが保護するストレージを使用します。コンテンツが端末外に出るのは、利用者が設定したプロバイダーや接続済みサービスを経由する場合のみで、外部への送信時には送信先を明示したプレビューが表示されます。

権限は必要な場面で要求されます。ファイル／フォルダー、写真、カメラ、マイク、音声認識、ローカルネットワーク、通知、画面収録、アクセシビリティ／入力制御はそれぞれ独立しています。権限を取り消すと、該当する機能は誤って成功したように見えるのではなく、利用不可になります。

開く 設定 > ヘルプ & プライバシー で現在のプラットフォーム対応表を、 オープンソースライセンス でパッケージと同梱ネイティブライブラリの表示をご確認ください。

Free と Pro: エージェントの機能はすべて Free で利用できます。7 日間のトライアルは広告なしで、その後はモバイルで広告が、デスクトップで 1 日 1 回の通知が表示されることがあります。Pro では、年額サブスクリプションまたは買い切りにより、これらの表示がなくなります。