Page Assist na prática: quatro fluxos de trabalho cotidianos no navegador com modelos locais e na nuvem

AIHubMix9 min de leitura
Page Assist na prática: quatro fluxos de trabalho cotidianos no navegador com modelos locais e na nuvem

A maioria das ferramentas de IA para chat fica em uma aba própria. Você copia um texto da página, cola em uma janela de chat e copia a resposta de volta. Page Assist elimina esse vai e volta: é uma extensão de navegador de código aberto que abre um modelo em uma barra lateral ao lado da página que você está lendo, além de uma interface web em tela cheia para conversas mais longas.

Ele começou como uma interface para modelos locais executados no Ollama, e essa ainda é a opção padrão. Mas ele também aceita qualquer endpoint compatível com a OpenAI, o que significa que a mesma barra lateral pode alternar entre um modelo pequeno no seu notebook e um modelo de fronteira na nuvem. Este guia percorre quatro fluxos de trabalho que as pessoas realmente usam e, para cada um, indica quais recursos ativar e se um modelo local ou na nuvem é mais adequado.

Page Assist em resumo

Os números abaixo vêm do repositório no GitHub e da página da Chrome Web Store, em 8 de outubro de 2026.

  • Licença e custo: MIT, gratuito. Desenvolvido por um desenvolvedor independente (n4ze3m) com contribuições da comunidade.
  • Adoção: cerca de 8.200 estrelas no GitHub; 300.000 usuários e avaliação 4.8 na Chrome Web Store.
  • Ritmo de lançamentos: semanal. A versão 1.5.86, lançada em 8 de outubro de 2026, adicionou a AIHubMix à lista de provedores predefinidos.
  • Navegadores: Chrome, Brave, Edge, Vivaldi, Firefox, LibreWolf, Zen. Opera e Arc recebem a interface web, mas não a barra lateral.
  • Privacidade: sem telemetria. O histórico de chat, as configurações e os embeddings da base de conhecimento ficam armazenados no navegador.

Instale pela Chrome Web Store (Firefox e Edge têm páginas de complementos próprias). Vale aprender dois atalhos logo no primeiro dia: Ctrl+Shift+Y abre a barra lateral, Ctrl+Shift+L abre a interface web.

Qual fluxo de trabalho exige o quê

Fluxo de trabalhoRecursoRequisitoAdequação do modelo
Ler uma página longaChat with WebsiteModelo de chatNuvem para páginas longas
Reescrever o texto selecionadoMenu CopilotModelo de chatLocal é suficiente
Fazer perguntas sobre seus próprios arquivosKnowledge BaseChat + embeddingQualquer um
Deixar o modelo agirPage Action / MCPModelo com chamada de ferramentasNuvem

"Adequação do modelo" é um ponto de partida, não uma regra. Um modelo local forte em uma boa GPU pode cobrir as quatro linhas.

Configuração única: um modelo local e um provedor na nuvem

Local: o Ollama é detectado automaticamente

Se o Ollama estiver em execução em localhost:11434, o Page Assist o encontra sem nenhuma configuração e lista todos os modelos que você baixou. Se aparecer um erro 403 ao enviar uma mensagem, é um problema de CORS: ative a opção de origem personalizada em Configurações → Configurações do Ollama, ou defina OLLAMA_ORIGINS=* e reinicie o Ollama.

Nuvem: escolha a AIHubMix na lista de provedores

A AIHubMix é um provedor integrado ao Page Assist: desde a versão 1.5.86, ela aparece no menu suspenso de provedores ao lado da OpenAI, da DeepSeek e de outros, por isso não há URL para digitar. O procedimento segue o guia de provedores compatíveis com a OpenAI do Page Assist:

  1. Crie uma chave de API no console da AIHubMix (o início rápido mostra onde).
  2. No Page Assist, abra Configurações → API compatível com OpenAI → Adicionar provedor.
  3. Selecione AIHubMix no menu suspenso. A Base URL https://aihubmix.com/v1 já é preenchida automaticamente.
  4. Cole sua chave de API e salve.
  5. Uma lista de modelos aparece, obtida da AIHubMix. Pesquise, marque os modelos de chat que deseja, mantenha o tipo em Modelo de chat e salve.

Se quiser verificar a chave antes de colá-la na extensão, uma única requisição basta. O Page Assist se comunica com a AIHubMix pelo mesmo endpoint de Chat Completions:

curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "ping"}]}'

auto é um nome de modelo real na AIHubMix: o LLM Router escolhe um modelo para cada requisição (priorizando custo por padrão, com variantes que priorizam qualidade ou latência) e cobra pelo modelo que efetivamente usou. Adicionar auto como um dos seus modelos no Page Assist é um padrão razoável se você não quiser escolher. Consulte a lista de modelos quando quiser selecionar modelos específicos e comparar preços.

Modelo de embedding: necessário em dois dos quatro fluxos de trabalho

