# Chrome で Beeuni を使う

セッションにブラウザーを接続し、アクセス範囲を自分で選択します。

Canonical page: https://beeuni.ai/docs/ja/connect/chrome

Beeuni の拡張機能を使うと、セッションからブラウザーのページを開き、ログイン済みのサイトを操作できます。実験的な機能で、管理者が Beeuni 独自の拡張機能を設定した環境にのみ表示されます。Chrome ウェブストアではまだ一般公開していません。管理者から承認済みの拡張機能パッケージとインストール手順を入手してください。

## ブラウザーを接続する

1. 使用するブラウザープロファイルに、管理者から受け取ったパッケージをインストールします。
2. Beeuni の **設定 → Chrome の Beeuni** を開き、**接続** を選びます。拡張機能から求められたら、自分の Beeuni アカウントでログインします。
3. アクセス方式とタブの範囲を選びます。セッションが使用している間は、ブラウザーを開いたままにしてください。

接続はログインした本人に属します。共有コネクターアカウントは作成されず、ほかのメンバーのブラウザー一覧にも表示されません。サイトのパスワードや Cookie を Beeuni に貼り付ける必要はありません。ただし、エージェントは許可されたタブの内容を読み、サイトにログインした状態で操作できます。作業に必要なタブだけを許可してください。

## アクセスを選ぶ

- **Ask first**：接続要求が Chrome に表示されます。このセッションのみ、またはこのプロジェクトの接続条件を満たすセッションを許可するか、拒否できます。
- **Without asking**：接続条件を満たすセッションは、再確認なしで接続できます。
- **Off**：新しい接続要求を拒否します。

拡張機能では、既定の **All tabs** は各ブラウザーウィンドウのタブを対象にします。**Only tabs it opens** を選ぶと、アクセス対象をそのセッションが開いたタブに制限します。Beeuni の Web 設定では、それぞれ **すべてのタブ**、**セッションが開いたタブのみ** と表示されます。Chrome の内部ページ、拡張機能のページ、Chrome ウェブストアにはアクセスできません。

## 作業と停止

接続したブラウザーを使うよう、エージェントに依頼します。タブグループに対応するブラウザーでは、セッションのタブがグループにまとめられます。ページ上の **Take over** はエージェントの入力を一時停止し、**Stop** はその接続を終了します。停止後に再試行を依頼するのは、再びアクセスを許可する場合だけにしてください。

セッションのターミナルでも操作できます。

```sh
beeuni chrome use
beeuni chrome status
beeuni chrome release
```

`release` を実行しても、ウェブサイトからはログアウトしません。拡張機能の設定にある **Disconnect this browser** は、Beeuni との接続を取り消します。再度使うには接続し直してください。

## デプロイ設定

管理者は Beeuni 独自の拡張機能 ID を使います。

- API：`BEEUNI_CHROME_ENABLED=true` と `BEEUNI_CHROME_EXTENSION_ID` を設定します。
- Web：`NEXT_PUBLIC_BEEUNI_EXTENSION_ID` に同じ ID を設定し、再ビルドします。

Chrome 用のデータベース移行を適用し、Chrome ブリッジを含む新版の API、Web アプリ、セッション実行環境をデプロイします。分離環境のイメージに古い実行環境が残っている場合は、イメージも更新してください。環境変数だけでは古いイメージにブリッジは追加されません。プロジェクト側でも Chrome 機能を有効にする必要があります。有効な拡張機能 ID が設定されていない場合、プラットフォームは機能を無効に保ちます。