この教材の目次を開く
回答はこのページを開いている間だけ保持します。別ページへの移動や再読み込みで消えます。保存されるのは読み方の設定だけです。
「保存済みです。」と表示された回答は、同じブラウザーでこの教材を開き直すと復元できます。
1開発を支えるエージェント
動くコードの案ができたら、もう使ってよいのでしょうか。
合ったのは、どの例?
この話で学ぶこと:四人例は合うが、要件に含まれる二人例は違う。変更案を未採用のまま、要件・差分・試験範囲を確認する。
コマは上から下へ、横に並んだコマは右から左へ読みます。
会話を文章で読む
場面:共同作業スペース。ハル左、ミオ右。同じPCに「変更案・未採用」「四人例 期待4/結果4」。ミオの一枚の紙は貸出数は人数どおり/二人の例も対象。この時点では修正を終えていません。
ハル「四人の例、合った!」場面:右コマのミオからハルへ読む。同じ一枚の「二人の例も対象」を見せ、ハルが結果を問う。
ミオ「二人のときも、人数どおりだね。」 ハル「そっちの結果は?」場面:左コマもハル左/ミオ右。同じPCに四人例期待4/結果4と二人例期待2/結果1。表示後にハルが不一致を読む。新しい実行や送信はしていません。
ハル「あ、二人の例は一人になってる。」場面:下段右。ミオ右が採用前に直す方針を言い、ハル左が条件と試験範囲をまとめると応じる。同じPCは変更案・未採用、同じ紙をミオが持つ。
ミオ「採用する前に、この違いを直したいね。」 ハル「元の条件と、試した範囲もまとめるよ。」場面:下段左も未採用。PCのメモに「二人例不一致/条件と試験範囲を確認」。ミオが先に話し、ハルが答えます。差分と範囲を渡す方針で、採用・引渡し・本番反映の完了ではない。
ミオ「差分と試した範囲も、一緒に渡そう。」 ハル「変更案ができたことと、採用は別だね。」
サークルの貸出画面の変更案を見る二人。Haruは四人の例で結果が合ったことを喜びますが、Mioが示した元の条件を見直し、二人の例の結果にはまだ違いがあると分かります。変更案を採用済みにせず、元の条件と試験結果を一緒に点検する場面です。
コードを作ることと、変更を取り込むこと
コードは、コンピューターに処理の手順を伝える記述です。コード生成は、その記述をAIに作らせることです。コーディングエージェントは、コードの案だけでなく、関連ファイルの調査、変更、許可された試験、結果に応じた直しなどを進める仕組みです。文章を扱う大規模言語モデル(LLM)に、ファイルや道具を扱う仕組みを組み合わせます。使える作業は環境と権限によって違います。
テストは、決めた入力に対する結果を、期待する結果と比べる試験です。コードを生成できたこと、テストを実行できたこと、試した条件で結果が合ったことは別です。一つの例で合っても、必要な別の例や、変更していないはずの動作まで確かめたとは限りません。依頼の条件に照らして何を試したか、何をまだ試していないかを残します。
プルリクエスト(PR)は、コードと履歴をまとめる保管場所であるリポジトリへ、変更の取り込みを提案し、話し合い、確認するための仕組みです。GitHubでは、差分(変更前後の違い)や試験結果を見て検討できます。PRを作ることと、変更を取り込むことは別の段階です。この教材の例では、取り込みの確認と、本番への反映や公開の確認も別の段階としています。
根拠:Building effective agents(別タブで開く) ↗ / Codex Best practices(別タブで開く) ↗ / About pull requests(別タブで開く) ↗
指示・渡す情報・作業を支える環境
ハーネスは、モデルの周りで、道具の実行、作業中の状態、制約、結果の受け渡しなどを支える仕組みです。ハーネスエンジニアリングでは、必要な資料へ届くこと、使える道具と権限、試験や確認の流れを整えます。例えば「練習用のファイルだけ変更でき、試験結果を受け取り、採用は担当者が判断する」という環境を用意します。指示文だけを詳しくしても、使えない道具や不足した試験が自動でそろうわけではありません。
プロンプトエンジニアリングは、目的・条件・求める出力などの指示を分かりやすく設計することです。コンテキストエンジニアリングは、今の判断に渡す資料・指示・履歴・道具の結果を選び、整えることです。資料を入力へ渡すことは、モデル自体の追加学習、つまり内部の調整値である重みを更新することとは別です。例えば「予約人数を集計する」という指示の改善、現行の集計条件と直前の試験結果を渡す改善、試験を実行して結果を戻す環境の改善は関連しますが、着目する部分が違います。三つは排他的な箱ではなく、組み合わせて整えます。
根拠:Codex as a platform: build on the open agent harness(別タブで開く) ↗ / Codex Best practices(別タブで開く) ↗ / Prompt engineering(別タブで開く) ↗ / Effective context engineering for AI agents(別タブで開く) ↗
開発支援を採用する前の確認
OpenAIのCodexの公式案内も、変更を作るだけでなく、関連するテスト、差分のレビュー、依頼した動作との一致確認を勧めています。レビューは、変更の内容や影響を検討することです。テストに通った表示だけを見るのでなく、試験の範囲、要件との一致、既存の動作への影響を調べます。ここでいう要件は、何ができ、何を変えないかという依頼の条件です。
この教材の開発例は、架空のデータと確認用のコピーで検討します。元の要件、変更箇所、試験結果、未確認を担当者へ渡し、許された範囲で直してから採用を判断します。提案を作る権限を、本番への反映や公開の権限まで広げません。実際にコードを実行したり、PRを送ったりすることは、この教材の練習条件ではありません。
根拠:Codex Best practices(別タブで開く) ↗ / Building effective agents(別タブで開く) ↗ / Codex as a platform: build on the open agent harness(別タブで開く) ↗
図を拡大する ↗図の内容を文章で確認する
この例では、PRは提案の段階。要件、差分、試験範囲、未確認を照合し、不一致を直して担当者が採用を判断する。本番反映/公開は別条件。
- 図から判断すること
- PRを作ること、要件/試験を確認すること、採用判断を区別できる。
- 前提
- 架空の変更案。採用は担当者確認後。特定サービスの必須工程順ではない。
- 図の項目
- PR:変更の取り込みを提案
- 図の項目
- 要件・差分・試験範囲・未確認を照合
- 図の項目
- 条件がそろってから担当者が採用判断
- 図の項目
- 本番への反映/公開は、この例では別条件
- PR:変更の取り込みを提案 → 要件・差分・試験範囲・未確認を照合
- 提案内容を点検へ渡す
- 要件・差分・試験範囲・未確認を照合 → 条件がそろってから担当者が採用判断
- 必要な条件を確認できたときだけ判断へ
- 要件・差分・試験範囲・未確認を照合 → PR:変更の取り込みを提案
- 不一致/不足を残し修正へ戻す
- 画像の条件・注記1
- 条件確認後
- 画像の条件・注記2
- 不一致・不足
- 画像の条件・注記3
- 分類/工程。長さや面積は時間・成功率・件数を示さない。
- 描かない接続と解釈
- 提案から本番/公開への直行線を描かない。PRが常に同じ固定順で開かれると一般化しない。
- 図の尺度
- 分類/工程。長さや面積は時間・成功率・件数を示さない。
全項目・数値・矢印・条件の文章版を下に置いています。長い行は前後の読取位置で、重なる部分を手がかりに続けて読めます。
根拠:About pull requests(別タブで開く) ↗ / Codex Best practices(別タブで開く) ↗
図を拡大する ↗図の内容を文章で確認する
指示を書くこと、今渡す資料等を選ぶこと、道具/制約/結果の実行の仕組みを整えることは関連する。どれか一つだけで残りが完成する意味ではない。資料を渡すことは追加学習とは別。
- 図から判断すること
- 指示、今渡す材料、実行を支える仕組みの相互補完を説明できる。
- 前提
- 同じ架空の開発作業。三つを排他的な製品分類にしない。
- プロンプトエンジニアリング:着目点
- 何を/どの条件で行うかという指示
- プロンプトエンジニアリング:例
- 変えない動作を明示
- コンテキストエンジニアリング:着目点
- 今の判断へ渡す材料
- コンテキストエンジニアリング:例
- 現行要件と直前の試験結果を選ぶ
- ハーネスエンジニアリング:着目点
- 周囲の実行の仕組み
- ハーネスエンジニアリング:例
- 試験の道具/権限/結果を戻す流れ
- 画像の条件・注記1
- 組み合わせて整える
- 画像の条件・注記2
- どれか一つだけで残りが完成する意味ではない。
- 画像の条件・注記3
- 資料を渡すことは追加学習とは別。
- 画像の条件・注記4
- 量的な比較ではなく着目点の比較。各列の面積は効果の大きさを示さない。
- 描かない接続と解釈
- 一方が他方を自動で完了させる線、優劣の階段、重み学習への線は描かない。
- 図の尺度
- 量的な比較ではなく着目点の比較。各列の面積は効果の大きさを示さない。
- 列とまとめ線
- 同じ高さの3列を下の括弧でまとめています。方向を示す矢印や、一つで他が自動完了する因果関係ではありません。
全項目・数値・矢印・条件の文章版を下に置いています。長い行は前後の読取位置で、重なる部分を手がかりに続けて読めます。
根拠:Codex as a platform: build on the open agent harness(別タブで開く) ↗ / Prompt engineering(別タブで開く) ↗ / Effective context engineering for AI agents(別タブで開く) ↗
別の場面で確かめる
全て独自作成の問題です。公式問題や試験全体の難易度を再現したものではありません。
2ブラウザーやPCの操作を任せる
画面をクリックできたことは、用事が済んだことと同じでしょうか。
入力欄と内訳が違う
この話で学ぶこと:確認用端末で三脚を入力したが、内訳は二脚。操作と目標の一致を分け、不一致を残して担当者へ相談する方針を決める。
コマは上から下へ、横に並んだコマは右から左へ読みます。
会話を文章で読む
場面:地域会館ロビー。ハル右→ミオ左。「確認用・外部送信なし」と控え「椅子3脚/確認画面まで」を先に共有。同じ端末1・控え1。ビットは右側の床にいる。
ハル「この端末は、送信しない練習用だね。」 ミオ「椅子は三脚。確認画面まで見よう。」場面:中段右。ハルが「入力欄は三脚」と読む。入力欄3脚で、保存や送信の成功を意味しない。ミオは同じ控えを持つ。
ハル「入力欄は三脚になったよ。」場面:中段左。ミオが内訳2脚を発見。画面は入力3脚/内訳2脚、控えは椅子3脚のまま。入力欄を二脚へ書き換えた場面ではない。
ミオ「でも、内訳は二脚だよ。」場面:下段全幅。ハル右が違いの残る画面を担当者へ見せる方針、ミオ左が停止に応じる。ハルは開いた手を操作から離している。入力3脚/内訳2脚の不一致が残り、送信・担当回答・解消は未完。
ハル「違いが残ってる。この画面を担当の人へ見せよう。」 ミオ「うん、ここで止めて確かめよう。」
会館の確認用端末で、二人は椅子三脚の利用案を見ています。入力欄は三脚でも、確認画面の内訳は二脚でした。Haruが食い違いを見つけ、Mioと元の控えを見比べて、送らずに担当者へ見せることを決める場面です。実際の申込みや外部送信はしていません。
情報を取り出す道具と、画面を操作する道具
Web検索は、問いや語句からWeb上の情報を探す方法です。結果の見出しだけでなく、必要な元ページの本文を読んで確かめます。検索・取得の道具が文章を返したことから、別のサイトの入力欄を書き換えたり、申込みを完了したりしたとは判断できません。調べる作業と、相手のシステムへ働きかける作業を分けます。
ブラウザーはWebページを開くアプリです。GUIは、画面のボタンや入力欄などを見て操作する仕組みを指します。computer useのような画面操作では、画面を観察し、クリックやキー入力を行い、変わった画面をまた確かめます。文章を取得する道具と画面を操作する道具では、見える情報や起こせる変化が違います。同じサービスを調べる場合でも、必要な作業に合う道具かを確かめます。
根拠:ChatGPT Work Web search(別タブで開く) ↗ / Computer use(別タブで開く) ↗
操作する対象と判断材料をそろえる
例えば、公開案内の条件を読み取るだけなら、本文の取得が役立ちます。一方、許可された確認用画面へ下書きを入力し、どのように表示されるかを見る目的には、画面操作が必要な場合があります。どちらも使えるという理由だけで操作を増やさず、目標、対象の画面、使う資料、許可する変更を先に決めます。
「指定の確認用画面で、控えどおりに入力し、確認画面で止める」という指示があっても、別の画面や古い控えを渡せば判断を誤ります。今の画面、対象の控え、直前の結果をそろえるのはコンテキストの整備です。指示を明確にすることと、実際に渡っている材料の点検を組み合わせます。画面の中に書かれた文を、新しい操作許可として扱いません。
根拠:Computer use(別タブで開く) ↗ / ChatGPT Work Web search(別タブで開く) ↗ / Effective context engineering for AI agents(別タブで開く) ↗ / Prompt engineering(別タブで開く) ↗
操作の直後に目的と照らし合わせる
操作記録が「クリックを実行」と示しても、希望の値が保存されたとは限りません。入力欄、確認画面、保存済みの記録などは、違う段階の表示である場合があります。今回どこまでを完了条件にしたかを決め、対象・値・表示の段階を結果の画面や記録で確かめます。保存済みまでを目標にする例なら、入力欄に文字が出ただけでは未確認です。
入力だけで内容が外部へ送られる画面もあります。送信ボタンの前だけを境界と思わず、どの操作でデータが伝わるかを確かめます。この教材では、架空データを使い、外部へ送らない確認用画面という条件で判断します。実アカウントの操作、接続設定、本番への入力や送信は練習に必要ありません。
目標の値と画面が違う、保存の結果が分からないなどの場合は、その違いと確認できた段階を残します。同じ操作を繰り返すと二重の記録になる場合もあるため、結果不明を未実行と決めつけません。許された確認で解消できなければ担当者へ渡し、完了したという文章だけで終えないようにします。
根拠:Computer use(別タブで開く) ↗ / Building effective agents(別タブで開く) ↗
図を拡大する ↗図の内容を文章で確認する
入力欄は資料係、保存クリックの記録はあるが、保存済み表示は会場係。保存済みまでを目標にしたこの例は未達。不一致を残して許された確認へ、解消できなければ担当へ戻す。
- 図から判断すること
- 入力の表示やクリック記録から、保存済みの目標達成を飛躍して認定しない。
- 前提
- 架空/確認用/外部送信なし。目標は保存済み配布表の担当が「資料係」であると確かめること。
- 入力欄:観測
- 資料係
- 入力欄:意味
- 入力の見た目は合う
- 操作記録:観測
- 保存をクリック
- 操作記録:意味
- 操作は記録された
- 保存済み表示:観測
- 会場係
- 保存済み表示:意味
- 目標と不一致
- 画像の条件・注記1
- 保存済みまでを目標にしたこの例は未達。
- 画像の条件・注記2
- 不一致を残して許された確認へ、解消できなければ担当へ戻す。
- 画像の条件・注記3
- 三欄は状態の分類で、達成率の三等分ではない。
- 入力と保存の結果を分ける
- クリックの記録で分かるのは、保存ボタンを押したことです。入力欄と保存済みの表示は別の段階です。保存までが目標なら、保存済みの値を目標と照らします。
- 図の尺度
- 三欄は状態の分類で、達成率の三等分ではない。
全項目・数値・矢印・条件の文章版を下に置いています。長い行は前後の読取位置で、重なる部分を手がかりに続けて読めます。
別の場面で確かめる
全て独自作成の問題です。公式問題や試験全体の難易度を再現したものではありません。
3調査と業務への導入を考える
出典の付いた報告ができたら、そのまま仕事を任せてよいのでしょうか。
二件の案内で、三候補と言える?
この話で学ぶこと:三候補のうち案内はA/Bだけ。元の条件を読み比べ、C未取得を隠さず、案内とメモを検証担当へ渡す方針を決める。
コマは上から下へ、横に並んだコマは右から左へ読みます。
会話を文章で読む
場面:図書館。ミオ左/ハル右、机にA要項・B要項・調査メモの3枚、鉛筆1本。A雨天利用可・要申込み、B屋内のみ・要申込み。C未取得と未確認の「三候補とも利用可」が見える。ビットは奥の台の端に見える。
ミオ「下書きは早くできたよ。案内は二件分。」場面:中段右。ハル右からミオ左へ。メモの候補A/B/C・取得A/Bのみ・C未取得に気づき、下書きは確定できないと話す。原資料Cはない。
ハル「候補は三つ。Cの案内はまだなんだね。」 ミオ「うん。だから、この下書きは確定できないね。」場面:中段左。ハル右が元の根拠を問い、ミオ左がAの条件を指す。A/Bとメモ3枚、鉛筆1。
ハル「元の案内の、どこが根拠?」 ミオ「Aの条件は、ここから確かめよう。」場面:下段右。ハル右が鉛筆で同じメモへ「A/Bは条件を照合、Cは未取得」。旧「三候補とも利用可」は線と赤い未確認注記つきで残る。赤い注記は2本目のペンではない。
ハル「調べた所と、残る所を分けて書くよ。」場面:下段左も同じ修正メモの未確認とA/B照合・C未取得を保持。ハル右の鉛筆は紙から離れ、ミオ左と元の案内・残る確認を渡す方針を話す。机には三つの資料が残っている。引渡しや利用承認・申込みの完了はない。
ハル「早く下書きができても、まだ確認があるね。」 ミオ「元の案内と、残る確認も一緒に渡そう。」
図書館で、雨の日の展示先三候補を調べる二人。Mioが持参した二件分の案内と調査メモを机へ並べ、Haruが未取得の三件目に気づきます。「三候補とも利用可」という下書きを確定せず、調べた範囲と残る確認を分けて担当へ渡すことを決める場面です。
調べる範囲と、言える範囲を分ける
ディープリサーチは、一つの検索結果を要約するだけでなく、問いを分け、複数の資料を探し、読み比べ、必要な追加調査をして報告へまとめるような調査を指します。使う道具や具体的な進め方はサービスや構成によって異なります。OpenAIのWork向け公式案内にも、複数の情報源を調べ、報告とその出典を確認するDeep researchの利用例があります。すべての製品に同じ手順や利用条件があるという意味ではありません。
調査は、目的、対象、時点、比較したい条件を決めて始めます。報告には、どの資料のどの記述から言えることかと、まだ取得・確認できていない範囲を残します。引用リンクの数が多いことや、長い報告になったことは、必要な対象をすべて調べた証拠にはなりません。根拠の届く範囲を越えて「全体でも同じ」と広げないことが大切です。
例えば、一部の施設だけの案内で分かった利用条件を、未取得の施設にも当てはめません。複数の資料の条件が食い違えば、出所・対象・適用日を比べ、解消できない違いを報告へ残します。資料の記載そのものと、それをもとに考えた提案や推測も区別します。これらの根拠照合は既習事項で、調査範囲全体へ応用します。
根拠:ChatGPT Work Web search(別タブで開く) ↗ / Building effective agents(別タブで開く) ↗ / Effective context engineering for AI agents(別タブで開く) ↗ / NIST AI Risk Management Framework(別タブで開く) ↗
調査・検証・承認の担当を決める
役割分担は、誰が何を行い、何を次の担当へ渡し、誰が最終判断するかを決めることです。調査役が出所と未確認をそろえ、検証役が原資料と報告を照合し、承認役が利用や送信を判断する例があります。複数AIを連携させるマルチエージェントでも、人を含む分担でも、引継ぎに元の条件と根拠を残す必要があります。人数やAIの数を増やすだけで正確になるわけではありません。
二つの担当が同じ誤った要約だけを読み、同じ結論を返した場合、その一致を原資料の検証が二重に済んだ証拠にはできません。検証役には照合すべき原資料や確認条件を渡します。外へ出せる文を作る役と、実際に外へ送る権限も分けます。顧客の氏名や連絡先などを条件なしに渡さず、今回の仕事に必要で、利用が認められた情報に絞ります。
根拠:Building effective agents(別タブで開く) ↗ / Effective context engineering for AI agents(別タブで開く) ↗ / NIST AI Risk Management Framework(別タブで開く) ↗
道具の名前より、業務全体で比べる
導入を比べるときは、「何を改善したいか」「AIに渡す情報と許す操作」「成果をどう確かめるか」をそろえます。下書きが速くできても、人の確認や差し戻しが増えれば、仕事全体の負担は減らないかもしれません。目的に合う単位で、必要な確認の抜けと、確認・修正まで含む作業量を比べます。決まった少数の資料をまとめるだけなら、単純な手順や人の作業で十分な場合もあります。
業務自動化エージェントは、繰り返す仕事を、入力を読む、処理する、結果を担当へ渡すといった工程に分け、許された範囲で進める仕組みです。たとえば、受付表から定型の確認カードを作る作業なら、確定した項目だけでカードの下書きを作り、情報が足りない場合は担当へ戻します。どこまで自動化できるかと、送信や登録をしてよいかは別に決めます。
まず架空データと限定した確認用の流れで試し、調査、下書き、検証、採用のどこを任せるかを決めます。利用中の記録と担当への戻し方も用意し、資料や道具の変更後は確認を見直します。事前の評価や利用中の監視はGA305の反復です。この節で加えるのは、それらを開発・画面操作・調査という違う仕事の成果と引継ぎへ結び、導入条件を比較する判断です。
根拠:Building effective agents(別タブで開く) ↗ / NIST AI Risk Management Framework(別タブで開く) ↗
図を拡大する ↗図の内容を文章で確認する
五候補中P/Q/Rの三件を取得、S/Tの二件は未取得。三件の資料に届く比較を作り、未取得を残し、検証担当へ元資料とともに渡す。引用の数は対象の網羅や内容の正しさを保証しない。
- 図から判断すること
- 一部の取得を全候補の検証へ広げず、元資料と未取得を引き継ぐ。
- 前提
- 架空の五候補P/Q/R/S/T。P/Q/Rの要項を取得し、S/Tは未取得。公開や申込みの許可は与えていない。
- 図の項目
- 取得したP/Q/Rの原資料
- 図の項目
- 3件の根拠/2件未取得を記した報告
- 図の項目
- 検証担当が原資料と報告を照合
- 候補P
- 取得済み
- 候補Q
- 取得済み
- 候補R
- 取得済み
- 候補S
- 未取得
- 候補T
- 未取得
- 取得したP/Q/Rの原資料 → 3件の根拠/2件未取得を記した報告
- 取得範囲に基づきまとめる
- 3件の根拠/2件未取得を記した報告 → 検証担当が原資料と報告を照合
- 結論・対象・時点・未取得を渡す
- 取得したP/Q/Rの原資料 → 検証担当が原資料と報告を照合
- 照合できる元資料も渡す
- 量と単位
- 5候補(対象候補)
- 量と単位
- 3件(取得済み)
- 量と単位
- 2件(未取得)
- 画像の条件・注記1
- 五候補中、取得済み3件・未取得2件。
- 画像の条件・注記2
- 引用の数は対象の網羅や内容の正しさを保証しない。
- 画像の条件・注記3
- 候補ごとに同じ1行。棒グラフ/円グラフ/精度表示ではない。
- 描かない接続と解釈
- 未取得S/Tから確認済みの結論へ線を引かない。検証担当を増やすだけの保証、外部送信の自動線を描かない。
- 図の尺度
- 候補ごとに同じ1行。棒グラフ/円グラフ/精度表示ではない。
- 元資料の注記
- 緑の「元資料」は点線の引継ぎ経路の注記で、追加の工程ではありません。S/Tから確認済みの結論への線はありません。
全項目・数値・矢印・条件の文章版を下に置いています。長い行は前後の読取位置で、重なる部分を手がかりに続けて読めます。
根拠:ChatGPT Work Web search(別タブで開く) ↗ / Effective context engineering for AI agents(別タブで開く) ↗ / Building effective agents(別タブで開く) ↗
別の場面で確かめる
全て独自作成の問題です。公式問題や試験全体の難易度を再現したものではありません。


