GLM 5.3 で複数ファイルを直す前に：検索とページングの契約確認

最小 API サンプル

説明用の Python コードで、実行した回答ではありません。キーは環境変数から読み、自動再試行は無効です。切断時は結果と費用の両方が不明になり得るため、無条件に再送しないでください。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://dikaya.cc/v1",
    api_key=os.environ["DIKAYA_API_KEY"],
    max_retries=0,
)
response = client.chat.completions.create(
    model="seller-glm-5-3",
    max_tokens=512,
    messages=[{"role": "user", "content": "私の課題の確認リストを作り、元の事実と仮定を分けてください。"}],
)
print(response.choices[0].message.content)

検索処理の流れを先に一枚へまとめる

架空の資料検索画面で、入力欄、リクエスト組み立て、API の検証、保存層の問い合わせを対象にします。各ファイルの役割と受け渡す値を示し、モデルに未提示の依存は未確認と書かせます。一つの型定義を見ただけで全体の仕様が確定したかのように修正させないことが出発点です。

検索語を変更したときページ番号を戻すか、並び順の既定値は何かも業務側で決めます。表示ラベルの翻訳と内部の列名は別です。モデルが便利な新機能や保存形式の変更を提案したら、契約の不一致を直す作業とは分離し、今回の対象に含めない限り実装済みと扱いません。

省略、空文字、ゼロを同じ値にしない

ページ指定がない場合、ゼロの場合、数値でない場合をそれぞれ定義します。検索語の空文字が全件検索なのか入力エラーなのかも明示します。画面ではゼロ始まり、API では一始まりという違いを見落とすと、各関数は正しく見えても利用者には一ページ分ずれた結果が表示されます。

古いクライアントが新しい並び順フィールドを送らない場合も確認します。どの層が既定値を決めるかを一つにし、未指定と明示指定の意味が必要なら保存します。モデルには現行コードの根拠と提案を分けてもらい、想像した仕様を既存の契約へ混ぜないようにします。

推論強度と答えの長さを別々に制御する

この項目では low、high、max が宣言されています。条件の多い検討で使い分けることはできますが、max が必ず正解に近いという認証ではありません。固定したサンプルと同じ評価項目で実際の結果を見る必要があり、少数の印象から品質や速度の順位を作らないでください。

出力上限は別に設定します。最初は契約表だけを求め、その確認後に必要な差分へ進むと、長いコードで未確認事項が埋まるのを防げます。モデルのコンテキストは出力量でもブラウザーの全履歴でもありません。見える最終文の長さだけを総消費量とみなさないことも大切です。

ファイル間の境界をテストにする

検索語変更後のページ初期化、最終ページ、空の結果、無効な指定をテストにします。画面の送信値と API の受信値をそれぞれ検証し、保存層へ届く条件まで確認します。同じ誤変換を期待値の計算にも使うと不一致を見逃すため、小さな独立した例から期待する動作を決めます。

失敗経路では、API が拒否したのに画面が空結果として成功表示していないか調べます。テストは自分の環境で走らせ、修正前の失敗と修正後の結果を残します。モデルにログの整理を頼むことはできますが、未実行のコマンドを実施済みと書かせてはいけません。

入力資料と利用ツールの範囲を明示する

関連するファイルには版とパスを添え、長い場合は呼び出し境界で分割します。添付の形式、バイト数、メッセージ制限はモデルの入力容量とは別です。画像は別料金のテキストブリッジを通るため、画面仕様の重要な値や条件は検証済みの文章でも示すと照合しやすくなります。

新しいライブラリー仕様を確認する際、有料ブラウザーチャットには明示的検索がありますが、公開 API の組み込みネット検索とは別です。検索の断片より、固定した依存版と実際の公式文書を優先します。外部情報、提示コード、モデルの推測を分けておけば、根拠のない API 名を採用しにくくなります。

変更した範囲だけを確認済みとする

成果物には変更ファイル、同期が必要なフィールド、互換性、未提供の呼び出し元、実行したテストを列挙します。サービス層だけを調べたなら画面まで完了とは書きません。seller-glm-5-3 と seller-pro-2 の記録も混ぜず、正確な ID と現在の料金・権限を確認して依頼します。

SDK の自動再試行を無効にし、明確な HTTP 拒否と通信結果不明を区別します。MDN の説明は通信上の違いを支えるもので、切断時の無課金や未保存の証拠ではありません。再依頼の前に既存記録を確認し、記事からの下書きも送信前にモデルと内容を見直します。

よくある質問

GLM 5.3 と Pro 2 は同じ設定を使い回せますか？

同一項目としては扱えません。seller-glm-5-3 と seller-pro-2 は公開 ID が異なり、設定、権限、利用条件をそれぞれ確認します。Pro 2 に基盤の説明があっても、片方の試験結果や対応パラメーターをもう片方へ自動的に転用する根拠にはなりません。

max を選べば複数ファイルの整合性は保証されますか？

保証されません。low、high、max は宣言された推論強度であり、完全な入力や契約、実行テストの代わりではありません。まず各層の受け渡しを固定し、境界値と失敗経路を確かめます。正しさは選択肢の名前でなく、再現できる結果から判断します。

コンテキストに収まれば全リポジトリーを送れますか？

ブラウザーのメッセージ、添付、バイト数の制限が別にあり、全履歴の送信も保証されません。関係する呼び出し元と版を絞り、秘密を除いた資料を渡します。実際に参照できた範囲を明記し、未提示ファイルまで確認したとは書かないでください。

検索 API のエラーを空結果として扱ってもよいですか？

業務契約として明示的に決めていない限り、失敗と正常な空結果を混ぜるべきではありません。画面が利用者へ誤った成功を示す原因になります。状態と表示を定義し、拒否された入力、通信結果不明、正常な空集合を別々にテストしてください。

出典

AIの支援を受けて作成した記事です。例は説明用であり、実際のモデル回答や比較試験の記録ではありません。外部資料はサービスの利用条件に代わるものではありません。

• Dikaya 日本語ドキュメント：接続とリクエストの条件
  dikaya.cc
• Dikaya 日本語モデル一覧：公開識別子と対応内容
  dikaya.cc
• Dikaya 日本語料金案内：設定上の料金と利用条件
  dikaya.cc
• OpenAI Python SDK 公式資料：自動再試行の設定
  github.com
• MDN Fetch ガイド：HTTP 応答と通信エラーの区別
  developer.mozilla.org