A Knowledge Base e o modo padrão do Chat with Website precisam de um modelo de embedding. Defina-o em Configurações → Configurações de RAG. Localmente, o Page Assist recomenda nomic-embed-text via Ollama. Pela AIHubMix, os modelos de embedding vêm da mesma lista de modelos dos modelos de chat. Abra novamente a lista de modelos do provedor, marque um modelo de embedding como gemini-embedding-001 e salve-o com o tipo definido como Modelo de embedding. Ele então aparece no menu suspenso de Configurações de RAG.

Fluxo 1: ler uma página longa sem sair dela

Abra a barra lateral em um artigo, uma página de documentação ou uma thread de issue no GitHub e ative Chat with Website. Agora você pode perguntar "quais são os três principais argumentos aqui?" ou "qual opção de configuração corrige o erro do comentário 14?", e o modelo responde com base na página em que você está.

Há duas maneiras de a página chegar ao modelo, e a diferença importa:

  • Modo de embedding (padrão): a página é dividida em partes, convertida em embeddings, e somente as partes relevantes são enviadas ao modelo. Funciona com janelas de contexto pequenas, mas pode deixar passar informações que se espalham pela página inteira.
  • Modo normal: o texto da página é enviado diretamente. Em Configurações de recuperação, desative "Enable Embedding and Retrieval" e aumente "Maximum Content Size for Full Context Mode". É melhor para resumos e perguntas como "compare a seção A com a seção D", mas exige um modelo com janela de contexto longa.

É nesse segundo modo que um modelo na nuvem se justifica. Uma especificação longa ou uma thread com 200 comentários cabe com folga em um modelo de contexto grande na nuvem, enquanto um modelo local pequeno precisaria que a página fosse reduzida.

Três recursos relacionados vale a pena conhecer:

  • Menções com @tab: digite @ para incluir outras abas abertas na mesma pergunta, por exemplo para comparar duas páginas de preços. Ative-o antes nas configurações.
  • Botão de resumo do YouTube: um botão opcional nas páginas de vídeos do YouTube que abre a barra lateral e resume o vídeo, usando a transcrição da página.
  • Visão: para páginas em que o conteúdo é principalmente imagens ou gráficos, o ícone de olho envia uma captura de tela da página para um modelo com capacidade de visão. Modelos sem visão podem recorrer ao OCR, que a própria documentação do Page Assist descreve como básico.

Fluxo 2: selecione o texto, clique com o botão direito, pronto

O menu Copilot é o fluxo de trabalho mais rápido da extensão. Selecione um texto em qualquer página, clique com o botão direito e escolha uma ação em Page Assist. Cinco vêm integradas: Summarize, Rephrase, Translate, Explain e Custom.

O verdadeiro valor está nos Prompts personalizados do Copilot (Configurações → Gerenciar prompts → Copilot personalizado). Cada um é um título com um modelo de texto em que {text} marca onde entra a seleção, e cada um vira uma entrada própria no menu do botão direito. Alguns que compensam rapidamente:

Title: Reply in plain English
Prompt: Rewrite the following so a non-native speaker can follow it. Keep it under 80 words.

{text}
Title: Find the claim
Prompt: List each factual claim in the following text and mark the ones that need a source.

{text}

Essas tarefas são curtas e frequentes, por isso é um bom lugar para um modelo local: sem custo por requisição, sem ida e volta pela rede, e o texto selecionado nunca sai da sua máquina. Reserve o modelo na nuvem para seleções longas ou que exijam raciocínio de verdade (uma cláusula contratual densa, um bloco de código desconhecido).

O prompt Translate integrado traduz para o inglês. Se você lê principalmente em outro idioma, edite o prompt integrado ou adicione um personalizado com o idioma de destino.

Fluxo 3: fazer perguntas sobre seus próprios arquivos

A Knowledge Base transforma PDFs, documentos do Word, textos, CSV e arquivos Markdown em algo com que você pode conversar. Vá em Configurações → Gerenciar conhecimento → Adicionar novo conhecimento, envie os arquivos e aguarde o processamento. Depois, no campo de entrada do chat, o ícone de conhecimento permite escolher qual coleção usar.

Duas coisas a saber antes de enviar uma pasta grande:

  • Tudo é processado e armazenado no navegador. O Page Assist avisa que isso pode causar problemas de desempenho com muitos dados. Comece com um conjunto focado de arquivos em vez de um arquivo inteiro.
  • A qualidade da recuperação depende mais do modelo de embedding do que do modelo de chat. Se as respostas continuarem deixando passar trechos óbvios, experimente um modelo de embedding mais forte antes de trocar o modelo de chat.

A escolha entre local e nuvem aqui depende principalmente dos documentos. Arquivos internos que você não colaria em um serviço web são um caso para uma configuração totalmente local: embedding local mais modelo de chat local. Artigos públicos ou documentação de produtos podem seguir qualquer um dos caminhos.

