AIエージェントとデータベース全体: 読み取りの完全性を確かめるには
範囲を定めてページをたどり、レコードを比較して、取得した内容と完了した評価を区別します。
記事の言語: 日本語

目次
報告書には検討した説明が30件あり、「カタログ全体を確認しました」と書かれています。その数行上にあるツールの応答には、次のページへのリンクが残っていました。データベースにはまだ伝えることがたくさんあるのに、アシスタントは先に別れを告げたのです。
架空の設備レンタル会社を考えてみましょう。会社はエージェントに、公開済みのポーランド語の説明を評価するよう依頼しました。合意した範囲は245件で、会社はその識別子を基準となるエクスポートに保存しています。エージェントは最初の30件を受け取り、十分筋の通った評価をしました。問題は評価の前にあります。残る215件の説明をまったく取得していません。注意深く作業するようプロンプトを改善しても、送っていないリクエストが自然にサーバーへ届くわけではありません。
「全体」にはアドレスと条件が必要
ページを数える前に、何を取得すべきかを記録します。このレンタル会社の対象は、一つのカタログにある公開済みのポーランド語の説明を、合意した状態で読むことです。取り扱いを終了した設備の保管記録と、新しい項目の下書きは依頼の範囲外です。そのため、管理画面の全レコード数は、エージェントが利用できる一覧とは異なるかもしれません。
権限を広げて数を合わせようとしないでください。まず集合の定義を比較します。公開された説明を読む依頼なら、非公開の下書きにアクセスできないことは作業に合っています。下書きも期待していた人がいるなら、範囲とアクセスについて新たな判断が必要です。権限を広げても依頼内容が明確になるわけではありません。
自分のAIデータフロー台帳に、読み取り元と使用した役割を記録します。AIデータの流れを記録する台帳の作り方を扱う記事 (ポーランド語)で、記録方法を確認できます。この作業の報告書には、プロジェクト、言語、状態、基準となる状態の定め方を示せば十分です。アクセスキーの値や認証情報を管理表にコピーしてはいけません。受け入れ担当者に必要なのは範囲を再現することであり、秘密情報を引き継ぐことではありません。
プログラムがデータを取得するインターフェースであるAPIが何を返すかも確認します。タイトルと識別子の一覧は完全な索引でも、評価に必要な説明を含まないことがあります。その場合、作業には正しい項目を集めることと、各項目の内容を取得することの二つの読み取りがあります。前者の証拠を後者の証拠にしてはいけません。
この例の基準エクスポートには、245件の説明の識別子があります。取得後、エージェントは受け取った識別子の集合が一致することを示し、各説明のバージョン表示を保持する必要があります。商品名の一覧だけでは不十分です。二つの項目の名前が似ていることも、一つの商品の名前が作業中に変わることもあります。識別子が一致しても、内容のバージョンが一致するとは限りません。IDだけのエクスポートと現在の読み取り結果だけでは以前の説明の状態を確認できず、利用可能なほかの過去の証拠は別途評価する必要があります。
システムが信頼できる総数もエクスポートも提供しないなら、その限界を明記します。文書化されたページ送りの経路を最後までたどったことは確認できます。それは、独立して定めた集合との比較とは異なる証拠です。画面上で最も見栄えのよい数字を選ぶのではなく、実際に存在する証拠を報告書で説明します。
ページの終わりはカタログの終わりではない
GitHub REST APIのページ送りの文書は、次のページなどのアドレスを持つLinkヘッダーを説明しています。また、per_pageの値が許可された上限より大きい場合、リクエストエラーなしで引き下げられることも示しています。したがって、巨大な一括取得を要求しただけでは、それを受け取った証拠になりません。
連携機能は、それぞれのシステムが指定した継続方法を使うべきです。リンク、ページ番号、または次の読み取り位置を示すカーソルの場合があります。二つのAPIが同じフィールドを使うと決めつけないでください。応答に次のページのアドレスがあるなら、エージェントはそれを認識して処理する必要があります。扱いやすい長さの一覧を、サーバーが終了を決めた証拠にしてはいけません。
GoogleのAIP-158は、集合がまだ終わっていなくても、要求より短いページや空のページを認めています。次のトークンがないことが終了を示します。この文書は継続トークンと権限も区別しています。各リクエストには引き続き認可が必要です。
したがって「100件未満だったから完了」というルールには、選んだ入力の契約上の根拠が必要です。別のサービスからそのまま持ち込まないでください。管理されたテストでは、有効な継続情報とともに短いページを返します。次の項目も集合に入るべきです。エージェントが止まれば、説明に対する意見の品質を評価する前に、具体的な受け入れ上の欠陥を見つけたことになります。
APIページの終わりと、ツールが表示する応答の途中切れも区別します。サーバーはページ全体を返しても、アシスタントには先頭しか見えていないかもしれません。欠けた部分を読むか、別の方法で取得する必要があります。ツールを呼び出したという情報だけでは、返された内容すべてが作業に使う資料へ入った証拠にはなりません。
この境界はAIによる長いコンテキストの利用 (ポーランド語)より前にあります。そこでは、モデルが渡された例外を使ったかを確認します。ここでは、該当レコードが評価にそもそも届いたかを尋ねます。どちらのモデルにも同じように途中で切れた一覧が渡るなら、モデルを変えても同じ欠落が残るかもしれません。
各段階で、入力カーソルの表示、受け取った項目数、継続情報を保持します。各ログに商品内容の全文をコピーする必要はありません。一方で、カーソルの繰り返しを検知できると役立ちます。同じページを回り続ける連携機能が、完全性が増しているかのような報告書だけを大きくしてはいけません。
この作業では、読み取り全体を通じて言語と状態を同じに保つべきです。三ページ目の後でポーランド語の説明から全言語へフィルターを変えると、その後の一覧は別の問いへの答えになります。保存したカーソルでその変更を隠してはいけません。範囲を広げる必要があるなら、別の実行を始め、その条件を保存します。そうすれば、どこから別のレコードが混じり始めたか推測せずに、二つの結果を比較できます。
合計は一致しても、40件が欠けている
この資料のために、245個の架空の識別子を使った別の再現可能なオフラインテストを実施しました。スクリプトと結果は編集用パッケージに添付しています。一ページ40件なら、正しい実行は満杯の六ページと、五件のレコードを持つ最後のページから成ります。顧客データでも、特定サービスのテスト結果でもありません。小さなテスト用集合なので、何が返るべきかを事前に正確に決められます。

