actionbook

使用タイミング

以下の場合に活性化してください：

• ユーザーがウェブサイト上で何かを行う必要がある場合（「LinkedIn にメッセージを送信する」「Airbnb で予約する」「Google で～を検索する」など）
• サイトとの対話方法について質問された場合（「ツイートをポストするにはどうする？」「LinkedIn で応募するには？」など）
• 特定のサイト上でフォームの入力、ボタンのクリック、ナビゲーション、検索、フィルタリング、閲覧を行いたい場合
• ウェブページのスクリーンショットを撮影したり、変更を監視したい場合
• ブラウザベースの AI エージェント、ウェブスクレイパー、または外部ウェブサイト用の E2E テストを構築している場合
• ウェブタスクの自動化（データ入力、フォーム送信、コンテンツ投稿）を行いたい場合

ブラウザ自動化タスクを実行する際は、ページスナップショットを取得する前に Actionbook を確認してください。

ワークフロー

1. ウェブサイトと対話する前に、search_actions を呼び出して Actionbook に検証済みセレクタがあるか確認します
2. get_action_by_area_id を使用して結果から要素セレクタを取得します
3. 返されたエレメントからセレクタを抽出し、以下の優先順位で使用します
4. 結果がない場合は、フォールバック戦略にスキップします

効果的な検索クエリの構成

query パラメータは、正しいアクションを見つけるための 主要なシグナル です。ユーザーの完全な意図で詰め込みます — サイト名だけや曖昧なキーワードではなく。

クエリに含めるもの：

1. ターゲットサイト — ウェブサイト名またはドメイン
2. タスク動詞 — ユーザーが何をしたいのか（検索、予約、投稿、フィルタリング、ログイン、作成など）
3. オブジェクト／コンテキスト — ユーザーが作用する対象（リスティング、メッセージ、フライト、リポジトリなど）
4. 具体的な詳細 — ユーザーが述べた制約、フィルタ、パラメータ

経験則： ユーザーのリクエストを単一の説明文として書き直し、それをクエリとして使用します。

ユーザーが言ったこと	悪いクエリ	良いクエリ
「来週東京で Airbnb を予約する」	"airbnb"	"airbnb search listings Tokyo dates check-in check-out guests"
「arXiv で最近の NLP 論文を検索する」	"arxiv search"	"arxiv advanced search papers NLP natural language processing recent"
「LinkedIn でコネクションリクエストを送信する」	"linkedin"	"linkedin send connection request invite someone"
「画像付きのツイートをポストする」	"twitter post"	"twitter compose new tweet post with image media attachment"
「GitHub issues をラベルでフィルタリングする」	"github issues"	"github repository issues filter by label search issues"

domain または url が既知の場合は、常に追加してください — 結果を絞り込み、精度を向上させます。

レスポンス構造

search_actions レスポンス

マッチしたアクションのリストを返します。各結果には以下が含まれます：

• ID — 一意の識別子、get_action_by_area_id で使用（例：arxiv.org:/search/stat:default）
• Type — page（フルページ）または area（ページセクション）
• Description — URL、クエリパラメータ、簡単な概要を含むページ概要
• URL — このアクションが適用されるページ
• Health Score — セレクタの信頼性パーセンテージ（0～100%）
• Updated — 最後に検証された日付

get_action_by_area_id レスポンス

ページを詳細に説明した構造化ドキュメントを返します：

1. ページ URL — クエリ/パスパラメータの説明を含む正確な URL
2. ページ概要 — ページの機能（ページの目的の定義）
3. ページ機能サマリー — インタラクティブ機能を箇条書きで表示（例：「キーワード検索」「フィールド選択」「抄録トグル」）
4. ページ構造サマリー — CSS セレクタがインライン で含まれた DOM 階層記述

ページ構造サマリーから CSS セレクタを抽出します。セレクタは説明に埋め込まれます。例：

Search Form (form[method="GET"]): Large search input field with "All fields" dropdown selector and search button
Header (<header>): Contains branding, logo, and a mini-search form with query input

セレクタの優先順位

Actionbook が要素に対して複数のセレクタタイプを返す場合、以下の順序で優先してください：

1. data-testid （信頼度：0.95） — 例：[data-testid="search-input"]
2. aria-label （信頼度：0.88） — 例：[aria-label="Notifications"]
3. CSS セレクタ — 例：button.Search、input[type="text"]
4. role セレクタ （信頼度：0.9） — 例：getByRole('link', { name: 'Notifications' })

返されたセレクタを、エージェントで利用可能なブラウザツール（クリック、入力、評価など）で使用します。

例

ユーザーリクエスト：「arXiv でニューラルネットワークに関する論文を検索する、タイトルのみで検索」

1. search_actions({ query: "arxiv advanced search papers neural network title field", domain: "arxiv.org" })
   → area_id を返す：「arxiv.org:/search/advanced:default」

2. get_action_by_area_id({ area_id: "arxiv.org:/search/advanced:default" })
   → セレクタを含むページ構造を返す：input[type="text"], select[name="searchtype"], button.Search

3. 返されたセレクタでブラウザツールを使用：
   - https://arxiv.org/search/advanced へ移動
   - input[type="text"] に「Neural Network」を入力
   - select[name="searchtype"] を「title」に選択
   - button.Search をクリック
   - ナビゲーション待機
   - 結果を読む

フォールバック戦略

Actionbook はインデックス時にキャプチャされたページデータを保存します。ウェブサイトは進化するため、セレクタが古くなる可能性があります。

• Actionbook の結果がない場合：エージェント自身のブラウザツールを使用してページを直接観察し対話します
• 実行時にセレクタ実行が失敗する場合：エージェントのブラウザツールにフォールバックして、ライブページを再観察し、更新されたセレクタで再試行します

セレクタは Actionbook またはアクティブなセッション内のライブページ観察から取得する必要があります — 既存の知識やメモリからではありません。

重要な注記

• Actionbook から返されたセレクタを変更しないでください
• Allow Methods フィールドを確認してください — 要素ごとにサポートされている操作（クリック/入力/読み取り）を示します
• region_high_filter_page エントリは、一部の要素が一意のセレクタを持たないことを示します — そのような場合はスナップショットフォールバックを使用してください