> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Tess no Chrome

> A Tess opera o navegador em que você já está logado: abre a página, lê a tela, clica, preenche e traz o arquivo para o chat.

**Tess no Chrome** é a extensão **Tess Browser Use**. Com ela conectada, o chat age no navegador em que a sua sessão já está aberta. O pedido vira ação na página: abrir, ler, clicar, escrever, rolar, baixar e enviar arquivo.

O login continua o seu. A Tess usa essa sessão no portal do cliente, no admin interno, na fila de chamados ou na planilha na web. Um site sem conector na Tess entra nesse mesmo fluxo.

Você acompanha no Chrome. O ícone da extensão fica **Online** enquanto ela escuta o chat, e a lista de atividade mostra cada passo. **Disconnect** interrompe na hora.

> [!NOTE]
>
> A extensão está em beta. Deixe o navegador aberto, com a extensão online, no mesmo workspace do chat.

## Em quais navegadores

A instalação é pela Chrome Web Store. Funciona no **Chrome** e em outros navegadores Chromium que aceitam essa loja, como **Brave** e **Edge**. Firefox e Safari ficam de fora.

## Quem configura

| O que | Quem |
| - | - |
| Instalar, entrar, escolher o workspace e ligar no chat | Cada pessoa, no próprio navegador |
| Usar a extensão naquele workspace | Quem tem a extensão liberada no plano ou no papel. Sem isso, a tela avisa que a Tess no Chrome está indisponível |
| Domínios permitidos e bloqueados do workspace | Quem edita as configurações do workspace |
| Regra que vale por cima da lista do workspace | A política da plataforma, quando houver uma |

## O que você passa a delegar

> [card] A sessão que você já tem
>
> A Tess consulta, preenche e responde dentro do site em que você já entrou. A sessão fica no seu navegador. O chat recebe o que a página mostra e o que você pediu para fazer.

> [card] Site sem conector
>
> Um admin antigo, um portal de cliente ou uma ferramenta interna passam a ser um pedido no chat, do mesmo modo que uma página pública.

> [card] Arquivo nos dois sentidos
>
> Um PDF ou CSV da página entra na conversa. Um arquivo que já está na conversa sobe num campo de upload da página.

> [card] Uma aba que você vê
>
> O trabalho acontece num grupo de abas daquela conversa. As suas outras abas ficam fora desse grupo. Em login ou captcha, a Tess para e diz o que está impedindo.

## Instalar e conectar

**1. Instale a Tess Browser Use**

Abra a [Chrome Web Store](https://chromewebstore.google.com/detail/tess-browser-use/kmbnaabmlpnphohapalahaedkmihkppa) e adicione a extensão.

**2. Entre com a sua conta Tess**

Clique no ícone da extensão e escolha **Sign in with Tess**. A Tess abre o login habitual (e-mail, Google ou SSO). Depois de entrar, você volta para a extensão. Não há token para copiar.

**3. Escolha o workspace**

A Tess só age no workspace selecionado. Se quiser, dê um apelido a este navegador, por exemplo "Notebook do trabalho", para reconhecê-lo na conta.

**4. Salve e conecte**

Use **Save and connect**. O status passa para **Connected — Online**. A extensão passa a escutar os comandos desse workspace.

Se o workspace não tiver acesso à extensão, a tela de configuração avisa. Peça a liberação ao administrador do workspace.

## Usar no chat

**1. Abra um chat no mesmo workspace**

O workspace do chat e o da extensão precisam ser o mesmo. Se a extensão estiver em outro, o chat pede para trocar e conectar de novo.

**2. Ligue a Extensão do Navegador**

No compositor, abra o **+**, entre em **Conectores** e ligue **Extensão do Navegador**. O item aparece com o selo **Beta**.

**3. Diga o site e o resultado**

Inclua o endereço, o que olhar e o que devolver. Exemplo: "Abra [https://admin.exemplo.com/pedidos](https://admin.exemplo.com/pedidos), filtre os atrasados desta semana e me devolva uma tabela com número, cliente e data."

**4. Deixe o navegador aberto**

A Tess abre ou reutiliza uma aba, olha a página e segue um passo de cada vez. O popup da extensão lista a atividade.

> [!TIP]
>
> Na primeira vez, peça uma leitura. Na mensagem seguinte, peça a ação. Por exemplo: "Preencha o formulário de reembolso com estes campos e pare na tela de revisão."

Se o agente dessa conversa não permite ferramentas, o item fica desabilitado e o compositor explica que a configuração do agente bloqueou o uso.

### Pedidos para a primeira sessão

* "Abra esta página de status e me diga quais serviços estão degradados agora."
* "No painel, baixe o CSV de uso do mês e aponte as contas que caíram mais de 20%."
* "Responda o chamado 441 com este texto e envie."
* "Suba este arquivo da conversa no campo de anexo e me mostre a tela depois do upload."

## O que a Tess faz na página

| Você pede | A extensão faz |
| - | - |
| Abrir um endereço | Navega na aba dessa conversa |
| Ler a página | Observa a área visível e, quando precisa clicar ou citar um trecho, lê o conteúdo |
| Clicar ou escrever | Age no elemento que acabou de identificar |
| Página longa | Rola e observa de novo |
| Mais de uma página | Abre outra aba no mesmo grupo e pode fechá-la depois |
| Arquivo na página | Traz o arquivo para a conversa |
| Arquivo da conversa | Envia para um campo de upload da página |

## Quais sites ela pode abrir

Quem edita as configurações do workspace faz isso no modal de **Configurações**, não na extensão.

**1. Abra Configurações**

Clique no seu nome, no canto da tela, e escolha **Configurações**.

**2. Entre em Workspace**

Na barra lateral, no grupo **Workspace**, clique em **Workspace**.

**3. Role até o cartão da extensão**

O cartão **Política de domínios da extensão do navegador** fica no fim dessa tela, depois de **Configurações do Perfil** e **Perfis Sociais**. Lá estão **Domínios permitidos** e **Domínios bloqueados**. **Gerenciar domínios individualmente** abre a mesma lista, um domínio por vez.

Quem não edita as configurações do workspace vê esses campos desabilitados.

* **Domínios permitidos.** Se a lista tiver algum domínio, a extensão só age nesses domínios e nos subdomínios. `exemplo.com` cobre `exemplo.com` e `www.exemplo.com`. Não cobre `meu-exemplo.com`.
* **Domínios bloqueados.** Esses sites ficam de fora. Um domínio nas duas listas permanece bloqueado.
* A política geral da plataforma prevalece sobre a lista do workspace.

Alguns destinos já nascem bloqueados: páginas locais, telas de login de conta Google e Microsoft, e superfícies de pagamento como PayPal e Stripe.

## Quando algo trava

* **Sessão expirada.** Abra as configurações da extensão e entre de novo com a Tess.
* **Extensão desatualizada.** O popup pede atualização. Atualize pela Chrome Web Store e conecte outra vez.
* **Salvou e continuou offline.** Na configuração, use **Save and reconnect**.
* **O chat não mexe no navegador.** Confira três pontos: status **Online**, o mesmo workspace no popup e no chat, e **Extensão do Navegador** ligada no compositor.
* **Login ou captcha na página.** A Tess para e descreve o bloqueio. Resolva na aba e peça para continuar.
* **Trocar de conta.** Nas configurações da extensão, use **Switch account**. Para interromper na hora, abra o popup e escolha **Disconnect**.

Dúvidas: [suporte@tess.im](mailto:suporte@tess.im).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.