欠陥のある例では、三つ目の応答が二つ目の40件を再び含みます。残りのページは正しいものです。単純な合計は245件のままです。しかし、固有の識別子は205個しかなく、期待した40件を受け取っていません。受け入れ確認が一覧の長さだけを見る限り、重複したページが欠けたページに置き換わっても、報告書の数字は変わりません。
重複を黙って削除し、残りの資料について成功を宣言してはいけません。どの識別子が繰り返され、何が欠け、どの移行で起きたかを記録します。再取得が許されるなら、APIのルールに従って正しい地点へ戻ります。似たタイトルや、古い商品だろうという推測で欠落を埋めないでください。
同じテスト集合では、期待した識別子の代わりに別の識別子を入れることもできます。その場合、受信数と固有数は正しくても、集合は依然として異なります。だからこそ、具体的な要素を基準範囲と比較します。245件の範囲なら、それぞれの同一性も確認する必要があります。二つの数値が一致するだけでは、置き換えを見逃します。
読み取りが完了して初めて、エージェントが結果を正しい項目へ割り当てたかの確認が始まります。一括処理の受け入れ確認 (ポーランド語)は、その後の段階を扱います。245件の説明を正しく取得した後、評価を入れ替えてしまうこともあります。取得した30件を正確に評価しながら、残りを見ないまま終わることもあります。修正する場所の異なる別々の欠陥です。
最終報告書には、改善が必要な説明数という別の数字も現れます。索引には245件すべてあるものの、二件の内容取得に失敗したとします。エージェントは残る243件を評価し、17件を修正対象に選びました。この17件は集合の一部を分析した結果として正しいかもしれません。しかし、欠けた二件の説明が良いという証拠にはなりません。受け入れ担当者には、索引の範囲、取得した内容の範囲、評価を完了した範囲を別々に示すべきです。
特に、受信者が問題の一覧だけを求める場合は、実行前にこの基準を決めます。その形式では、報告書にない商品が「確認済みで問題なし」「取得できなかった」「評価していない」のどれを意味することもあります。それぞれ必要な行動は異なります。簡潔な提案一覧とは別に状態の一覧を保持すれば十分です。説明245件をすべてメールに加える必要はありません。未解決の二件に戻れるよう、見つける方法を残します。
取得エラーを空の説明に置き換えてはいけません。技術的な問題が、商品内容の評価であるかのように変わってしまいます。会社が報告書に基づいて修正を依頼するなら、内容を読み取れていないレコードは先に原因を確認すべきです。そうしなければ、書き手はレビュアーが見てもいない文章を直す依頼を受けることになります。
一つの一覧には一つの時点が必要
別の読み取りの途中で、チームが新しい説明を公開し、古いものを一つ取り下げます。件数は245件のままです。後続のページが現在の状態から作られるなら、エージェントは古いカタログの前半と新しいカタログの後半を組み合わせるかもしれません。固有識別子数が一致しても、最初に合意した状態を再現できたかは分かりません。
該当するAPIが提供する一貫性のルールを確認します。固定されたリビジョンを読めるなら、そのリビジョンで継続し、各ページの表示を受け取ります。変更後に再開始が必要なら、未完了の実行を別に保管して最初からやり直します。カーソルを使っただけでは、データが変わらないことの普遍的な保証にはなりません。
サービスがその保証を提供しない場合、チームは合意済みのエクスポートを選ぶか、結論を読み取り期間中の観察に限定できます。それをデータベースの一時点の正確なスナップショットと説明してはいけません。レンタル会社の例では、保管したエクスポートとの比較で違いを認識できますが、サーバーに元々ない性質が与えられるわけではありません。
渡されたファイルのハッシュ (ポーランド語)は、後の参加者が同じエクスポートを使ったかを確認する助けになります。元のシステムに対する完全性は証明しません。その評価には、ファイルの作成方法、範囲、確認された時間境界が引き続き必要です。同じ不完全なファイルが二つあっても、どちらも同じように不完全です。
読み取りが中断したことも見えるようにします。GitHubのAPI制限に関する指針は、Retry-Afterヘッダーがある場合に示された時間を待ち、再試行を制限するよう求めています。制限超過の応答は空の最終ページではありません。
このカタログで五ページ目にエラーが起きたら、エージェントは取得が未完了であることを保持すべきです。トークンとバージョンの一貫性が引き続き許すなら、読み取りを再開できます。許されないなら、新しい実行が必要です。その後の報告書はすでに評価した項目を説明できますが、完全なレビューというラベルを付けるべきではありません。
同様に、ストリーミングされる応答の一部 (ポーランド語)は、確認された完了の代わりにはなりません。一覧では、ページ内容の取得、継続情報の認識、全範囲の完了を区別します。そうすれば、中断した読み取りは「AIの回答が短すぎた」という一般的なエラーに消えず、固有の状態として残ります。
Aeneia Auditとの相談には、一つの依頼、API入力の説明、許可された小さな基準資料を用意してください。エージェントの作業方法を確認することで、どの証拠が得られ、どこで結論を限定する必要があるかを示せます。実際のデータベース全体を別のモデルとの会話へ移す必要はありません。
受け入れ担当者は、範囲、最後に認識した読み取り状態、受け取った集合の一致を示せるべきです。エージェントが30件目までしか到達していなくても、報告書に有用な30件の評価を含めることはできます。正しい名前で提出しましょう。アシスタントが最後の段落を書くのに良いタイミングだと判断しても、カタログが短くなるわけではありません。







