HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Argus、コーディングエージェントがQAより速く動くチームのためのエージェンティックQA

Show HN: Argus, agentic QA for teams whose coding agents move faster than QA (github.com)

7 pointsby canergl5 コメント

要約

Argusは、スクリプト作成やセレクタのメンテナンスなしに、AIエージェントがユーザーのようにUIをテストするビジュアルUIテストエージェントです。テストを記述しページを指示するだけで、エージェントがUIを探索し、構造化されたレポート、タイムライン、スクリーンショットを自動的にキャプチャします。このシステムは、複数のエージェントが連携して動作し、テストの実行プロセス全体を可視化することで、従来のテストでは見逃されがちなバグを発見します。

全文翻訳

Argus

スクリプト不要、セレクタメンテナンス不要。実際のユーザーのようにUIをテストするAIエージェント。

[画像: Website]

ArgusはビジュアルUIテストエージェントです。テストを記述し、HTTP(S)ページを対象に指定すると、隔離されたPlaywrightブラウザコンテキストでページを検査します。実行、タイムライン、スクリーンショット参照、構造化されたレポートは自動的にキャプチャされます。

Argusは、あなたがテストを書いていないバグを発見します。 ページを対象に、「動作している」状態を記述するだけで、自律エージェントが実際のユーザーのようにUIを探索し(クリック、入力、スクロール)、スクリーンショットとタイムライン付きの構造化されたレポートを提供します。メンテナンスするテストスクリプトも、世話をする不安定なセレクタも不要です。

[画像: Argus dashboard]

  • スクリプトではなくエージェンティック — エージェントはページについて推論し、適応します。固定スクリプトを再生するわけではありません。
  • スタックに適合 — Playwright上に構築されており、localhostやプライベートネットワークのアプリで動作します。
  • ゼロセットアップの手間 — 数分でテストを開始できます。

ホストプラットフォームを使用する

Argusを実行する最も速い方法:インストール不要、APIキー管理不要、セルフホスト不要。

argustest.com で開始してください。

6段階のエージェントパイプライン

実行は、制約のない単一のモデル呼び出しではなく、境界のある6段階のパイプラインです。

  1. バリデーター — 実行開始前に、ターゲットURLとテスト記述が実際にテスト可能かどうかを確認します。
  2. コンプレヘンダー — テスト記述を読み込み、個別のテストケースに分解します。
  3. エクスプローラー — まずアプリをクロールし、各ページと利用可能なアクションをマッピングします。
  4. ストラテジスト — マップとテストケースを具体的なステップバイステップの計画に変換します。
  5. エグゼキューター — 実際のブラウザで計画を実行します:ナビゲーション、入力、クリック、結果の確認を行います。
  6. クリティック — 判定が受け入れられる前に、リクエスト、実行、証拠を独立してレビューします。

ステージ間の引き継ぎは、検証済みのJSON契約を使用します。不正な引き継ぎは1回の修復試行が行われます。実行されたすべてのケースが合格し、実行のために永続化されたスクリーンショットを参照した場合にのみ合格が受け入れられます。

ブラウザ機能

Goエージェントは、セマンティックで参照ベースのブラウザインターフェースを公開します。

  • インスペクション、ナビゲーション、クリック、入力、複数フィールド入力、フォーム送信、セレクトコントロール
  • キーボード入力、スクロール、ビューポートリサイズ、境界付き待機、コンソールエラー、ネットワークエラー
  • フルページ証拠スクリーンショットと、選択されたモデルプロバイダーに直接返されるビューポートスクリーンショット
  • Geminiが構成されている場合の、ビジュアルな find_elements と保護された visual_click のグラウンディング

モデル呼び出しは、任意のCSSセレクタアクセスを受け取りません。各インスペクションは、実行ローカルの要素参照を作成します。ナビゲーションまたは新しいインスペクション後に、古い参照は拒否されます。ビジュアルクリックは、Geminiが提案した座標の下にある実際のDOM要素を解決し、クリック前に同じアクションポリシーを適用します。

Argusの内部

[画像: Describing a test]

[画像: A run in progress]

[画像: A completed run report]

[画像: Integrations]

例

テストは単なる意図の記述です — Argusがページとの対話方法を理解します。例えば、Y Combinatorのサイトを対象にした場合:

