コンテンツにスキップ

AnySoul Browser Extension

このページは AnySoul browser extension のサポートページです。

この拡張は、AnySoul をあなたが普段使っているブラウザーに接続します。接続すると、browser runtime を有効にしたエージェントが、実際のブラウザーセッション内でページを読み、タブを開いて管理し、明示的なブラウザータスクを実行できるようになります。

  • 拡張を AnySoul アカウントに接続する
  • popup で executor の接続状態を表示する
  • popup を開いたときやブラウザータスク実行時に現在のページ状態を読む
  • AnySoul にタブのオープン、切り替え、グループ化、移動、クローズをさせる
  • click、type、scroll、wait、extract などの明示的なブラウザー操作を使う
  • 実行中タスクの停止、最近のタスク確認、サイトアダプター管理を行う
  • X、Reddit、YouTube などの高リスクサイトで追加確認を求める
  • 独立したブラウザープロファイルは作成しません。現在のブラウザー identity をそのまま使います。
  • デスクトップ専用の semantic_actsemantic_extract は現在サポートしていません。
  • 閲覧データを販売したり、cookie、パスワード、session token を製品データとして書き出したりはしません。

1. 拡張をインストールして接続する

Section titled “1. 拡張をインストールして接続する”

AnySoul browser extension をインストールし、popup を開いて AnySoul アカウントでサインインしてください。

2. エージェントで browser runtime を有効にする

Section titled “2. エージェントで browser runtime を有効にする”

AnySoul で Agent Settings -> Browser を開き、使いたいエージェントで browser runtime を有効にします。

3. 現在の run mode で browser tools を有効にする

Section titled “3. 現在の run mode で browser tools を有効にする”

Run Mode エディタを開き、browser tools も有効にしてください。

この 2 段階の両方が必要です。

  • エージェント側で browser runtime が許可されていること
  • 現在の run mode が browser tools を公開していること

4. まずは明示的なブラウザータスクから始める

Section titled “4. まずは明示的なブラウザータスクから始める”

拡張経路は、次のような決定的なフローに向いています。

  • ページを開く
  • ページを読む
  • 対象をクリックまたはフォーカスする
  • テキストを入力または貼り付ける
  • 次の状態を待つ
  • 結果を抽出する

デスクトップの semantic browser actions が必要な場合は、Browser Runtime ガイドのデスクトップ経路を使ってください。

権限用途
activeTab拡張を呼び出したときに現在のページを読む
storageローカル認証状態、device ID、管理タブ状態、アダプター設定、言語を保存する
tabsブラウザータスクで使うタブを開く、切り替える、移動する、再読み込みする、閉じる
tabGroupsAnySoul 管理タブをグループ化して見やすく保つ
scriptingページ状態を読み、明示的なブラウザー操作を行う
<all_urls>AnySoul に使わせるサイト上でブラウザータスクを動かせるようにする
  • browser runtime を使うと、拡張はページ URL、タイトル、本文、DOM 状態、タスク結果を処理する場合があります。
  • 拡張は接続状態、device ID、管理タブ記録、アダプター設定、言語などの少量のローカル状態を browser extension storage に保存します。
  • 拡張認証やブラウザータスク結果の返却に必要なデータは AnySoul サービスへ送信されます。
  • ストア掲載で使う正式なポリシー URL は Extension Privacy Policy です。

AnySoul 側で browser tools がロックされたまま

Section titled “AnySoul 側で browser tools がロックされたまま”

次をすべて確認してください。

  • 拡張が接続済みでオンラインになっている
  • 現在のエージェントで browser runtime が有効
  • 現在の run mode で browser tools が有効
Section titled “Popup でサイト未許可と表示される”

ブラウザー側でサイトアクセスが制限されている可能性があります。popup から現在サイトを許可するか、ブラウザーの拡張権限設定を調整してください。

拡張は接続済みなのに semantic browser actions が出ない

Section titled “拡張は接続済みなのに semantic browser actions が出ない”

これは想定どおりです。拡張ランタイムは現在、明示的なブラウザーアクションのみをサポートしています。semantic actions が必要ならデスクトップアプリを使ってください。