Como usar o ego (lite) com um modelo local

Este tutorial conecta um modelo Qwen local ao ego (lite) no Windows. As gravações usam o DeepSeek Harness com um modelo chamado Qwen3.5 9B Local Demo para buscar hospedagem em Tóquio no Airbnb e devolver três anúncios.

A configuração tem três partes: o Ollama executa o modelo, o seu Agent Harness gerencia a conversa e executa as ferramentas, e o ego (lite) abre as páginas web pela Skill ego-browser. Baixar um modelo, por si só, não o conecta ao navegador.

Você pode usar outro modelo local e outro Harness, desde que eles suportem chamadas de ferramentas e permitam carregar o ego-browser e executar os comandos dele no computador com Windows em que o ego (lite) está instalado.

Antes de começar: prepare os programas

Instale estes aplicativos no mesmo computador com Windows:

• Ollama para Windows: baixa o modelo e o disponibiliza localmente. Abra o aplicativo depois da instalação e deixe-o em execução.
• O seu Agent Harness: as gravações usam o DeepSeek Harness. Ele precisa suportar o Ollama local ou uma conexão de modelo compatível com OpenAI, além da execução de comandos locais.
• ego (lite): instale-o e conclua a configuração inicial para que o seu Harness possa carregar a Skill ego-browser. Feche o Harness por completo e abra-o de novo depois da configuração; em seguida, inicie uma nova sessão.

Mantenha uma conexão com a internet para o download inicial do modelo e para os sites que você quer acessar. A inferência do modelo pode rodar localmente enquanto o navegador continua acessando páginas online.

Configure o modelo local com o Ollama

O vídeo de configuração abre o site do Ollama, busca qwen3.5 e mostra a família de modelos e os tamanhos disponíveis. Siga as etapas abaixo para instalar e conectar a variante 9B usada neste tutorial. O vídeo não mostra o download do modelo nem a configuração do provedor no Harness.

1. Verifique o Ollama e baixe o Qwen

Abra o PowerShell no Windows Terminal e execute:

ollama --version
ollama list
ollama pull qwen3.5:9b
ollama list

Aguarde o fim do download. A última lista deve incluir qwen3.5:9b. Use a tag explícita :9b para baixar o tamanho pretendido, em vez de depender da tag padrão da família. A página oficial do modelo traz as opções de download e os detalhes do modelo. Deixe memória livre para o contexto do modelo e para os seus outros aplicativos; o tamanho do download não corresponde a toda a memória necessária durante a execução.

Se o PowerShell não encontrar o ollama, conclua a instalação do Ollama e abra um novo terminal. Se ele não conseguir se conectar ao serviço, abra o Ollama pelo menu Iniciar do Windows. Para detalhes sobre a instalação e o serviço, consulte as instruções de configuração para Windows.

2. Defina o tamanho do contexto

As tarefas no navegador acumulam instruções, texto das páginas e resultados de ferramentas. Nas configurações do aplicativo Ollama, defina o tamanho do contexto como 64k ou mais, desde que o seu computador tenha memória disponível suficiente. O guia de tamanho do contexto do Ollama recomenda pelo menos 64.000 tokens para tarefas de agentes e explica a memória adicional necessária.

Se você instalou apenas a CLI, pode, em vez disso, iniciar o serviço pelo PowerShell com:

$env:OLLAMA_CONTEXT_LENGTH = "65536"
ollama serve

Use isso como alternativa ao aplicativo Ollama em execução. Antes, encerre normalmente o aplicativo da bandeja do sistema para não iniciar um segundo serviço na mesma porta. Deixe essa janela do PowerShell aberta e use outro terminal para os próximos comandos. A variável de ambiente acima vale para essa sessão do terminal; defina-a de novo sempre que iniciar um novo serviço pela CLI.

3. Confira se o modelo responde

No PowerShell, execute:

ollama run qwen3.5:9b

Envie uma mensagem curta, como Reply with one sentence to confirm you are ready. Aguarde a resposta e digite /bye para sair da conversa com o modelo. Mantenha o Ollama em execução.

Isso confirma que o modelo consegue gerar texto. A conexão com o navegador será verificada quando você executar a tarefa mais adiante.

4. Conecte o seu Harness ao Ollama local

Adicione a conexão local na configuração de modelos ou de provedores que o seu Harness oferece. Para uma conexão compatível com OpenAI, use estes valores da documentação de compatibilidade do Ollama:

Adicione o provedor pelas configurações ou pelo arquivo de configuração que o seu Harness suporta. Use o formato de arquivo aceito pela versão instalada do seu Harness e preserve as configurações não relacionadas ao adicionar o provedor.

Use o ID exato do modelo mostrado por ollama list. Um nome de exibição, por si só, não cria nem renomeia um modelo do Ollama.

Use o endereço de conexão local exigido pela integração do seu Harness com o Ollama. Antes de salvar o provedor, verifique se ele espera uma conexão nativa com o Ollama ou uma conexão compatível com OpenAI.

