notis-browser-control

Notis ブラウザー操作スキル

ブラウザーの自動化が必要で、agent-browser でブラウザーを操作するのが適切な場合に、このスキルを使用します。

このスキルは、必要に応じてブラウザー操作のガイドを参照し、Notis 固有のランタイムルールを維持します。

1. ユーザーのコンピューター上でブラウザーを操作する local_shell
2. Cloud Computer 内でブラウザーを操作する sandbox_shell

基本的なランタイムルール

ブラウザーの自動化はシェルのワークフローです。

• ブラウザーを Cloud Computer 内で実行できる場合は、sandbox_shell を使用します。
• ブラウザーをユーザーのコンピューター上で実行する必要がある場合は、local_shell を使用します。
• 画面上で操作するデスクトップ制御へのフォールバックはありません。Agent Browser が必要なローカルブラウザーセッションにアクセスできない場合は、その制限を説明し、サポートされているローカルシェルのブラウザーワークフローを通じてセッションを公開するようユーザーに依頼してください。

ランタイムの選択

ブラウザー操作スキルとローカルの set_shell_mode パスは、Free を含むすべてのプランで利用できます。ローカルパスには、Notis Desktop ブリッジへの接続が必要です。クラウドでの実行には別途、サーバーで認可されたホステッドランタイムが必要です。そのランタイムが利用できない場合も、ローカルパスは利用可能なままにして、返されたランタイムのガイダンスをそのまま提示してください。

次の場合は sandbox_shell を選択します。

• サイトが公開されている、または専用の認証情報でテストできる
• ユーザーのローカルブラウザープロファイル、タブ、Cookie、拡張機能が不要である
• ユーザーの現在のブラウザーセッションよりも、分離性と再現性が重要である
• Web フローのテスト、スクリーンショットの撮影、コンテンツの抽出、または再現可能な QA の実行を行う

次の場合は local_shell を選択します。

• ユーザーの実際のローカルブラウザーの状態が必要である
• ローカル Cookie、ローカル認証、ローカル拡張機能、またはローカルブラウザープロファイルに依存する
• ユーザーのコンピューター上で検出されたプロファイルを使用する必要がある
• 分離されたサンドボックスではなく、ユーザーのコンピューター上でブラウザー操作を行う必要がある

ローカルとサンドボックスのブラウザー操作の違い

ローカルシェルでのブラウザー操作：

• ユーザーの実際のコンピューター上で実行されます
• 永続的な ~/.notis-agent-browser/main プロファイルを使用します
• 実行をまたいで Cookie と保存済みの状態を再利用します
• Notis のデスクトップシェルブリッジへの接続が必要です

サンドボックスシェルでのブラウザー操作：

• 分離された Cloud Computer 内で実行されます
• 実行ごとに Cookie がない状態で開始します
• ユーザーの実際のブラウザープロファイル、ホストのキーチェーン、ローカル Cookie、ローカルタブ、ローカル拡張機能にはアクセスできません
• Notis への認証には Portal のサインインリンクツールを使用できます。それ以外のサイトでは、1Password Service Account のフロー、タスクごとの認証情報、またはプロビジョニング済みの状態を使用します
• 一般的な Web 自動化で、より安全かつ再現性に優れています
• 再現可能な QA、スクレイピング、スクリーンショット、公開アプリのテストでは、デフォルトで使用します

アンチパターン

• アドホックなプロファイルパスを独自に作成しないでください。すべての Notis の実行で ~/.notis-agent-browser/main を使用します。
• --profile を指定せずに agent-browser コマンドを実行しないでください。デーモンが別の空のプロファイルで暗黙に再起動することがあります。
• 自動化の実行終了時、またはユーザーのサインイン直後に、agent-browser state save を省略しないでください。
• ユーザーの実際の Chrome プロファイルを操作したり、デフォルトのプロファイルをコピーしたり、メインブラウザーに対して 9222 で接続したりしないでください。Chrome 136 以降ではいずれにせよブロックされ、ユーザーのアクティブなセッションを危険にさらします。
• サンドボックスブラウザーがローカルの認証状態にアクセスできると想定しないでください。
• CLI を使用する前に agent-browser skills get core --full を実行してください。

ブラウザーを起動する前にプロファイルと状態について確認し、標準のプロファイルと最後の状態保存を維持してください。その後、ローカルまたはサンドボックスのガイドを読み込みます。デフォルトで両方を読み込まないでください。汎用的な例を不必要に読み込むのではなく、ライブ CLI ヘルプでコマンド構文を確認してください。

タスクガイド

このスキルバンドルから、このタスクに必要なガイドのみをお読みください。

• 認証が必要な Notis Spaces、レポート、ドキュメントについては、notis-spaces スキルにある共通の閲覧ガイドをご利用ください（ホストされたガイド：notis://docs/notis-spaces/references/reading.md）。Notis のサインインリンクはサンドボックス内でも機能し、ローカルの Cookie や認証情報は必要ありません。
• 埋め込み型エージェントブラウザースキル
• Notis の正規プロフィールと状態の永続化
• ローカルシェルによるブラウザー制御
• サンドボックスシェルによるブラウザー制御