Target: https://www.ycombinator.com

Test the startup directory.

1. From the homepage, navigate to the companies/startup directory.
2. Search for a well-known YC company by name (e.g. "Airbnb") and confirm it appears in the results.
3. Filter the directory by a specific batch (e.g. "Winter 2024") and confirm the listed companies update to match.
4. Open a company's profile from the results and confirm its name, one-line description, batch, and website link all render correctly.
5. Navigate back to the directory and confirm the search/filter state behaves as expected — either preserved or reset, whichever the page is designed to do.
6. Resize the viewport to 375px width and confirm the nav collapses into a mobile menu, and the directory list stays scrollable and usable with no overlapping elements.

Fail the test if the known company doesn't appear in search results, if the batch filter doesn't actually filter the list, if a company profile is missing expected fields, or if the mobile layout breaks.

Argusはこれを人間が行うように実行します — フローをクリックし、ページの成功または失敗を判断するために読み取り — 各ステップでのタイムライン、スクリーンショット、およびその理由を示す合格/不合格レポートを返します。

自分で実行する

Argusはソースアベイラブルでローカルファーストです — SQLiteストレージで、アプリケーションテレメトリはありません。ブラウザの観測結果とスクリーンショットは、エージェント実行に必要な場合に選択された構成済みプロバイダーに送信されます。実行メタデータと証拠は、ローカルのSQLite/dataディレクトリに残ります。

要件
  • Go 1.25+、Node.js 20.19+ または 22.12+、および実際の実行のためのGemini、OpenAI、またはKimi APIキー
ローカルで実行

リポジトリのルートから:

cd frontend && npm ci && npm run build && cd ..
go -C argus run ./cmd/argus install-browser
GEMINI_API_KEY=your-key GEMINI_MODEL=gemini-2.5-flash ARGUS_RUN_TIMEOUT=300 ARGUS_DB_PATH=data/argus.db PORT=8000 go -C argus run ./cmd/argus

http://localhost:8000 を開きます。フロントエンドのホットリロードのためには、別のターミナルで frontend/ 内で npm run dev を実行し、Goサーバーを起動してください。

設定は環境変数のみです。

変数
GEMINI_API_KEY
GEMINI_MODEL
OPENAI_API_KEY
OPENAI_MODEL
KIMI_API_KEY
KIMI_MODEL
KIMI_BASE_URL
ZAI_API_KEY
GLM_MODEL
ZAI_BASE_URL
TYPESAFE_API_KEY
JEV_MODEL
ARGUS_RUN_TIMEOUT
ARGUS_DB_PATH
PORT
ARGUS_BASE_URL

TYPESAFE_API_KEY が設定されている場合、プランナーは適切なケースに対して構造化されたDOMアクションを発行できます。Jevは新しい要素参照を選択し、DOM/テキストの結果をチェックします。Goは既存のポリシーガードを通じてアクションを実行します。0.9未満の信頼度、曖昧な結果、サポートされていないケース、またはAPIエラーは、その実行中はJevが無効になります。完了したアクションはフォールバック計画から除外され、検証のみのフォールバックはアクションを再生できません。ブラウザアクションのエラーは、完了した可能性のあるミューテーションを再試行するのではなく、実行を停止します。ビジョン、プランニング、独立したクリティック、および永続化されたスクリーンショットの要件は変更されません。信頼度のしきい値は初期ゲートであり、測定された精度保証ではありません。

実行の承認とシークレットバインディング

実行はデフォルトで読み取り専用です。最初のターゲットオリジンは常に許可されます。追加のオリジン、状態変更アクション、および破壊的なコントロールには、実行ごとの明示的な承認が必要です。

{
  "url": "https://app.example.com",
  "instructions": "Sign in and verify the account page",
  "authorization": {
    "allow_mutations": true,
    "allow_destructive": false,
    "allowed_origins": ["https://accounts.example.com"],
    "secret_bindings": {
      "login_email": "qa@example.com",
      "login_password": "provided-at-request-time"
    }
  }
}