Fluxo 4: deixar o modelo agir sobre a página

Os fluxos de trabalho mais recentes vão além da leitura. Dois recursos dão ferramentas ao modelo:

  • Page Action é uma extensão complementar separada para navegadores baseados em Chromium. Com ele ativado (o ícone de cursor na barra lateral), o modelo pode ler a aba atual e clicar, digitar, rolar, navegar e preencher formulários, um passo de cada vez. Ele é distribuído separadamente porque precisa da permissão debugger do Chrome, que a maioria dos usuários nunca precisa conceder. Consulte a documentação do Page Action para a configuração.
  • MCP permite conectar servidores MCP remotos por Streamable HTTP, com autenticação por bearer token ou OAuth 2.1. Servidores STDIO podem ser ligados a HTTP com o supergateway.

Ambos têm uma chave de aprovação. "Require approval before each action" vem ativada por padrão no Page Action. O MCP é o oposto: as ferramentas são executadas sem aprovação até você ativar "Require approval before running MCP tools", a partir daí cada ferramenta pode ser definida como Allow, Human in loop ou Disable. Mantenha a aprovação ativa para qualquer ação que envie formulários, mensagens ou grave dados.

Este é o fluxo de trabalho em que a escolha do modelo mais importa. O uso de ferramentas em várias etapas exige um modelo que siga os esquemas das ferramentas de forma confiável e se recupere de um passo errado, o que, na prática, significa um modelo capaz na nuvem. Um modelo local pequeno costuma travar ou repetir ações.

Local ou nuvem: uma forma rápida de decidir

  • Escolha local quando o texto é privado, a tarefa é curta (reescritas, traduções, explicações rápidas) ou você quer custo marginal zero.
  • Escolha nuvem quando a página é longa, a pergunta exige raciocínio sobre o documento inteiro ou o modelo precisa usar ferramentas.
  • Cuidado com o que você envia: o Page Assist em si não coleta nada, mas tudo o que é enviado a um provedor na nuvem sai da sua máquina. A AIHubMix afirma que não armazena o conteúdo dos prompts nem das respostas, apenas metadados da requisição, como contagens de tokens. Cada fornecedor de modelo tem suas próprias políticas de retenção.

Como os dois tipos de modelo ficam no mesmo seletor de modelos, trocar de um para outro é uma mudança no menu suspenso durante a conversa, não um aplicativo diferente.

Problemas comuns

  • Erro 403 ao conversar com o Ollama: CORS. Ative a URL de origem personalizada nas Configurações do Ollama, ou defina OLLAMA_ORIGINS=*.
  • "No model found" após adicionar um provedor: a chave de API está incorreta ou não tem saldo.
  • AIHubMix não aparece no menu suspenso: a extensão é anterior à versão 1.5.86. Atualize-a ou escolha Custom e insira https://aihubmix.com/v1.
  • Modelo de embedding não aparece nas Configurações de RAG: ele foi salvo como Chat Model. Adicione-o novamente com o tipo definido como Embedding Model.
  • Chat with Website dá respostas superficiais: mude para o modo normal e use um modelo com uma janela de contexto maior.
  • A barra lateral não abre: o Opera e o Arc não oferecem suporte a ela; use a interface web.

Perguntas frequentes

O Page Assist é gratuito? Sim. Ele tem licença MIT e é gratuito em todos os navegadores suportados. Você só paga se conectar um provedor de nuvem pago.

Preciso do Ollama para usar o Page Assist? Não. O Ollama é o padrão, mas qualquer endpoint compatível com a OpenAI funciona, incluindo LM Studio, llama.cpp, vLLM e gateways na nuvem como a AIHubMix.

A AIHubMix está no menu suspenso de provedores? Sim, desde a versão 1.5.86. Selecione-a e cole sua chave de API; a Base URL é preenchida automaticamente. Em uma versão mais antiga, atualize a extensão primeiro.

O Page Assist envia meus dados de navegação para algum lugar? O Page Assist não tem telemetria e armazena o histórico localmente. O conteúdo da página só é enviado ao modelo com o qual você conversa. Se for um modelo na nuvem, o conteúdo vai para esse provedor.

Qual modelo de embedding devo usar? Localmente, o nomic-embed-text via Ollama é a recomendação documentada. Pela AIHubMix, escolha um como gemini-embedding-001 na mesma lista de modelos de chat e salve-o com o tipo definido como Embedding Model.

Posso usar modelos diferentes para fluxos de trabalho diferentes? Sim. O seletor de modelos é por chat, então você pode manter um modelo local para reescritas rápidas e trocar para um modelo na nuvem para uma página longa na mesma sessão.

O Page Action funciona no Firefox? Não. O Page Action está disponível apenas em navegadores baseados em Chromium, como Chrome, Brave e Edge, porque depende do Chrome DevTools Protocol.

Fontes

Um só gateway para vários provedores de IA. Feito para produção.

Acessar AIHubMix