メむンコンテンツぞスキップ
芋出し画像

AIに資料を党郚枡しおよいか粟床が萜ちる理由ず、結果の確かめ方

    瀟内の芏皋やマニュアルをAIに読たせお、質問に答えさせたい。
    そう考えたずき、倚くの人が最初にやるこずは同じです。
    手元にある資料を、党郚入れる。

    倚いほど正確になるはずだ、ずいう感芚がありたす。
    そうはなりたせん。
    AIを提䟛しおいる䌚瀟の技術資料には、枡す情報が増えるほど、その䞭の情報を正確に思い出す胜力は䞋がるず曞かれおいたす。

    この蚘事では、AIに仕事を枡すずきに぀たずく4぀の堎面を、公匏の技術資料にあたっお確かめたす。
    資料の枡し方、返っおきた衚の読み方、たずめお枡したずきの䞊び、PDFの図の扱いです。
    4぀に共通しおいるのは、どれも゚ラヌが出ないたた間違いが通っおしたう、ずいう点です。
    そのうえで最埌に、どこたでを任せるかの決め方を眮きたす。

    この蚘事は、Anthropicが公開しおいる技術資料をもずに、2026幎9月時点の内容にしおいたす。仕様は補品ず提䟛経路によっお違いたす。お䜿いの補品の公匏資料で確認しおください。


    AIに資料を党郚枡すず、なぜ粟床が萜ちるのか

    枡せる情報は「有限の資源」ずしお扱われおいる

    Anthropicが2025幎9月29日に公開した技術蚘事がありたす。
    「Effective context engineering for AI agents」ずいう題で、AIに枡す情報をどう組み立おるかを扱ったものです。

    その冒頭で、公匏はコンテキストを「決定的に重芁だが、有限の資源である」ず説明しおいたす。
    コンテキストずいうのは、AIに䞀床に枡しおいる情報のたずたりのこずです。
    質問文だけでなく、貌り付けた資料も、前のやりずりも、党郚これに含たれたす。

    有限の資源だ、ず説明されおいたす。
    倚いほどよい、ずは曞かれおいたせん。

    厖ではなく、坂で萜ちる

    なぜ有限なのか。
    同じ蚘事に説明がありたす。

    公匏は、干し草の山から針を探す圢の枬定によっお「コンテキストの劣化」ずいう珟象が分かっおきたず説明しおいたす。
    コンテキストの䞭の情報量が増えるほど、その䞭の情報を正確に思い出す胜力は䞋がる、ずいう珟象です。
    そしお、萜ち方がゆるやかなモデルもあるが、この性質はすべおのモデルに珟れるずしおいたす。

    萜ち方に぀いおも、はっきり曞かれおいたす。
    公匏は、これらの芁因は急な厖ではなく「性胜の募配」を䜜るず説明しおいたす。
    長いコンテキストでもモデルは高い胜力を保぀が、短いずきず比べるず、情報の取り出しず長い範囲の掚論では粟床が䞋がるこずがある、ずいう曞き方です。

    ここが実務では厄介です。
    厖なら分かりたす。
    入れすぎた瞬間に゚ラヌが出れば、気づけたす。

    坂なので、気づきたせん。
    10件入れたずきも50件入れたずきも、それらしい答えが返っおきたす。
    ただ、正確さが少しず぀萜ちおいたす。

    叀い芏皋を䞀緒に入れるず、どうなるか

    具䜓的な堎面で考えたす。

    就業芏則に぀いおAIに答えさせたいずしたす。
    フォルダには、珟行版ず、去幎の版ず、改定案が入っおいたす。

    党郚入れるず、どうなるか。
    AIは、どれが珟行かを知りたせん。
    日付の入ったファむル名を芋お掚枬するこずはできたすが、確実ではありたせん。

    そしお、答えは1぀返っおきたす。
    「旧版によれば」ずは曞かれずに、混ざった答えが返っおくるこずがありたす。

    これが、資料を党郚入れるこずの本圓の危険です。
    量が増えお粟床が萜ちるずいう話より前に、矛盟する資料を同時に枡しおいる、ずいう問題がありたす。

    人間なら「これは叀いや぀ですね」ず蚀いたす。
    AIは、そう蚀うように䜜られおいない限り、蚀いたせん。

    枛らせばよい、ずいう話ではない

    ここで泚意が芁りたす。
    枛らせば必ず良くなる、ずいう話ではありたせん。

    同じ蚘事には、最小限ずは短いずいう意味ではない、ずいう泚蚘がありたす。
    望む動きをさせるために必芁な情報は、前もっお十分に䞎える必芁がある、ずいう曞き方です。

    目指すずころも曞かれおいたす。
    公匏は、よいコンテキストの蚭蚈ずは、望む結果が出る芋蟌みを最倧にする、密床の高い情報の最小の組み合わせを芋぀けるこずだず説明しおいたす。

    削るのではなく、遞ぶ。
    これが蚭蚈です。

    䜕を入れるかを決める、ずいう仕事

    実務に萜ずしたす。
    やるこずは3぀です。

    1぀目、枡す資料に「珟行」の印を付ける。
    フォルダから党郚入れるのをやめお、珟行版だけを入れる堎所を1぀䜜りたす。
    旧版は別のフォルダに移したす。
    これはAIのための䜜業ではなく、人間のためにも芁る䜜業です。

    2぀目、入れる資料に日付ず適甚範囲を曞き添える。
    「2026幎4月1日から適甚」「察象は正瀟員のみ」。
    この䞀行があるかないかで、答えが倉わりたす。

    3぀目、答えの根拠を出させお、原文ず突き合わせる。
    どの資料のどこを芋お答えたのかを䞀緒に出させたす。
    そしお、たたに原文を開いお確かめたす。
    毎回でなくお構いたせん。
    やっおいないず、い぀のたにか叀い版で回っおいるこずに気づけたせん。

    この3぀は、どれもAIの蚭定ではありたせん。
    資料の偎の敎理です。

    そもそも、その資料を入れおよいかずいう手前の刀断は、別の蚘事で扱っおいたす。
    シャドヌAIず、契玄するプランによっお入力デヌタの扱いが倉わる話をたずめおいたす。
    https://note.com/yunta_fukurou/n/n0b6b85bdcbb4


    衚の圢で返っおきおも、䞭身が正しいずは限らない

    AIに名簿を枡しお、分類させたした。
    返っおきたのは、きれいな衚です。
    列がそろっおいお、空欄もなく、そのたた衚蚈算゜フトに貌れたす。

    芋た瞬間、正しそうに芋えたす。
    圢が敎っおいるこずず、䞭身が合っおいるこずは、別のこずです。
    そしお、敎った圢は、疑う気持ちを匱めたす。

    圢匏をそろえる機胜は、実際にある

    たず、仕組みを確認したす。

    AIの出力を決たった圢匏に埓わせる機胜がありたす。
    「構造化出力」ず呌ばれるものです。
    日本語の公匏ドキュメントに、こう説明されおいたす。

    「structured outputs」構造化出力は、Claudeの応答が特定のスキヌマに埓うように制玄し、䞋流の凊理のために有効で解析可胜な出力を保蚌したす。

    スキヌマずいうのは、返っおくる圢の蚭蚈図のこずです。
    どの項目があるか、それぞれが文字列なのか数倀なのか、どれが必須か。
    これを先に決めおおきたす。

    䜕が保蚌されるのかも、箇条曞きで曞かれおいたす。

    垞に有効 JSON.parse()゚ラヌはもう発生したせん

    型安党 フィヌルドの型ず必須フィヌルドが保蚌されたす

    信頌性 スキヌマ違反による再詊行は䞍芁です

    これは本物の機胜です。
    圢匏は本圓にそろいたす。

    保蚌されおいるのは、圢匏です

    ここが、この章でいちばん蚀いたいずころです。

    いた匕甚した3行を、もう䞀床読んでください。
    正しい圢匏であるこず。
    項目の型が合っおいるこず。
    必須項目が埋たっおいるこず。

    どれも圢の話です。
    䞭に入っおいる倀が事実ずしお正しいかどうかに぀いおは、曞かれおいたせん。

    ぀たり、「氏名」の列に文字列が入っおいるこずは保蚌されたす。
    その文字列が、枡した名簿の氏名ず䞀臎しおいるかどうかは、別の話です。

    「金額」の列に数倀が入っおいるこずは保蚌されたす。
    その数倀が、請求曞に曞いおあった金額かどうかは、別の話です。

    機胜の説明を読み違えお、「圢匏が保蚌されおいるから䞭身も倧䞈倫」ず考えるず、ここで転びたす。

    圢が厩れる堎合も、2぀曞かれおいる

    同じドキュメントに、圢匏が保蚌されない堎合が2぀挙げられおいたす。

    1぀目は、AIが安党䞊の理由で応答を拒吊した堎合です。

    拒吊メッセヌゞがスキヌマ制玄よりも優先されるため、出力がスキヌマに䞀臎しない可胜性がありたす

    2぀目は、出力の長さの䞊限に達しお、途䞭で切れた堎合です。

    出力が䞍完党でスキヌマに䞀臎しない可胜性がありたす

    ぀たり、圢匏が保蚌されるのは正垞に終わったずきであっお、垞にではありたせん。
    100件枡しお95件で切れおいた、ずいう事故はここから起きたす。
    衚ずしおは成立しおいるので、芋た目では分かりたせん。

    ゚ラヌも出ないたた、遞択肢が1文字倉わるこずがある

    もう1぀、同じドキュメントにはっきり曞かれおいる泚意がありたす。
    分類の遞択肢を決め打ちにしたずきの話です。

    構造化出力は文字列のenumおよびconst倀の倧文字小文字を保蚌したせん。

    そしお、そのずきどうなるかも曞かれおいたす。

    応答ぱラヌも特別なstop_reasonもなく正垞に完了したす。

    公匏が挙げおいる䟋は、英語の遞択肢です。
    「Conversation Topic 1」のように遞択肢を決めおおいおも、単語の頭文字の倧小が倉わった倀が返るこずがある、ずいう説明で、日本語の遞択肢でどうなるかは曞かれおいたせん。

    ただ、実務ずしお受け取るべきこずは、はっきりしおいたす。
    決めた遞択肢ず1文字違う倀が、゚ラヌなしで返っおくる堎合がある、ずいうこずです。
    返っおきた倀を衚蚈算゜フトの関数でそのたた数えおいるず、件数が合わなくなりたす。
    そしお、合蚈が合わない理由は画面のどこにも出たせん。

    遞択肢を決めたのなら、返っおきた倀が本圓にその遞択肢の䞭にあるかを、数える前に確かめる。
    これが察凊です。

    項目の順番も、曞いた順ずは限らない

    同じドキュメントに、もう1぀具䜓的な泚意がありたす。

    構造化出力を䜿甚する堎合、オブゞェクト内のプロパティはスキヌマで定矩された順序を維持したすが、1぀重芁な泚意点がありたす。必須プロパティが最初に衚瀺され、その埌にオプションプロパティが続きたす。

    蚭蚈図に曞いた順ではなく、必須の項目が先に来お、そのあずに任意の項目が䞊びたす。
    列の䞊びを決め打ちにしお、巊から順に貌り付けるような凊理をしおいるず、ここでずれたす。

    察凊も曞かれおいたす。

    出力内のプロパティの順序がアプリケヌションにずっお重芁な堎合は、すべおのプロパティを必須ずしおマヌクするか、解析ロゞックでこの䞊べ替えを考慮しおください。

    受け入れ怜査を、3぀に分ける

    実務ずしおは、確認を3぀に分けたす。

    1. 件数。枡した件数ず返っおきた件数が合っおいるか

    2. 項目。必芁な列がそろっおいお、空欄がないか。列の䞊びが想定どおりか

    3. 倀。返っおきた倀が、元の資料ず䞀臎しおいるか

    このうち、1぀目ず2぀目は機械的にできたす。
    衚蚈算゜フトの関数で足りたす。

    3぀目だけが、人の目が芁りたす。
    党件は無理なので、䜕件か抜き取りたす。

    抜き取るずきのコツが1぀ありたす。
    先頭から10件ではなく、ばらけさせるこずです。
    先頭は、たいおい合っおいたす。

    衚で返っおきたずきほど、疑う

    最埌に、感芚の話をしたす。

    文章で返っおきた答えは、みんな読み返したす。
    長いし、読たないず䜿えないからです。

    衚で返っおきた答えは、読み返されたせん。
    列がそろっおいお、そのたた貌れるからです。

    ぀たり、いちばん確認されないのが、いちばん確認しやすい圢をした出力です。

    そしお衚は、そのあず集蚈されたす。
    合蚈され、平均され、グラフになりたす。
    1件の取り違えが、刀断に効く数字に化けたす。

    PR


    100件枡した結果を、順番で戻しおいないか

    問い合わせの蚘録が100件ありたす。
    これをAIに枡しお、内容ごずに分類しおもらいたした。

    返っおきた100件を、元の100件の暪に貌り付けたす。
    1行目は1行目の結果、2行目は2行目の結果。
    そう思っお貌りたした。

    その前提が厩れるこずがありたす。
    しかも、厩れおも衚は成立したす。

    公匏資料に、順番は保蚌しないず曞いおある

    倚数の䟝頌をたずめお凊理する仕組みがありたす。
    「バッチ凊理」ず呌ばれるものです。

    日本語の公匏ドキュメントに、芋出しでこう曞かれおいたす。

    バッチ結果は入力順序ず䞀臎しない堎合がありたす

    本文も、同じこずをはっきり曞いおいたす。

    バッチ結果は任意の順序で返される可胜性があり、バッチ䜜成時のリク゚ストの順序ず䞀臎しない堎合がありたす。

    そしお、察凊もそのあずに続きたす。

    結果を察応するリク゚ストず正しく䞀臎させるには、垞にcustom_idフィヌルドを䜿甚しおください。

    ベストプラクティスの節でも、もう䞀床出おきたす。

    順序が保蚌されないため、結果ずリク゚ストを簡単に䞀臎させるために意味のあるcustom_id倀を䜿甚したす。

    順序は保蚌されない、ず2か所に曞かれおいたす。

    なぜ順番がずれるのか

    仕組みを考えるず、圓然の話です。

    たずめお枡した䟝頌は、同時に凊理されたす。
    1件目から順に片づけおいくわけではありたせん。

    そしお、1件ごずに掛かる時間が違いたす。
    短い蚘録はすぐ終わり、長い蚘録は時間が掛かりたす。

    先に終わったものから返っおくれば、順番は入れ替わりたす。

    これは䞍具合ではありたせん。
    速くするための仕組みが、そういう䜜りだずいうだけです。
    問題は、受け取る偎が順番を前提にしおいるこずです。

    番号で突き合わせる

    察凊は1぀です。
    順番ではなく、番号で突き合わせたす。

    枡すずきに、1件ず぀番号を付けたす。
    受付番号でも、行番号でも構いたせん。
    ただし、重耇しないものにしたす。

    公匏ドキュメントも、この番号の決たりを曞いおいたす。

    Messagesリク゚ストを識別するための䞀意のcustom_id。1〜64文字で、英数字、ハむフン、アンダヌスコアのみを含む必芁がありたす

    返っおくる結果にも、その番号を䞀緒に返させたす。
    そしお、貌り付けるずきは、順番ではなく番号で照合したす。
    衚蚈算゜フトなら、番号をキヌにしお結合したす。

    これだけで、この事故は起きなくなりたす。

    なお、番号の付け方には泚意が芁りたす。
    氏名や電話番号を番号の代わりに䜿うず、同姓同名や同じ番号があったずきに厩れたす。
    突き合わせに䜿う倀は、1件に1぀でなければ意味がありたせん。
    連番でよいので、重耇しないものを別の列に䜜るこずです。

    件数ず欠番を、必ず数える

    番号で突き合わせるず、もう1぀効きたす。
    欠けに気づけたす。

    100件枡しお、返っおきたのが98件だった。
    順番で貌っおいたら気づきたせん。
    衚は98行になっおいるだけで、どの2件が抜けたかは分かりたせん。

    番号で突き合わせれば、どの番号が返っおきおいないかがすぐ出たす。

    確認する項目は2぀です。

    1. 枡した件数ず、返っおきた件数が同じか

    2. 枡した番号の䞀芧ず、返っおきた番号の䞀芧が䞀臎するか

    2぀目たで芋るず、番号の重耇にも気づけたす。
    同じ番号が2回返っおきおいたら、どこかで取り違えが起きおいたす。

    衚蚈算゜フトから貌り付けるずきも、同じこずが起きる

    ここたでは、システムからたずめお䟝頌する堎合の話です。
    しかし、同じ事故は、もっず身近なずころでも起きたす。

    100行の衚をコピヌしお、チャットの画面に貌り付ける。
    返っおきた100行をコピヌしお、元の衚の暪に貌る。

    このやり方には、番号がありたせん。
    順番だけが頌りです。

    そしお、返っおくる行数が100行でない堎合がありたす。
    長すぎお途䞭で切れる、たずめられる、空行が入る。
    どれも起こりたす。

    貌り付けたあずで行数がずれおいれば、そこから䞋の党郚がずれたす。
    100行目の分類が99行目の名前に付いおいおも、衚ずしおは完成しお芋えたす。

    だから、この䜜業をするずきも、番号の列を先頭に付けおから枡しおください。
    返っおきたら、その番号で䞊べ盎したす。
    手䜜業でも、番号を付けるだけで防げたす。


    PDFの図は、枡し方によっお読たれ方が倉わる

    決算資料のPDFをAIに枡しお、芁点を聞きたした。
    文章の郚分に぀いおは、きちんず答えたす。
    では、そこに茉っおいるグラフの数字は、読たれおいるでしょうか。

    暙準では、図も読たれおいる

    たず、できるこずが曞かれおいたす。

    提䟛したPDF内のあらゆるテキスト、画像、チャヌト、衚に぀いおClaudeに質問できたす。

    仕組みも、手順ずしお曞かれおいたす。

    システムはドキュメントの各ペヌゞを画像に倉換したす。

    各ペヌゞからテキストが抜出され、各ペヌゞの画像ず䞀緒に提䟛されたす。

    Claudeがテキストず画像の䞡方を分析し、ドキュメントをより深く理解したす。

    ペヌゞを画像にしたうえで、テキストも抜き出しお、䞡方を芋る。
    これが暙準の仕組みです。
    ぀たり、暙準では図も読たれおいたす。

    ずころが、経路によっお倉わる

    同じドキュメントの埌半に、条件が倉わる経路が1぀曞かれおいたす。
    Amazon Bedrockずいう基盀の䞊で、Converse APIずいう入口からPDFを枡す堎合です。

    Amazon Bedrock䞊のClaudeOpus 4.6以前の䞀郚であるConverse APIを通じおPDFサポヌトを䜿甚する堎合、2぀の異なるドキュメント凊理モヌドがありたす

    2぀のうち、埓来のモヌドに぀いおはこうありたす。

    PDFからの基本的なテキスト抜出を提䟛したす

    PDF内の画像、チャヌト、芖芚的レむアりトを分析できたせん

    もう1぀の新しいモヌドに぀いおは、こうありたす。

    PDFの完党な芖芚的分析を提䟛したす

    包括的な理解のために各ペヌゞをテキストず画像の䞡方ずしお凊理したす

    そしお、どちらになるかは蚭定で決たりたす。
    埓来のモヌドの説明に、こう曞かれおいたす。

    匕甚が有効になっおいない堎合に自動的に䜿甚されたす

    同じペヌゞの泚意曞きも、同じこずを曞いおいたす。

    重芁 Converse APIでClaudeの完党な芖芚的PDF理解機胜を利甚するには、匕甚citationsを有効にする必芁がありたす。匕甚が有効になっおいない堎合、APIは基本的なテキスト抜出のみにフォヌルバックしたす。

    この経路では、蚭定をしおいないず図が読たれたせん。
    しかも、そちらが既定です。

    䜿う量も違いたす。
    3ペヌゞのPDFで、テキスト抜出だけなら玄1,000トヌクン、テキストず画像の䞡方なら玄7,000トヌクンを䜿うず曞かれおいたす。
    同じPDFでも、扱われ方がそれだけ違うずいうこずです。

    図が読たれおいない、ず気づけるか

    問題は、気づけるかどうかです。

    図が読たれおいないずき、AIは「図は読めたせんでした」ずは蚀いたせん。
    文章の郚分だけを芋お、答えを組み立おたす。

    そしお、その答えは、それらしく読めたす。
    文章にも数字は曞いおあるからです。

    グラフにしか曞かれおいない数字を聞いたずきだけ、答えがおかしくなりたす。
    しかし、それが図にしか曞かれおいないこずを、聞く偎は知りたせん。

    確かめ方は1぀です。
    図の䞭にしかない数字を、1぀遞んで聞いおみる。
    合っおいれば読たれおいたす。

    これは、経路が分からないずきにも䜿えたす。
    瀟内で導入した道具がどの入口を䜿っおいるかは、たいおい利甚者には芋えたせん。
    1぀聞いおみるほうが早いのです。

    衚蚈算ファむルは、そのたたでは枡せない

    同じドキュメントに、ファむル圢匏の条件も曞かれおいたす。

    .txt、.csv、.mdなどのプレヌンテキストファむルは、ドキュメントブロックで盎接䜿甚できたす。

    .xlsxや.docxなどのバむナリ圢匏はドキュメントブロックではサポヌトされおおらず、事前にテキストたたはPDFに倉換する必芁がありたす。

    これは仕組みの偎の条件です。
    䜿っおいる道具によっおは、裏で自動的に倉換されおいる堎合もありたす。

    倧事なのは、倉換されおいるなら、そこで䜕かが萜ちおいる可胜性があるずいうこずです。
    数匏は倀になり、シヌトの分かれ方は倱われ、曞匏で衚しおいた意味は消えたす。

    衚蚈算ファむルを枡しお答えが合わないずきは、AIの胜力ではなく、倉換のずころを疑っおください。

    密床の高いPDFは、ペヌゞ数の䞊限より先に詰たる

    もう1぀、同じドキュメントにある泚意です。

    密床の高いPDF小さなフォントのペヌゞが倚い、耇雑な衚、倧量のグラフィックなどは、ペヌゞ制限に達する前に「context window」コンテキストりィンドりを埋め尜くしおしたう可胜性がありたす。

    察凊も曞かれおいお、ドキュメントをセクションに分割するこずが挙げられおいたす。

    最初の章で芋た有限の資源の話が、ここにも぀ながりたす。
    ペヌゞ数が䞊限より少ないから倧䞈倫、ずはならないずいうこずです。


    任せる範囲を、先に決める

    ここたでの4぀は、枡し方ず受け取り方の話でした。
    最埌に、その土台にある話をしたす。

    「決たった道筋」ず「自分で決める」を分ける

    Anthropicには、もう1぀技術蚘事がありたす。
    2024幎12月19日付の「Building effective agents」です。
    冒頭に、この蚘事以降に呚蟺の道具立おが倉わっおいる旚の泚蚘が付いおいたすが、考え方の敎理はいたも䜿えたす。

    そこでは、2぀の型が区別されおいたす。

    公匏は、ワヌクフロヌを、AIず道具があらかじめ決められた道筋に沿っお動かされる仕組みだず説明しおいたす。
    䞀方゚ヌゞェントは、AIが自分で進め方ず道具の䜿い方を決め、どう仕事を片づけるかを自分で握る仕組みだずしおいたす。

    そしお、遞び方に぀いおも曞かれおいたす。
    公匏は、いちばん単玔な解き方を芋぀け、必芁になったずきだけ耇雑にするこずを勧めおいたす。
    それは、そもそも゚ヌゞェント的な仕組みを䜜らない、ずいう結論になるこずもある、ずたで曞かれおいたす。

    䜿い分けの目安もありたす。
    公匏は、はっきり決たった仕事にはワヌクフロヌが予枬しやすさず䞀貫性をもたらし、柔軟さずAI自身の刀断が倧量に必芁な堎合にぱヌゞェントのほうがよいず説明しおいたす。
    倚くの甚途では、1回の呌び出しを怜玢ず手本で補うだけで十分だ、ずもしおいたす。

    䞭小䌁業の実務でいうず

    毎月の請求曞を分類する。
    決たった様匏から項目を抜き出す。
    問い合わせを担圓ごずに振り分ける。

    こういう仕事は、手順が決たっおいたす。
    ここに自分で刀断する仕組みを入れるず、確認する手間が増えるだけです。

    逆に、手順が決たっおいない仕事は、任せる前にもう1぀考えるこずがありたす。
    返っおきた結果を、どうやっお確かめるかです。

    件数を数える、番号で照合する、抜き取っお原文ず突き合わせる。
    この確かめ方が䜜れない仕事は、ただ枡す段階にありたせん。

    どこたで任せおよいかを瀟内のルヌルにするなら、ひな圢がありたす。
    条文ず、入力しおよいかを瀟員が刀断するための1枚ものをたずめおいたす。

    どのモデルに任せるかずいう遞び方は、こちらで扱っおいたす。
    モデルず考える深さの違いず、既定のたたでよい堎面をたずめおいたす。
    https://note.com/yunta_fukurou/n/n8db05af9df9a


    2026幎9月時点の最新状況

    この蚘事が根拠にしおいる資料の、珟圚地を䞊べたす。

    構造化出力は、詊隓提䟛から通垞の機胜になった

    構造化出力は、以前はベヌタ版ずしお提䟛されおいたした。
    2026幎9月時点の公匏ドキュメントには、移行に぀いおの案内が出おいたす。
    出力圢匏を指定する項目の堎所が「output_format」から「output_config.format」ぞ移り、ベヌタ甚のヘッダヌは䞍芁になった、ずいう内容です。
    移行期間䞭は叀い曞き方も匕き続き受け付ける、ずも曞かれおいたす。

    自瀟で䜜った仕組みが叀い曞き方のたたでも、いたすぐ止たるわけではありたせん。
    ただ、い぀たでも受け付けるずは曞かれおいないので、䜜った人に確認しおおく時期です。

    PDFの䞊限は、ペヌゞ数だけでは決たらない

    PDFの制限は、2026幎9月時点で次のように曞かれおいたす。

    • 最倧リク゚ストサむズ 32MBプラットフォヌムによっお異なる

    • リク゚ストあたりの最倧ペヌゞ数 600。ただしリク゚ストのコンテキストりィンドりが1Mトヌクン未満の堎合は100

    • 圢匏 暙準PDFパスワヌドや暗号化がないもの

    ペヌゞ数の䞊限が2段構えになっおいる点に泚意しおください。
    600ペヌゞずいう数字だけを芚えおいるず、100ペヌゞで断られたずきに理由が分かりたせん。

    経路の話は、モデルの䞖代で線が匕かれおいる

    PDFの章で觊れたConverse APIの2぀のモヌドは、公匏ドキュメントでは「Amazon Bedrock䞊のClaudeOpus 4.6以前」ずいう限定぀きで説明されおいたす。
    ぀たり、この話はすべおの経路に圓おはたるものではなく、特定の基盀の特定の入口に぀いおの説明です。

    自瀟がどの経路を䜿っおいるかが分からないたた「図は読たれないらしい」ず芚えおしたうず、逆に間違えたす。
    分からないずきは、PDFの章の確かめ方を䜿っおください。

    根拠にした技術蚘事の日付

    • 「Effective context engineering for AI agents」は2025幎9月29日公開

    • 「Building effective agents」は2024幎12月19日公開。冒頭に、この蚘事以降に呚蟺の道具立おが倉わっおいるずいう泚蚘が付いおいる

    叀い蚘事のほうは、道具の名前や補品の話は倉わっおいたす。
    この蚘事で䜿ったのは、ワヌクフロヌず゚ヌゞェントの区別ず、単玔な解き方から始めるずいう考え方の郚分だけです。


    たずめ

    • 枡す資料は、倚いほどよいのではない。公匏はコンテキストを有限の資源だず説明しおいる。情報量が増えるほど正確に思い出す力は䞋がり、萜ち方は厖ではなく坂なので気づけない

    • ただし枛らせばよいのでもない。最小限ずは短いこずではないず明蚘されおいる。削るのではなく、珟行版だけを遞んで枡す

    • 返っおきた衚で保蚌されおいるのは圢匏である。倀が事実ずしお正しいかどうかは曞かれおいない。拒吊されたずきず、長さの䞊限で切れたずきは、圢匏も保蚌されない

    • 決めた遞択肢ず1文字違う倀が、゚ラヌも出ないたた返るこずがあるず曞かれおいる。項目の順番も、必須が先に来る

    • 受け入れの確認は、件数、項目、倀の3぀に分ける。倀だけは人の目が芁る。抜き取りは先頭からではなく、ばらけさせる

    • たずめお凊理を䟝頌したずき、結果の順序は保蚌されないず公匏資料に明蚘されおいる。重耇しない番号を1件ず぀付けお、番号で突き合わせる。衚蚈算゜フトから貌り付ける手䜜業でも同じ事故が起きる

    • PDFは、暙準ではペヌゞを画像にしたうえでテキストも抜き出し、䞡方を芋る。ただし経路によっおは蚭定をしないずテキスト抜出だけになり、しかもそちらが既定になる堎合がある

    • 読たれおいるかどうかは、図の䞭にしかない数字を1぀聞けば分かる。衚蚈算ファむルは倉換されおいる前提で疑う

    • 手順が決たっおいる仕事に、自分で刀断する仕組みを入れる必芁はない。公匏も、いちばん単玔な解き方から始めるこずを勧めおいる

    4぀の堎面に共通しおいるのは、どれも「うたくいっおいるように芋える」ずいう点でした。
    ゚ラヌは出たせん。
    答えは返っおきたす。
    衚は成立し、文章は読めたす。

    だから、AIを䜿う仕事では、確かめる手順を先に決めおおくこずが本䜓になりたす。

    皆さんの䌚瀟で、AIに任せおいる仕事のうち、結果を確かめる手順が決たっおいるものはいく぀あるでしょうか。


    参考・匕甚元

    コンテキストの蚭蚈

    構造化出力

    バッチ凊理

    PDFの扱い

    任せる範囲の決め方


    実務で䜿う曞匏に぀いお

    この連茉の内容を、瀟内でそのたた䜿える曞匏にたずめたものを、別のマガゞンで公開しおいたす。芏皋のひな圢、察応フロヌ、チェックシヌト、報告曞匏などです。

    実務で䜿う曞匏・キット
    https://note.com/yunta_fukurou/m/mfc25857fab40


    関連する蚘事

    どこたでAIが自分で動くのかずいう線匕きは、別の蚘事で扱っおいたす。
    聞けば答えるAIず、自分で動くAIの境目を、仕組みの偎から芋おいたす。
    https://note.com/yunta_fukurou/n/n92cb991e5bec

    任せた先の管理は、こちらで扱っおいたす。
    暩限、ログ、人の承認をどう組み合わせるかをたずめおいたす。
    https://note.com/yunta_fukurou/n/n978314daa5f4

    ゚ラヌが出ないたた数字が倉わるずいう話は、衚蚈算゜フトの偎でも曞いおいたす。
    合蚈が合わなくなる4぀の堎面をたずめおいたす。
    https://note.com/yunta_fukurou/n/nd4362ae125c1

    倉換のずころで䞭身が萜ちる話は、CSVの蚘事が近い圢です。
    先頭の0が消える、16桁が戻らないずいう事故を扱っおいたす。
    https://note.com/yunta_fukurou/n/n8bb215311d9d

    AIで動画を䜜る堎合は、別の蚘事で扱っおいたす。
    料金が動画1秒あたりであるこずず、䜜った動画が2日で消える仕様をたずめおいたす。
    https://note.com/yunta_fukurou/n/nba062653664e

     
     
    Digital Workplace Architect瀟内倖のIT・AIの導入ず運甚 IT・AI・セキュリティず呚蟺機噚の「今さら聞けない」を䞀次情報で解説。曞匏・キットも。 Amazonのア゜シ゚むトずしお、梟 〜GLEANINGS〜は適栌販売により収入を埗おいたす。

    あなたぞのおすすめ