Fornecendo um proxy a um agente de IA: variáveis de ambiente, Playwright MCP e agentes de navegador

Os três problemas que os agentes criam#

• Alvos imprevisíveis. O agente decide para onde ir; você não pode pré-selecionar datacenter para um local e residencial para outro. Uma saída residencial é o padrão seguro.
• Muitos saltos por tarefa. Pesquise, abra, clique, leia, repita: uma tarefa é uma sessão e deve ficar em uma saída enquanto durar.
• Gastos ilimitados. Um agente em loop pode buscar gigabytes. Dê-lhe um limite que não possa exceder.

Variáveis de ambiente para todo o conjunto de ferramentas#

requests, HTTPX e urllib podem ler as variáveis de ambiente do proxy na configuração predefinida. O aiohttp exige ClientSession(trust_env=True) ou um argumento proxy explícito. Navegadores e ferramentas com rede própria podem ignorá-las. Verifique a saída de cada ferramenta e limite NO_PROXY aos hosts que devem ligar diretamente.

export HTTPS_PROXY="http://AGENTUSER-cc-us-sid-task-4f2a-ttl-2h:PASS@res.proxy-cyber.com:9000"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1,api.openai.com,api.anthropic.com"
python agent.py

Exclua os hosts de API do provedor de modelo com NO_PROXY: as chamadas LLM não necessitam de saída residencial e custariam apenas tráfego.

Agentes Node.js.#

Nas versões compatíveis de Node.js, NODE_USE_ENV_PROXY=1 ativa HTTP_PROXY, HTTPS_PROXY e NO_PROXY para o fetch integrado; --use-env-proxy está disponível em Node.js 22.21+ e 24.5+. Em alternativa, configure ProxyAgent ou EnvHttpProxyAgent do undici. Bibliotecas com transporte ou agentes próprios exigem configuração e testes separados.

import { EnvHttpProxyAgent, setGlobalDispatcher } from "undici";
setGlobalDispatcher(new EnvHttpProxyAgent()); // reads HTTPS_PROXY / NO_PROXY

Servidor MCP do dramaturgo#

O servidor Playwright MCP, usado por Claude, ferramentas estilo ChatGPT e agentes IDE para controlar um navegador, aceita um proxy na inicialização. Passe o gateway com um nome de usuário fixo e a lista de ignorados para hosts locais.

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--proxy-server=http://res.proxy-cyber.com:9000",
        "--proxy-bypass=localhost,127.0.0.1"
      ]
    }
  }
}

Solicite em Acesso a autorização do IPv4 público de saída real do servidor e aguarde a ativação pelo administrador. NAT ou uma VPN podem alterar o endereço visto pelo gateway. O acesso sem palavra-passe só funciona após a confirmação da entrada para o serviço atribuído. A lista de IPs não transmite parâmetros de utilizador; confirme a localização e a sessão separadamente.

Agentes de navegador desenvolvidos no Playwright#

Estruturas como o uso do navegador expõem as configurações de proxy do Playwright (servidor, nome de usuário, senha) na configuração do navegador. Dê a cada agente um novo ID de sessão para que as execuções paralelas não compartilhem uma saída e defina a localidade do contexto e o fuso horário para o país da saída.

proxy = {
    "server": "http://res.proxy-cyber.com:9000",
    "username": f"AGENTUSER-cc-us-sid-{run_id}-ttl-1h",
    "password": "PASS",
}
# pass `proxy` where the framework accepts Playwright proxy settings

Tetos: subusuários#

Envie em Acesso um pedido de subutilizador com etiqueta, rede e limite pretendido em GB. O administrador atribui as credenciais e confirma a ativação e o limite aplicado pelo gateway. Um pedido pendente não é uma conta ativa. Mantenha também um orçamento na aplicação e peça ao suporte que revogue ou substitua credenciais expostas. subusuário

Higiene comportamental#

• Limitar as solicitações do agente por domínio e por minuto; a rotação não desculpa o martelamento.
• Bloqueie imagens, mídias e fontes no contexto do navegador; agentes leem o texto.
• Registre o ID da sessão com cada tarefa para que uma execução bloqueada possa ser rastreada até sua saída e reproduzida em uma nova.

Perguntas que as pessoas fazem#