Salve a configuração e escolha o modelo local no seletor de modelos do Harness. Na gravação, Qwen3.5 9B Local Demo já está selecionado abaixo do campo de mensagem. Esse é um rótulo de exibição; ao configurar a sua própria conexão, use o ID do modelo retornado por ollama list. Cada Harness usa configurações de provedor ou arquivos de configuração diferentes, então siga o método de configuração que o seu Harness suporta.

Envie uma mensagem curta de teste pelo Harness com o seu modelo local selecionado. Enquanto ele gera a resposta, execute isto em outro terminal:

ollama ps

Confira o modelo em execução e o valor de CONTEXT. Uma lista vazia significa que nenhum modelo está carregado no momento; repita a verificação durante a geração. Assim você distingue uma entrada de modelo salva de um modelo realmente em execução no Ollama.

Etapa 1: defina as permissões da sessão

Com o seu modelo Qwen local selecionado, abra o menu de permissões abaixo do campo de mensagem. Na interface do DeepSeek Harness mostrada na gravação, mude de Workspace Write para Full access, selecione I understand the risks and want to continue e escolha Enable Full access.

Essas são permissões do Harness para executar ferramentas no seu computador. Elas são independentes da configuração do modelo no Ollama. Se você usa outro Harness, escolha as permissões equivalentes para comandos locais e revise os pedidos de aprovação que aparecerem.

Etapa 2: carregue a Skill ego-browser

Inicie uma nova sessão. Digite /ego-browser, selecione ego-browser no seletor de comandos de barra, adicione um espaço e escreva a tarefa na mesma mensagem. Confirme que o seu modelo Qwen local continua selecionado e envie a mensagem.

Na gravação, o agente recebe o pedido de buscar hospedagem em Tóquio no Airbnb e encontrar três opções baratas. Você pode usar:

Use o ego-browser para buscar no Airbnb hospedagem em Tóquio, no Japão. Compare três anúncios baratos e devolva os links e os preços mostrados na página.

Etapa 3: deixe o modelo local trabalhar

O Qwen gera as próximas ações por meio do Harness. O Harness executa os comandos do ego-browser, abre o Airbnb em um Space do ego (lite), aplica filtros de busca e lê os anúncios. Mude para o Space do agente para acompanhar as ações no navegador, enquanto as suas abas continuam no seu Space.

Mantenha o Ollama e o Harness em execução até a tarefa terminar. O modelo precisa tanto do serviço de inferência local quanto da execução de ferramentas pelo Harness para continuar.

Etapa 4: confira o resultado

A tarefa gravada termina com uma tabela de três anúncios, com links e informações de preço, na conversa do Harness. As páginas do navegador usadas pelo agente continuam disponíveis no ego (lite), então você pode abrir os links devolvidos e compará-los com a resposta.

Solução de problemas

O Ollama não conecta ou o modelo não aparece

Abra o Ollama, execute ollama list e procure qwen3.5:9b. Termine o download antes de tentar de novo. Se o serviço estiver em execução, mas o Harness não conseguir se conectar, compare o tipo de conexão, a URL base e o ID exato do modelo com a tabela acima.

O modelo não aparece no Harness

Salve a configuração do provedor local e reinicie o Harness se ele não atualizar a lista de modelos. Confira se o provedor consegue se conectar ao serviço do Ollama em execução. Um modelo listado pelo Ollama ainda precisa ser adicionado ou detectado pela integração de provedores do Harness.

O modelo responde, mas nada acontece no navegador

Confira se o Harness carregou o ego-browser e está fazendo chamadas de ferramentas. Se a Skill não aparecer, conclua a configuração inicial do ego (lite) e reinicie o Harness. Revise as permissões de execução local e as aprovações pendentes. O Harness precisa executar os comandos no mesmo computador com Windows em que está o ego (lite).

A tarefa fica lenta, a memória acaba ou ela para

Leia a mensagem de erro no Harness ou no Ollama antes de tentar de novo. Feche aplicativos desnecessários que consomem muita memória e comece com uma tarefa menor no navegador. Durante a geração, use ollama ps para ver o modelo carregado e o contexto. Se você escolher um modelo menor, baixe-o e atualize também o ID do modelo no Harness; ele ainda precisa suportar chamadas de ferramentas.

O Airbnb pede login

Abra o Space do agente, faça você mesmo o login ou a verificação e depois peça ao agente para continuar.

Documentação relacionada

• DeepSeek Harness explica a interface usada nas gravações.
• O seu próprio Agent Harness explica os requisitos para usar outro Harness.
• Skills explica como um agente obtém acesso às ferramentas do navegador.
• Space explica onde ficam as páginas do agente.
• Ollama para Windows explica a instalação e a configuração do serviço.
• Tamanho do contexto no Ollama explica as configurações de contexto e o uso de memória.