nova-act

オンボーディング

公式ドキュメント： Nova Act GitHub READMEが信頼できる情報源です。

ステップ 1：認証の設定

Nova Act は 2 種類の認証方法に対応しています。どちらの方法を使用するか、必ずユーザーに尋ねてください！

• API キー（クイックスタート） — 開発／テストに最適です。https://nova.amazon.com/act?tab=dev_tools で生成し、export NOVA_ACT_API_KEY="your_key"を実行します。デコレーターは不要です。
• AWS 認証情報 + ワークフロー定義（本番環境） — IAM ベースのアクセスや S3 へのエクスポートに最適です。AWS 認証情報と@workflowデコレーターが必要です。references/workflow_definitions.mdを参照してください。

設定の詳細：references/authentication.md

ステップ 2：Nova Act の使用を開始する

適切なモードに案内してください：

ユーザーの目的	案内先
ウェブサイトを対話的に探索する	references/browser_cli.md（オプション A）
ブラウザーを使うコーディングエージェントを構築する	references/browser_cli.md（オプション A）
繰り返し実行できるテストスクリプトを書く	references/qa_tests.md（オプション B）
Python 自動化スクリプトを書く	references/qa_tests.md（オプション B）+ references/data_extraction.md
手動テストを自動化する	references/gherkin_testing.md
UI を通じてコードベースを理解する	references/flow_discovery.md
バグを再現する	references/bug_reproduction.md
自動化プロンプトを反復して改善する	references/workflow_refinement.md
実際のサイトの記録からモックサイトを生成する	references/mock_generation.md
本番環境にデプロイする	references/deployment_cli.md

オプション A：ブラウザー CLI（探索およびエージェントによるツール使用に推奨）

pip install 'nova-act[cli]'
act browser execute "Go to https://example.com, find the pricing page, and extract plan names and prices" --session-id work
# If you need to observe current state:
act browser ask "What page am I on?" --session-id work
# If you need a zero-inference jump:
act browser goto https://example.com/specific-page --session-id work

詳細なプランを指定して、デフォルトでexecuteを使用します。復旧、状況確認、または推論を伴わない操作には、個別のコマンド（goto、askなど）を使用します。NovaAct コンストラクターまたはメソッドの引数は--nova-argで渡します。例：--nova-arg max_steps=5 --nova-arg headless=true。利用可能なすべてのオプションを確認するには、任意のコマンドで--helpを実行してください。

重要： ブラウザーコマンドを実行する前に、ユーザーがすでに指定していない限り、画面に表示するブラウザーとヘッドレスモードのどちらを使用するか尋ねてください。適宜--headedまたは--headlessを使用します。

⚠️ 重要：Chrome または Chromium のプロセスを絶対に終了しないでください（例：pkill chrome、kill -9 $(pgrep chrome)、killall Google Chrome）。Nova Act はブラウザーのライフサイクルを自ら管理します。外部からブラウザープロセスを終了すると、セッション状態が破損し、自動化が機能しなくなります。ブラウザーが応答しない場合は、act browser sessionsで状態を確認するか、新しいセッションを開始してください。

💡 ローカルホストでの HTTPS テスト：ローカル HTTPS サーバー（例：https://localhost:8443）をテストする場合、Chrome はデフォルトで自己署名証明書を拒否します。これを回避するには、--launch-arg=--ignore-certificate-errors --ignore-https-errorsを追加します。

act browser goto https://localhost:8443 --session-id dev --launch-arg=--ignore-certificate-errors --ignore-https-errors

⚠️ --ignore-certificate-errorsは、ローカルホストの開発サーバーでのみ使用してください。ローカル以外の URL では、検証を回避する特別な理由がない限り、有効な証明書を使用してください。

コマンドの詳細：references/browser_cli.md

オプション B：Python スクリプト（繰り返し実行する自動化に推奨）

from nova_act import NovaAct

with NovaAct(starting_page="https://example.com") as nova:
    nova.act("click the first link on the page")
    result = nova.act_get("What is the page title?")
    print(f"Page title: {result.response}")

テストガイドの全文：references/qa_tests.md

ステップ 3：インストールを検証する

• Python 3.10 以降：python --version
• Nova Act SDK：pip install 'nova-act[cli]' / pip show nova-act
• Google Chrome（任意）：playwright install chrome

ステアリングファイル

クイックスタート： 探索または自動化する URL を受け取ったら、まず references/browser_cli.md を確認してください。

ファイル	内容
references/browser_cli.md	ブラウザー CLI — コマンド、セッション、設定、ページ探索。対話型の作業とエージェントのツール使用でのデフォルトです。ファイル全体を必ず読んでください — 正しく使用するために不可欠な、重要な CLI のベストプラクティス、コマンド選択ガイド、実行例が含まれています
references/qa_tests.md	スクリプト作成 — pytest/unittest による QA テスト、act() と act_get() の違い、スキーマ、アサーションのパターン
references/deployment_cli.md	デプロイ CLI — AWS の AgentCore Runtime へのワークフローのデプロイ
references/authentication.md	API キーと IAM、セッション管理
references/workflow_definitions.md	AWS CLI を使用したワークフロー定義
references/data_extraction.md	Pydantic による構造化データの抽出
references/hitl.md	人による承認と UI の引き継ぎパターン
references/tool_use.md	外部ツール（@tool デコレーター、MCP サーバー）
references/agentcore_browser.md	AgentCore 経由のリモートブラウザー
references/playwright_interop.md	Playwright ページへの直接アクセス、機密情報の入力、ファイルのダウンロード
references/session_logs.md	ログ、スクリーンショット、動画録画
references/trajectory_analysis.md	Nova Act の軌跡の理解
references/visual_reporting.md	ビジュアルレポート — steps.yaml、スナップショット、スクリーンショットから作成するセッション後の Markdown レポート
references/gherkin_testing.md	Gherkin テスト — .feature ファイルの作成、qa-plan によるコンパイル、セッションのエクスポートから Gherkin への変換
references/flow_discovery.md	フローの発見 — アプリの実地探索からコードベースのマッピング、開発者向けオンボーディングドキュメントの作成
references/bug_reproduction.md	バグの再現 — 再現 → 証拠の取得 → エクスポート → 回帰テスト
references/parallel_sessions.md	並列セッション — サブエージェントを使った複数のブラウザーセッションの同時実行、チャンク化、セッション数の制限
references/workflow_refinement.md	ワークフローの改良 — 思考の連鎖を分析し、失敗パターンを特定して、ブラウザー自動化ワークフローを修正・検証
references/mock_generation.md	モックの生成 — 実際のサイトの軌跡から静的 HTML のモックサイトを生成し、オフラインでの迅速な反復を実現

このスキルでは、Apache-2.0 ライセンスの Nova Act SDK を使用します。