統合 · 中級

AI エージェントにプロキシを与える: 環境変数、Playwright MCP、ブラウザ エージェント

エージェントはせっかちな人間のように閲覧します。多数のページ、予測不可能なターゲット、どのサイトがブロックしたのか記憶がありません。タスクごとの居住終了、タスクを継続するセッション、および支出上限により、それが安定したセットアップに変わります。

3 分で読めます 7つのセクション 確認日 編集チーム Proxy Cyber

エージェントが引き起こす 3 つの問題#

  • 予測不可能なターゲット。 エージェントがどこに行くかを決定します。あるサイトのデータセンターと別のサイトの住宅を事前に選択することはできません。住宅地の出口が安全なデフォルトです。
  • タスクあたりのホップ数が多い。 検索、開く、クリック、読み取り、繰り返し: タスクはセッションであり、継続中は 1 つの終了にとどまる必要があります。
  • 際限のない支出。 ループ内のエージェントはギガバイトをフェッチできます。超えられない上限を設けてください。

ツールチェーン全体の環境変数#

リクエスト、HTTPX、および urllib は、デフォルト設定でプロキシ環境変数を読み取ることができます。 aiohttp には ClientSession(trust_env=True) または明示的なプロキシ引数が必要です。独自のネットワーク スタックを備えたブラウザとツールは、これらの変数を無視する場合があります。各ツールの終了を確認し、直接接続する必要があるホストに対してのみ NO_PROXY を使用します。

シェル
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

モデルプロバイダーの API ホストを除外します。 NO_PROXY: LLM 通話は住宅出口を必要とせず、通信費のみがかかります。

Node.jsエージェント#

サポートされている Node.js リリースでは、NODE_USE_ENV_PROXY=1 により、組み込みフェッチの HTTP_PROXY、HTTPS_PROXY、および NO_PROXY が有効になります。 --use-env-proxy は、Node.js 22.21 以降および 24.5 以降で使用できます。明示的な undici ProxyAgent または EnvHttpProxyAgent が代替手段です。独自のトランスポートまたはカスタム エージェントを持つライブラリには個別の構成が必要なため、プロセス全体がカバーされていると仮定するのではなく、各ツールをテストしてください。

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

劇作家MCPサーバー#

Playwright MCP サーバーは、ブラウザを駆動するために Claude、ChatGPT スタイルのツール、および IDE エージェントによって使用され、起動時にプロキシを受け入れます。スティッキー ユーザー名とローカル ホストのバイパス リストを使用してゲートウェイを渡します。

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

Access でサーバーの実際の送信パブリック IPv4 を送信し、管理者によるアクティブ化を待ちます。 NAT または VPN によって、ゲートウェイが認識するアドレスが変更される場合があります。パスワードなしのアクセスは、割り当てられたサービスへのエントリが確認された後にのみ機能します。国とセッションのオプションを個別に確認します。送信元 IP 許可リストはユーザー名パラメーターを送信しません。

Playwright に基づいて構築されたブラウザ エージェント#

ブラウザ使用などのフレームワークは、ブラウザ設定で Playwright のプロキシ設定 (サーバー、ユーザー名、パスワード) を公開します。並列実行が出口を共有しないように、各エージェント実行に新しいセッション ID を与え、コンテキスト ロケールとタイム ゾーンを出口の国に設定します。

Python、Playwright ベースのエージェント
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

天井: サブユーザー#

を提出してください サブユーザー 個別のラベル、ネットワーク、および意図した GB 制限を使用して、Access でリクエストを実行します。管理者は資格情報を割り当て、アクティベーションとゲートウェイによる制限を確認します。保留中のリクエストはアクティブなアカウントではありません。アプリケーション側の使用量予算も確保し、アクティブな資格情報が公開された場合は、サポートにその資格情報を取り消すか置き換えるよう依頼してください。

行動衛生#

  • エージェントのリクエストをドメインごとおよび分ごとに制限します。回転はハンマリングを許すものではありません。
  • ブラウザーのコンテキストで画像、メディア、フォントをブロックします。エージェントはテキストを読みます。
  • 各タスクのセッション ID をログに記録することで、ブロックされた実行をその終了まで追跡し、新しい実行で再生できるようになります。

人々が尋ねる質問#

LLM API 呼び出しもプロキシを経由する必要がありますか?

いいえ。NO_PROXY を使用してプロバイダー ホストを除外します。これらの呼び出しには住宅出口は必要なく、トラフィックのみが消費されます。

主にドキュメントを読んだりサイトを開いたりするエージェントのネットワークはどれですか?

個別のセッション識別子は、ブラウザの Cookie やアプリケーションの状態ではなく、ルーティング設定を分離します。少数のワーカーから始めて、エラーとトラフィックを測定し、注文と目的地で確認された制限内で徐々に増やしてください。都市または通信事業者の選択が狭いと、利用可能な容量が減少する可能性があります。

あなたのアカウント

1 つのアカウントでプロキシを管理

1 つのダッシュボードからネットワークを比較し、注文し、残高とサポート リクエストを追跡します。私たちのチームが支払いを確認し、配達後に接続の詳細を提供します。

アカウント作成