Playwright Agent

🚀 AgentKit ブラウザ自動化フレームワーク

AgentKitを基に構築された高度なブラウザ自動化フレームワークで、マルチエージェントシステムを用いて、スマートなウェブページナビゲーションとタスク実行を実現します。

🚀 クイックスタート

このフレームワークは、AgentKitに基づくマルチエージェントシステムを用いてブラウザ自動化を実現します。異なるエージェントが協調して、タスクの計画立案、ウェブページのナビゲーション、ブラウザ操作の実行、結果の検証などの目標を達成します。

✨ 主な機能

• スマートなタスク計画：複雑なタスクを管理可能なステップに分解します。
• 状態管理：ブラウザの状態と操作結果を追跡します。
• エラー処理：強力なエラー処理と回復メカニズムを備えています。
• イベントシステム：包括的なイベント記録と監視機能があります。
• 柔軟なアクションシステム：カスタム動作をサポートするための拡張可能なアクションレジストリがあります。
• 検証フレームワーク：タスクの完了状況を確認するための組み込み検証機能があります。
• メモリ管理：操作のコンテキストと履歴を維持します。

📦 インストール

依存関係

• Node.js（v14以上）
• npm または yarn
• OpenAI API キー（GPTモデル用）

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/tmahesh/playwright-agent.git
cd playwright-agent

2. 依存関係をインストールします：

npm install

3. 環境変数を設定します：

cp .env.sample .env
# OpenAI APIキーとその他の設定を使用して.envファイルを編集します

4. 異なるターミナルで以下のコマンドを実行します：index.ts、playwright - mcp、inngest - cli

npx @playwright/mcp@latest --port 8931

npx tsx index.ts

npx inngest-cli@latest dev --no-discovery -u http://localhost:3000/api/inngest -v

📚 ドキュメント

システム構成

このシステムは4つの専門化されたエージェントで構成されています：

1. 計画エージェント
   • タスクを実行可能なステップに分解します。
   • 詳細な実行計画を作成します。
   • タスクの完了基準を決定します。
2. ナビゲーションエージェント
   • 次の操作を決定します。
   • 状態遷移を管理します。
   • アクションの実行を処理します。
   • 詳細なログとフィードバックを提供します。
3. ブラウザエージェント
   • ブラウザの自動化操作を実行します。
   • ウェブページ要素とのインタラクションを行います。
   • ページナビゲーションを処理します。
   • ブラウザの状態を管理します。
4. 検証エージェント
   • タスクの完了状況を検証します。
   • 結果を検証します。
   • エラー状況を処理します。
   • 成功/失敗のフィードバックを提供します。

🤝 貢献ガイド

1. リポジトリをフォークしてクローンします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを作成します。