Human Relay：Agentの確認依頼・人の回答・作業再開

人へ頼る前に確認する

例：「スマホ幅の自動確認は通ったが、片手でメニューを閉じやすいかは実機で判断してほしい」。通常のlintを人へ依頼する理由にはしません。

1. 接続元でrequest_human_reviewとlist_human_requestsが見えることを確認します。
2. 元Questとget_current_agent_contextを読み、自分が担当する登録済みAgentであることを確認します。
3. 自動テストやビルドなど実行できる確認を済ませます。人が必要な理由を具体的に残します。
4. list_human_requestsをsourceQuestIdとstatus=allで読み、未回答・保留中の依頼がないか確認します。

確認対象を明記して依頼する

次のJSONはrequest_human_reviewのプレビューです。questIdは元Questの実際のIDに置き換えます。requestKeyは同じ確認ラウンドで固定します。

1. プレビューで依頼先と元Questを確認します。必要な成果物リンクはartifactUrlへHTTPSで付けられます。
2. 最新の元QuestのupdatedAtをexpectedUpdatedAtに付け、許可された依頼をdryRun=falseで保存します。
3. 人へ確認場所と回答先を案内します。外部リンクを開いただけでは確認済みや承認にしません。

{
  "questId": "REPLACE_WITH_SOURCE_QUEST_ID",
  "requestKey": "mobile-menu-review-1",
  "title": "スマホのメニュー操作を確認",
  "reason": "自動検証は通ったが、片手の操作感は実機確認が必要",
  "checkTarget": "普段のスマホで対象画面を開き、メニューを開閉してリンクを押す",
  "completionCriteria": "変更不要か、修正したい場所と理由をテキストで回答する",
  "dryRun": true
}

人が確認して回答を保存する

回答は対象の本人がWeb認証で行います。Agentは普通のQuest更新やscore_questで代筆・確認完了にできません。

1. Web Appの自分宛て確認依頼を開き、理由・確認対象・完了条件を読みます。
2. 指定の外部画面や実機で確認します。今できない場合は保留にし、後で再開します。
3. 変更不要ならその結果を、修正が必要なら「閉じるボタンが押しにくいので位置を変えてほしい」など具体的なテキストを保存します。
4. 確認したことを明示して回答します。既読、保留、リンクを開いたことは回答完了と別です。

回答を読んで修正・再開する

1. Agentはlist_human_requestsで元Questの回答を再取得し、humanRequest.responseとoutcomeを読みます。
2. changes_requestedなら元のHandoffをworkingへ戻し、保存された指摘に沿って修正・検証します。
3. 再確認は新しいrequestKeyで別ラウンドを作ります。過去の回答は上書きしません。
4. approvedなら承認内容を確認します。確認Quest完了、Handoff accepted、元Quest完了は、それぞれの条件に沿って別操作として扱います。

再送・競合・未回答の診断