# Beeuni no Chrome

Permita que uma sessão use seu navegador com o acesso que você escolher.

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

O Beeuni no Chrome pode abrir páginas e usar sites nos quais você já está conectado. É uma função experimental e só aparece quando o administrador configura uma extensão própria do Beeuni. Ainda não há uma versão pública na Chrome Web Store. Peça ao administrador o pacote autorizado e as instruções de instalação.

## Conectar um navegador

1. Instale o pacote no perfil de navegador que deseja usar.
2. Abra **Configurações → Beeuni no Chrome** e escolha **Conectar**. Quando a extensão solicitar, entre com sua própria conta Beeuni.
3. Escolha o modo de acesso e o alcance das abas. Mantenha o navegador aberto enquanto a sessão o utiliza.

A conexão pertence à pessoa que faz login. Ela não cria uma conta de conector compartilhada: os outros membros não veem seu navegador na lista deles. Não é necessário colar senhas ou cookies dos sites no Beeuni. Mesmo assim, o agente pode ler o conteúdo das abas permitidas e realizar ações usando seu login no site. Limite o acesso ao que a tarefa precisa.

## Escolher o acesso

A extensão mostra as opções em inglês:

- **Ask first**: o Chrome exibe uma solicitação. Você pode permitir esta sessão, permitir as sessões autorizadas deste projeto ou negar.
- **Without asking**: as sessões autorizadas podem se conectar sem outra solicitação.
- **Off**: novas conexões são recusadas.

**All tabs** é o alcance padrão e inclui as janelas do navegador. **Only tabs it opens** limita o agente às abas da própria sessão. Páginas internas do Chrome, páginas de extensões e a Chrome Web Store não são acessíveis.

## Trabalhar e parar

Peça ao agente para usar o navegador conectado. As abas dele aparecem em um grupo da sessão quando o navegador permite grupos. **Take over** pausa as entradas do agente; **Stop** encerra aquela conexão. Após parar, peça uma nova tentativa somente se quiser autorizar o acesso novamente.

Você também pode usar o terminal da sessão:

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

`release` não encerra seus logins nos sites. **Disconnect this browser**, nas configurações da extensão, revoga a conexão com o Beeuni. Para usá-lo novamente, conecte-o de novo.

## Configuração do deploy

O administrador deve usar o ID da própria extensão Beeuni:

- API: defina `BEEUNI_CHROME_ENABLED=true` e `BEEUNI_CHROME_EXTENSION_ID`.
- Web: atribua o mesmo ID a `NEXT_PUBLIC_BEEUNI_EXTENSION_ID` e faça uma nova compilação.

Aplique a migração de banco de dados do Chrome e publique as versões atualizadas da API, do site e do ambiente de sessão com a ponte do Chrome. Atualize também a imagem do ambiente isolado se ela contiver uma versão anterior. Uma variável não adiciona a ponte a uma imagem antiga. O projeto também precisa ter a função Chrome ativada. Sem um ID de extensão válido, a plataforma mantém a função desativada.