指摘を反映して版を上げる

未解決のコメントを本文に反映し、新しい版を上げて、コメントに返信して解決するまでの手順。

コメントで受けた指摘を本文に反映し、新しい版として上げてから、反映したことをコメントへ返すまでの流れです。取り込み用トークンとエージェント用トークンの両方を使います。

export ORIGIN=https://comment-review.fsmarketing.workers.dev

流れ

未解決のコメントを読む（コメントを読む）。
指摘に沿って HTML を直す（手元で行う）。
直した HTML を新しい版として上げる（文書を上げるの「版を追加する」）。
run を開始し、反映したコメントに返信して解決し、run を終える。

4. 返信して解決する

版を上げた後に、文書を読み直して commentsRevision を取り、run を開始します。

curl -X POST "$ORIGIN/api/reviews/review_example01/ai-review-runs" \
  -H "Authorization: Bearer $CR_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"baseCommentsRevision": 7, "targetVersionId": "v2", "title": "第 2 稿の反映"}'

版が 2 つ以上ある文書では、targetVersionId に最新の版の ID を入れます。最新の版の ID は、文書の応答の review.source.versions の最後の要素の versionId です（review.version は文書の形式の番号で、版の ID ではありません）。

反映したコメントごとに、返信してから解決します。

curl -X POST "$ORIGIN/api/reviews/review_example01/comments/comment_example01/thread" \
  -H "Authorization: Bearer $CR_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"runId": "airun_example01", "body": "第 2 稿で税込の表記にしました。", "dedupeKey": "applied-comment_example01"}'

curl -X POST "$ORIGIN/api/reviews/review_example01/comments/comment_example01/status-events" \
  -H "Authorization: Bearer $CR_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"runId": "airun_example01", "event": {"status": "closed"}}'

最後に run を終えます。手順はエージェントがコメントを書くの「run を終える」と同じです。

気をつけること

反映しなかった指摘は解決せず、理由を返信で伝えてください。
人が書いたコメントの本文は直せません。返信で伝えます。