そのオブジェクトを POST /api/runs に送信します。シークレット値は実行スコープのメモリにコピーされ、最後の入力呼び出しで解決され、モデルから見えるテキストでは赤化され、スクリーンショットではマスクされ、SQLite/イベント/レポートには書き込まれず、実行終了時にゼロクリアされます。バインディング名は ^[A-Za-z_][A-Za-z0-9_.-]{0,99}$ に一致する必要があります。最大20個の4KiBまでのバインディングが受け入れられます。ダッシュボードは意図的にポリシーコントロールを表示しますが、生のシークレットフィールドは表示しません。

読み取り専用ブラウザコンテキストは、GET/HEAD/OPTIONS以外のリクエストを中止します。ドキュメントナビゲーション(リダイレクトやリンククリックを含む)は、ターゲットオリジンと allowed_origins に制限されます。allow_destructive は allow_mutations も有効でない限り無効です。

MCPクライアントを接続する

Argusを通常通り起動し、リポジトリのルートからローカルstdioアダプターをインストールします。

go install ./argus/cmd/argus-mcp

Goのbinディレクトリ(通常は $(go env GOPATH)/bin)が PATH に設定されていることを確認し、MCPクライアントを構成します。

{
  "mcpServers": {
    "argus": {
      "command": "argus-mcp",
      "env": {"ARGUS_BASE_URL": "http://127.0.0.1:8000"}
    }
  }
}

アダプターは start_test、get_test_run、list_test_runs、cancel_test、get_test_evidence を公開します。既存のRESTサーバーにのみ接続します。これらのツールを使用する前にGo Argusを起動してください。同じクライアント固有の設定とサーバーの状態は、Settings → MCP setup で利用可能です。

Argusは通常のHTTP(S)ターゲットを受け入れます。これには信頼できるlocalhostおよびプライベートネットワークアプリが含まれます。ターゲットURLの認証情報と機密性の高いクエリパラメータは拒否されます。設定画面には、プロバイダー設定が存在するかどうかのみが表示されます。

Docker
cp .env.example .env
# Set a provider API key in .env
docker compose up --build

UIは http://localhost:8000 で利用可能で、永続データは ./data に書き込まれます。

開発チェック
cd argus && go test -race ./... && go vet ./...
cd ../frontend && npm ci && npm test && npm run typecheck && npm run lint && npm run build

デフォルトのGoスイートはオフラインで、決定論的なプロバイダーダブルを使用します。Jev統合をライブAPIに対して実行するには、TYPESAFE_API_KEY をエクスポートし、argus/ から ARGUS_PLAYWRIGHT_SMOKE=1 ARGUS_JEV_LIVE=1 go test ./internal/runner -run TestIntegrationJevUsesRealPlaywright -v を実行します。これにより、合成フィクスチャデータで有料のJev呼び出しが行われ、LLMステージはスタブのままになります。go run ./cmd/argus install-browser の後、ARGUS_PLAYWRIGHT_SMOKE=1 を設定して、実際のChromiumフィクスチャと完全なランナー統合を含めます。

cd argus
ARGUS_PLAYWRIGHT_SMOKE=1 go test -race ./...
アーキテクチャ
  • argus/cmd/argus: ローカルREST/WebSocketサーバーとビルド済みUIサービング
  • argus/internal/runner: 6段階のGeminiパイプライン、厳密な契約、ブラウザポリシー、証拠ゲーティング
  • argus/internal/browser: 隔離されたPlaywrightセッション、セマンティック参照、リクエストインターセプト、赤化されたスクリーンショット
  • argus/cmd/argus-mcp: RESTサーバー用のローカルstdio MCPアダプター
  • frontend: ダッシュボード/コンポーザー、ライブセッション、履歴、レポート、読み取り専用設定

このリリースには、サーバー認証またはマルチユーザー分離はありません。サーバーを信頼できるインターフェイスにバインドし、localhostを超えて公開する場合は、認証付きリバースプロキシを前に配置してください。

ライセンス

Argusはソースアベイラブルであり、現時点ではOSIオープンソースではありません。ライセンスは Argus Source-Available License 1.0 (ASAL-1.0) に基づいています。

  • 個人および小規模チーム(100人未満): 商用および非商用の目的で、自由に使用、変更、セルフホストできます。
  • エンタープライズ(100人以上): 商用ライセンスが必要です。セットアップについては、licensing@argustest.com までお問い合わせください。
  • リリースは3年後に自動的に MITライセンス に変換されます。