記事

記事 · 2

プロダクト、ソフトウェア開発、その間にある判断についての実践的な記事。

初期案内の目的は画面見学ではなく、小さくても価値のある仕事の完了です。利用者にとっての最初の価値を定義し、今必要な設定と後でよい設定を分けます。

管理画面は強い権限を使う業務ツールです。対応すべき記録、許される変更、後から経緯を説明する方法から設計します。

サービスを維持する基本費用、顧客ごとの利用費、例外対応の人件費を分けます。サーバー代一つでは、保存容量、メール、監視、バックアップ、外部連携、問題を解く人の仕事が隠れます。

信頼性は、利用してよい資料と答えを控える質問から始まります。文章が見つかっても、最新で、その状況に当てはまり、十分な根拠があるとは限りません。資料ごとに責任者と更新手順を決めます。

回答に必要な確かさと権限から方式を選びます。RAGは資料を検索して説明に使い、規則に沿った照会は構造化された事実を返します。ツール呼び出しは操作の要求であり、実行の検証と許可はアプリ側が行います。

月額料金を探す前に利用量を組み立てます。稼働利用者、セッション、発言数、入出力の長さで負荷が変わります。検索した文章と会話履歴も入力に含め、画面に見える質問だけで計算しないでください。

抽出された文字は記録の候補であり、承認済みの業務処理ではありません。重要な項目、照合方法、人が確認する条件を決めます。抽出器の信頼度は判断材料ですが、業務上の確認の代わりにはなりません。

検索した資料、メール、モデル出力は信頼を前提にしない入力として扱います。命令が書かれていても、命令する権限があるとは限りません。OWASPも注入と過剰な操作権限をリスクとして挙げており、モデルへの指示文の外に制御が必要です。

連携は二つのURLではなく二つの業務をつなぎます。交換する記録、項目の責任元、認証、反映時間、停止時の担当者を決めます。試験リクエストが一回成功しても、確認できるのは一部です。

まず各事実の正本を決めます。物理在庫、販売可能数、価格、注文状態は同じシステムが管理するとは限りません。「双方向同期」の一言で済ませず、方向、遅延、競合処理を別々に定めます。

同期は最新の行を複製することではなく、情報の意味を保つことです。各項目をどちらが管理し、利用者がどこで変更できるかを定めます。双方向に書く前に照合と削除の規則を決めます。

通知の到着と業務処理の完了は別です。再送と順序の入れ替わりを想定します。Stripeも同社のWebhookについてこの挙動を説明しています。他の提供元はそれぞれの契約を確認してください。

役立つものを、一緒に。

最初のプロダクト、複雑な業務、見直したいソフトウェア。現在の状況をお聞かせください。