日本人形・ひな人形・市松人形の修理工房が、過去の修理の記録を Vertex AI Search で検索し、写真付きの見積の問い合わせに近い修理の事例と、手順・期間・費用の幅を返信の前に引く
写真付きの見積の相談に、同じ種類の人形・同じ部位・同じ傷みの過去の修理の事例と、その手順と注意点、期間と費用の幅を、修理の記録の番号と引用付きで並べて返します。
- 生成AI
- Gemini
- AIサービス
- Azure AI/Google Vertex AI/OpenSearch
- 連携・自動化
- Python
- 対象業界
- その他/小売
- 対象部門
- カスタマーサポート/生産
- 対象業務
- 問い合わせ対応/情報検索
- 主な課題
- 問い合わせが多い/属人化している/情報が見つからない
- AIで行う処理
- 検索(RAG)
- 主な効果
- 対応スピード向上/属人化解消/検索時間短縮
- 導入難易度
- ★★★☆☆
- 実装レベル
- 本格構成
- 費用感
- RAG・個別開発(大)
- 人間の確認
- 条件付き
01導入前 / 導入後の業務フロー
- 受付が相談のメールを読み、人形の種類と傷みを書き出して、作業場に回す
- 職人が写真を見て、傷みを見立てる
- 修理の記録の表計算を、人形の種類と傷みの言葉で絞り込む
- 表計算に近い事例が無ければ、紙の受付票と作業の綴りをめくる
- 見つけた事例の写真のフォルダを開き、前後の写真を見比べる
- 事例の請求の額と預かった日数を見て、概算の幅を決める
- 古い職人に「この場合いくらだったか」を聞く
- 受付が見積の返信を書いて送る
- 人受付が相談を読み、検索の画面で人形の種類・部位・傷みの種類を決まった言葉から選ぶ。複数体の相談は1体ずつ分ける
- 人職人が写真を見て、受付の選んだ区分を確かめ、違えば直す
- 自動中継プログラムが区分から絞り込みの式を作り、search メソッドで近い事例の一覧を出す
- 自動一覧の事例の属性から、預かった日数と請求の額の最小・最大と件数を計算する。過去5年の事例だけで計算する
- 自動同じ絞り込みで answer メソッドを呼び、近い事例の手順と注意点と、断った・別の方法をすすめた事例を引用付きでまとめさせる
- 人職人が引用と写真を確かめ、概算の幅を決める
- 人受付が見積の返信を書いて送る。確定の額は現物を見てから出すことを必ず書く
- 人修理を終えたら、受付が決まった形で修理の記録を登録する
各工程の詳しい説明を読む
- 受付が相談のメールを読み、人形の種類と傷みを書き出して、作業場に回す
- 職人が写真を見て、傷みを見立てる
- 修理の記録の表計算を、人形の種類と傷みの言葉で絞り込む
- 表計算に近い事例が無ければ、紙の受付票と作業の綴りをめくる
- 見つけた事例の写真のフォルダを開き、前後の写真を見比べる
- 事例の請求の額と預かった日数を見て、概算の幅を決める
- 古い職人に「この場合いくらだったか」を聞く
- 受付が見積の返信を書いて送る
(a)傷みの言葉がそろっていない。 表計算の傷みの欄には「ひび」「割れ」「亀裂」「ヒビ割れ」が混ざり、同じ傷みが言葉の違いで別々に出てきます。
(b)費用の幅が担当で違う。 職人によって思い出す事例が違い、同じ傷みの相談に、ある職人は狭い幅、別の職人は倍の幅で返すことがあります。 後で現物を見て額が大きく変わると、相談した人との間で揉めます。
(c)写真のフォルダを開くまで事例が分からない。 表計算の手順の欄は短く、どこまで手を入れた修理だったかは、前後の写真を見ないと分かりません。 1件の事例を確かめるのに、フォルダを開いて何枚も見比べます。
(d)断った事例が残っていない。 作家物で元の状態を残したほうがよい人形、傷みが進みすぎて直せない人形。修理を断った・別の方法をすすめた相談は記録に残っておらず、同じ相談に毎回一から考えます。
(e)返信までに日数がかかる。 職人は修理の作業の合間に事例を探すので、返信は相談から3〜4日後になることがあります。 その間に、相談した人が別の工房に頼んでいることがあります。
- 【人】 受付が相談を読み、検索の画面で人形の種類・部位・傷みの種類を決まった言葉から選ぶ。複数体の相談は1体ずつ分ける
- 【人】 職人が写真を見て、受付の選んだ区分を確かめ、違えば直す
- 【自動】 中継プログラムが区分から絞り込みの式を作り、search メソッドで近い事例の一覧を出す
- 【自動】 一覧の事例の属性から、預かった日数と請求の額の最小・最大と件数を計算する。過去5年の事例だけで計算する
- 【自動】 同じ絞り込みで answer メソッドを呼び、近い事例の手順と注意点と、断った・別の方法をすすめた事例を引用付きでまとめさせる
- 【人】 職人が引用と写真を確かめ、概算の幅を決める
- 【人】 受付が見積の返信を書いて送る。確定の額は現物を見てから出すことを必ず書く
- 【人】 修理を終えたら、受付が決まった形で修理の記録を登録する
2番で職人が区分を確かめているのがこの設計の要です。 同じ「顔のひび」でも、胡粉の表面だけのひびと、頭の木地まで割れたひびでは、修理の手順も期間も額もまるで違います。 見立ては写真を見た職人が決め、検索はその見立てに合う事例を出すだけにします。
4番で額を機械で計算しているのも、意図してのことです。 生成の文に「おおむね数万円」と書かせると、どの事例のどの額から出た数字かが分かりません。 記録の請求の額から最小と最大を出し、件数を添えます。
02今回想定するシステム構成
写真付きの見積の相談(メール・Web の窓口) ▼【トリガー】受付が区分を選び、職人が確かめて「探す」を押す 中継プログラム(Python。Cloud Run) │ 区分(人形の種類・部位・傷み)→ 絞り込みの式 │ 近い事例の属性 → 日数と額の最小・最大・件数 ▼ Vertex AI Search(Agent Search) ├── search メソッド ── 近い事例の一覧(属性と写真のフォルダへのリンク) └── answer メソッド ── 手順と注意点、断った事例(引用つき) │ データストア:修理の記録(1体の修理を1文書。種類・部位・傷み・結果・日数・額の属性つき) ▼ 【職人が確かめ、受付が見積の返信を書く】
| 役割 | 想定する製品 | 代替候補 |
|---|---|---|
| 検索基盤 | Vertex AI Search(Agent Search)の answer メソッドと search メソッド | Azure AI Search、Amazon OpenSearch Service |
| 生成AI | Gemini(answer メソッドの回答の生成に使うモデル) | ― |
| 連携 | 中継プログラム(Python。Cloud Run で動かし、検索の画面・区分の表・検索をつなぐ) | Node.js で同じものを書く |
| 保管 | Cloud Storage(修理の記録の文書。前後の写真は工房の中のフォルダに置いたまま) | ― |
前後の写真と相談の写真は、検索のデータストアに入れません。 相談の写真には、人形と一緒に家の中や家族が写っていることがあります。検索するのは受付が付けた区分と記録の文だけにし、写真は職人が工房の中のフォルダで見ます。
土台になるのは、属性での絞り込みと、answer メソッドの引用です。 公式ページでは、絞り込みで文字の項目は ANY による完全一致、日時の項目は ISO 8601 の日時との比較ができ、answer メソッドは引用を付けた答えを返せるとされています。公式ページの言語の一覧では、日本語(ja-JP)は検索と answer の両方に対応しています。
03どうやって実装するのか
処理の起点を決める
受付が区分を選び、職人が確かめて「探す」を押したことを起点にします。 相談のメールが届いただけでは動かしません。区分の決まらないまま探すと、近くない事例を引き、職人がそれに引きずられるからです。 受付は相談を読みながら区分を選び、作業場の職人の画面に回します。
修理の記録の取り込みは、修理を終えて受付が記録を登録したときに動かします。 過去の表計算の記録は、最初に一度だけまとめて取り込みます。紙の受付票の時代の記録は、古い職人が覚えている事例から順に転記します。
入力データを集める
| データ | 中身 | 取得元 |
|---|---|---|
| 相談の区分 | 人形の種類、部位、傷みの種類(いずれも決まった言葉)、作家物・箱書きの有無、相談の番号 | 検索の画面(受付が選び、職人が確かめる) |
| 区分の表 | 人形の種類・部位・傷みの決まった言葉と、記録に書かれてきた言い方の対応 | 職人の長が作る表計算 |
| 修理の記録 | 記録の番号、受けた日、人形の種類、部位、傷み、使った材料、手順の要点、注意点、結果(修理した/断った/別の方法をすすめた)、預かった日数、請求の額、写真のフォルダ名 | 修理の記録の表計算と、紙の受付票の転記 |
| 相談の本文と写真 | 相談した人の文と写真 | 問い合わせの窓口(検索には入れない) |
質を決めるのは、区分の表です。 「ひび」「割れ」「亀裂」「ヒビ割れ」を「胡粉のひび」と「木地の割れ」の2つに分け、記録に書かれてきた言い方をどちらかに対応させます。分けずにまとめると、表面のひびの事例と木地の割れの事例が同じ一覧に並び、額の幅が大きく開きます。
修理の記録の結果の欄に、断った事例も入れます。 作家物で手を入れないほうがよい、傷みが進んで直すと元の姿が残らない、供養をすすめた。断った理由を残しておくと、同じ相談に同じ説明ができます。 これまで残していなかったので、運用を始めてから受付が登録します。
データの取得方法を決める
| 取るもの | どこから | 何に使うか |
|---|---|---|
| 2014年以降の記録 | 修理の記録の表計算を1行ずつ読み、1体1文書の HTML にする | 近い事例の一覧と、手順と注意点の引用 |
| 2013年以前の記録 | 紙の受付票と作業の綴りを、受付が表の形に転記して同じく HTML にする | 同上 |
| 区分の表 | 職人の長の表計算 | 記録の言い方を決まった言葉に直す |
記録は、1体の修理を1文書にします。 1件の受付で何体も預かった修理は、人形ごとに分けます。ひな人形の七段飾りを1文書にすると、親王の顔の修理と官女の衣装の修理が同じ文書になり、部位で絞り込めなくなります。 公式ページでは、文書ごとに structData で属性を付け、本文を Cloud Storage の HTML や PDF で指定する形が示されています。
取り込むときに、記録の傷みの欄の言い方を区分の表で決まった言葉に直します。 直せなかった言い方は取り込みを止めて一覧にし、職人の長が区分の表に足すか、記録を直します。直さずに入れると、その記録は傷みで絞り込んだ検索に出てきません。
記録には、たとえば次のように属性を付けます。
{"id": "rep-2021-0318-02",
"structData": {"doc_kind": "repair_record",
"received_on": "2021-03-18T00:00:00+09:00",
"doll_type": "ichimatsu", "part": ["face"],
"damage": ["gofun_crack"], "signed_work": true,
"outcome": "repaired", "days_kept": 74,
"amount_yen": 33000, "photo_folder": "2021/0318-02"},
"content": {"mimeType": "text/html",
"uri": "gs://<bucket>/records/2021/rep-2021-0318-02.html"}}
amount_yen には請求の額を入れます。上の例の額と日数は形を示すための架空の値です。断った事例は額が無いので、0 にせず項目ごと入れません。 本文の HTML には、使った材料、手順の要点、注意点、断った理由を、職人の言葉のまま入れます。相談した人の名前と住所と電話番号は、本文にも属性にも入れません。
AIへ渡す前に整形する
- 区分の確かめ … 受付の選んだ区分を職人が確かめたかを見て、確かめていなければ探さずに作業場の画面に戻します
- 複数体の分け … 1件の相談に複数の人形があれば、1体ずつに分けて別々に探します
- 絞り込みの式の組み立て … 人形の種類と部位と傷みで絞ります。作家物のときは、作家物の事例を先に並べます
- 額の計算の範囲 … 額と日数の計算は、受けた日が過去5年の事例だけに絞ります。材料の値段や工房の料金が変わるためです
- 問い合わせ文の組み立て … 「(人形の種類)の(部位)の(傷み)を、どう修理したか、何に気を付けたか、断った例はあるか」の形に整えます
絞り込みの条件は、たとえば次のようになります(公式ページの書き方による)。
filter(近い事例の一覧と、手順と注意点):
doc_kind: ANY("repair_record") AND doll_type: ANY("ichimatsu")
AND part: ANY("face") AND damage: ANY("gofun_crack")
filter(期間と額の計算に使う事例):
上記 AND outcome: ANY("repaired")
AND received_on >= "2021-11-01T00:00:00+09:00"
公式ページでは、ANY は値の完全一致で、日時の項目は比較の演算子で ISO 8601 の日時と比べられ、AND・OR で式をつなげるとされています。額の計算から断った事例を外しているのは、額の無い事例が入ると件数だけが増えて幅の読み方を誤らせるためです。
4番目の5年の範囲は、手順と注意点の側には掛けません。 古い事例でも、胡粉の扱いや衣装のしみの抜き方の注意点は今も役に立ちます。範囲を掛けるのは額と日数の計算だけです。
AIに処理させる
answer メソッドにさせるのは、近い事例の手順と注意点と、断った・別の方法をすすめた事例を、記録の番号を付けて引用付きでまとめることです。
| 返させるもの | 中身 | 返せないときの扱い |
|---|---|---|
| 手順の要点 | 事例でどこまで手を入れたか(記録の文のまま) | 見つからなければ「近い修理の記録は見つかりませんでした」 |
| 注意点 | 色合わせ、材料、作家物の扱いなど | 書かれていなければ書かない |
| 断った・別の方法をすすめた事例 | その理由(記録の文のまま) | 無ければ「断った事例はありません」 |
search メソッドにさせるのは、近い事例の一覧です。 一覧の表は、中継プログラムが各記録の属性から作り、記録の番号、受けた日、結果、預かった日数、請求の額、写真のフォルダへのリンクを並べます。期間と額の幅は、その属性から中継プログラムが計算します。
| させないこと | 理由 |
|---|---|
| 写真から傷みを見立てる | 見立ては職人が写真で行い、区分で探す |
| 金額・日数を文に書く | 属性から計算する。文に書かせると、どの事例の数字か分からない |
| 見積の額を決める | 現物を見て職人が決める |
| 修理を受けるか断るかを言う | 作家物の扱いや持ち主の思いを聞いて職人が決める |
| 相談した人への返信を書く | 受付が、事例と職人の判断をもとに書く |
2行目がいちばん起きやすい失敗です。 記録の本文には請求の額も預かった日数も書かれているので、何も言わなければ答えに「約○万円、2か月ほど」と入ります。受付がそれを返信に写すと、職人の決めた幅と違う額が相談した人に届きます。
指示内容を固定する
answer メソッドでは、回答の口調や詳しさをプロンプトの前置き(preamble)で指定できます。前置きを次のようにします。
あなたは人形の修理工房で、見積の返信の前に過去の修理の記録を確かめる
職人を手伝う係です。読むのは職人と受付です。
検索で見つかった工房の修理の記録だけを根拠に、次の順番で短く書いてください。
書く順番:
1. 近い修理の記録で、どこまで手を入れたか(記録の番号を必ず添える)
2. その記録に書かれた注意点(色合わせ・材料・作家物の扱いなど)
3. 修理を断った、または別の方法をすすめた記録と、その理由
守ること:
- 金額と日数は書かないでください。別の表で示します。
- 記録の文のまま書き、言い換えないでください。
- 写真の様子や傷みの程度を推し量って書かないでください。
- 今回の相談を受けるべきか、断るべきかは書かないでください。
- 記録に書かれていない一般的な人形の修理の知識を足さないでください。
- 近い記録が見つからないときは
「近い修理の記録は見つかりませんでした」と書いてください。
「記録の番号を必ず添える」を入れないと、「以前、同様の修理を行っています」のような答えになります。 職人が要るのは「どの記録か」で、番号が無いと、前後の写真のフォルダを開けません。
3番目を順番に入れているのは、断った事例が最も探しにくいからです。 手順の事例は職人の記憶にも残りますが、断った理由は、断った職人しか覚えていません。
あわせて、answer メソッドの設定を次のようにします。
| 設定 | 値 | 理由 |
|---|---|---|
引用(includeCitations) | 有効 | 文ごとに記録を示させる |
関連性の低い内容の無視(ignoreLowRelevantContent) | 有効 | 関係の薄い記録から無理に答えさせない |
根拠の支持による絞り込み(groundingSpec の filteringLevel) | FILTERING_LEVEL_LOW | 注意点の言い回しは職人ごとに違うので、絞りすぎない |
| 回答の言語 | ja | 日本語で答えさせる |
返す結果の数(maxReturnResults) | 20 | 同じ傷みの事例を広く拾う。公式ページでは既定10・最大25 |
FILTERING_LEVEL_LOW にしているのは、答えを読むのが職人で、引用と写真で確かめるからです。 公式ページでは、filteringLevel を指定しなければ支持の点数での絞り込みは掛からないとされ、引用の位置は UTF-8 のバイト単位とされています。画面で引用の箇所に印を付けるときは、文字数ではなくバイト数で切り出します。
出力形式を固定する
中継プログラムが、応答を次の形にそろえて作業場の画面に渡します。
{
"inquiry_id": "", "doll_index": 1, "checked_by": "",
"category": { "doll_type": "ichimatsu", "part": ["face"],
"damage": ["gofun_crack"], "signed_work": true },
"cases": [ { "doc_id": "", "received_on": "2021-03-18", "outcome": "repaired",
"days_kept": 74, "amount_yen": null, "photo_folder": "" } ],
"range_for_estimate": { "basis_count": 0, "since": "2021-11-01",
"days_min": null, "days_max": null,
"amount_min_yen": null, "amount_max_yen": null },
"notes_answer": "",
"notes_citations": [ { "sentence": "", "doc_id": "" } ],
"declined_cases": [ { "doc_id": "", "reason_excerpt": "" } ],
"skipped_reason": ""
}
1つ目の理由は、range_for_estimate に計算の元の件数(basis_count)を持てることです。 3件から出した幅と30件から出した幅は、同じ幅でも重みが違います。件数が3件に満たないときは、画面で幅を出さずに事例の一覧だけを見せます。
2つ目は、declined_cases を手順の事例と分けて持てることです。 断った事例と理由が別の欄に並ぶので、職人が「受けるか」を考える材料が、手順の事例に埋もれません。
3つ目は、doll_index で1件の相談の何体目かを持てることです。 ひな人形の相談では、親王の顔と官女の衣装で事例も幅も別々に出し、受付は体ごとの幅を並べて返信を書けます。
システムへ連携する
| つなぎ先 | 方式 | 内容 |
|---|---|---|
| 検索の画面 | 中継プログラムの画面 | 区分の選択と確かめ、結果の表示 |
| 区分の表 | 中継プログラムの読み取り | 決まった言葉と、記録の言い方の対応 |
| Vertex AI Search | search メソッドと answer メソッドの API | 近い事例の一覧と、手順と注意点 |
| 写真のフォルダ | 工房の中の共有フォルダへのリンク | 前後の写真を職人が見る |
| 修理の記録の登録の画面 | 中継プログラムの画面 | 修理を終えた記録と、断った相談の登録 |
問い合わせの窓口のメールには、この構成から書き込みません。 返信は受付が書いて送ります。見積の表計算にも書き込まず、職人の決めた幅を受付が写します。
人が確認する
- 区分を確かめる … 写真を見て、受付の選んだ傷みの種類が合っているかを職人が見ます。表面のひびか木地の割れかは、ここで決めます
- 写真で事例を見比べる … 一覧の上位の事例の前後の写真を開き、今回の傷みと近いかを見ます
- 幅を決める … 計算された幅と件数を見て、今回の幅を職人が決めます。作家物や傷みの重いものは幅を広げます
- 受けるかを決める … 断った事例があれば理由を読み、今回の扱いを決めます
- 返信を見る … 受付が書いた返信の幅と、確定の額は現物を見てから出す旨を、職人が見ます
3番目を省かないでください。 計算された幅は過去の事例の請求の額で、今回の人形の傷みの重さは入っていません。 写真で傷みが重く見えるのに過去の幅をそのまま返すと、現物を見たあとに額が上がり、相談した人を驚かせます。
目標は、90件をならして1件8分です。 区分を確かめ、写真で事例を見比べ、幅を決める時間です。一度に何体も届いた相談は時間がかかり、1体だけの相談はすぐ終わります。
例外に対処する
| 起きること | 対応 |
|---|---|
| 写真では傷みを見立てられない | 区分を選ばず、現物を送ってもらう案内を受付が返す |
| 近い事例が0件 | 部位だけを外した検索を1回だけ行い、外したことを画面に出す |
| 幅の計算の元の事例が3件未満 | 幅を出さず、事例の一覧だけを見せる |
| 記録の傷みの言い方が区分の表に無い | 取り込みを止め、職人の長が区分の表に足す |
| 相談の人形に作家の落款・箱書きがある | 作家物の事例を先に並べ、職人の長に回す |
| 答えが作られなかった(支持が低い) | 答えの文を出さず、事例の一覧だけを出す |
1行目を例外として扱うのが大事です。 写真がぼやけている、正面しか写っていない、ひびが胡粉の表面か木地まで達しているか分からない。 そのまま区分を選んで探すと、軽いほうの事例の幅を返すことになります。
記録を残す
- 検索(相談の番号、何体目か、受付の選んだ区分、職人が直した区分、時刻)
- search メソッドと answer メソッドの応答の全文
- 計算した幅と、計算の元の事例の番号
- 職人が決めた幅と、受付が送った返信の幅
- 現物を見たあとの確定の額と、返信の幅との差
5つ目が、幅の決め方を育てます。 返信の幅と確定の額の差を傷みの種類ごとに見ると、幅が狭すぎる傷みと、広すぎる傷みが分かります。 半年に一度、職人の長が見て、幅の決め方を直します。
04実装レベルの3段階
半自動化で、1件30分が16分ほどになります。 事例は見つかりますが、幅の計算と、言い方の揺れで漏れた事例の探し直しが職人の手に残ります。本格構成で8分になり、この段階が本記事の想定です。 差が大きいのは、区分で絞った事例の幅が、件数付きで画面に並ぶからです。 断った事例の登録は、半自動化の段階から始めてください。 本格構成で断った事例を出すとき、それまでに登録した分しか出てきません。 古い職人に、覚えている断った事例を書き出してもらうのも、この段階が向いています。 本格構成でも、返信を書く人は変えません。 変わるのは返信の前の下調べで、古い職人がいない日にも、同じ区分の事例と幅が同じ画面で確かめられることです。
05工数削減シミュレーション
導入後 90件 × 8分 ÷ 60 = 12 時間/月
自社条件で導入効果を整理したい方へ
このユースケースを自社に当てはめた場合の前提値と削減見込みを、業務ヒアリングをもとに整理します。
06向いている企業・向いていない企業
- 日本人形・ひな人形・市松人形・五月人形などの修理を全国から郵送で受け、写真付きの見積の相談が月に数十件以上届く人形の工房・人形店の修理部門。修理の記録(受付票・作業の記録・請求の額・前後の写真)を十年以上残してきたが、近い事例を探せるのが古参の職人だけの場合。見積の返信までに日数がかかり、相談した人が別の工房に流れている場合。
- 修理の受付が年に数件で、職人が全部を覚えていられる場合。過去の修理の記録が残っておらず、事例を探す元が無い場合。写真から自動で見積の金額を出したい場合(この構成は金額を決めません)。なお、修理を受けるか、どこまで手を入れるか、見積の金額の判断は、この構成では代替できません。
07最小構成で試す方法
- よく受ける3つの区分(市松人形の顔の胡粉のひび、ひな人形の衣装のしみ、五月人形の鎧の糸の切れ)を選ぶ
- その区分の2014年以降の修理の記録から合わせて60件を選び、区分の表で傷みの言い方をそろえる
- 1体1文書の HTML にして、区分と結果と日数と額の属性を付けてデータストアを作る
- 最近の見積の相談から10件を選び、職人が区分を付けて、search メソッドと answer メソッドを短いスクリプトで呼ぶ
- 出てきた事例と計算した幅を、古い職人の見立てと突き合わせる
古い職人には、結果を見せる前に、10件それぞれについて思い出す事例と幅を書き出してもらいます。 結果を見てから答えてもらうと、出てきた事例に引きずられて、漏れに気づけなくなります。
10件のうち、答えに金額が入った件数と、記録の番号の無い答えの件数を最初に数えます。 どちらか1件でもあれば、前置きを直してから先へ進みます。
| 出てきた内容 | 判断 |
|---|---|
| 古い職人の思い出した事例と同じ記録が、番号と引用つきで出た | 残りの記録の取り込みと、検索の画面に進む |
| 表面のひびと木地の割れの事例が混ざった | 区分の表で2つに分け、記録の言い方を付け直す |
| 計算した幅が古い職人の幅より大きく開いた | 5年の範囲と、作家物の事例の扱いを見直す |
2行目が出ることは珍しくありません。 古い職人は、記録に「ひび」としか書いていなくても、写真を見て表面か木地かを頭の中で分けていました。 失敗ではなく、その人がいないと幅が開く理由が1つ分かったということです。 区分を分け、同じ10件で事例が混ざらないかを見てください。
08実装時につまずきやすいポイント
| 問題 | 対策 |
|---|---|
| 表面のひびと木地の割れの事例が混ざる | 区分の表で分け、職人が写真で見立てる |
| 答えに金額や日数が入る | 前置きで禁じ、幅は属性から計算する |
| 少ない事例から幅を出す | 計算の元の件数を出し、3件未満は幅を出さない |
| 古い事例の額で幅を出す | 額の計算は過去5年に絞る |
| 七段飾りを1文書で入れる | 1体1文書に分ける |
| 断った事例が出てこない | 結果の欄に断った事例を登録する |
| 相談の写真がデータストアに入る | 写真は工房のフォルダに置き、区分と記録の文だけを取り込む |
上の2行が、この構成の失敗のほとんどです。 どちらも、相談した人に届く幅が、職人の見立てと違ってしまうことにつながります。
3行目と4行目は、幅の読み方の問題です。 2件の事例から出した幅は、たまたまの2件の額で、次の相談には当てはまらないことがあります。 件数を画面に必ず出し、職人が重みを見て決めます。
最後の行は、取り込みの処理を書くときに起きやすい問題です。 写真のフォルダを丸ごと Cloud Storage に写すと、相談の写真まで入ります。取り込むのは、記録の表計算から作った HTML だけにします。
09セキュリティ・AIガバナンス上の注意点
この構成で扱うデータ: 修理の記録(人形の種類・傷み・手順・額)、相談の本文と写真(相談した人の名前・住所・電話番号、家の中や家族が写った写真を含みうる)、区分の表です。検索のデータストアには、相談した人の情報と写真を入れません。
- 利用の目的を確かめる … 個人情報保護法第17条は利用の目的をできる限り特定することを、第21条は取得したときに利用の目的を本人に通知するか公表することを求めています。過去の修理の記録を見積の材料に使うなら、利用の目的にその旨が入っているかを確かめ、相談の窓口とWebの案内に書きます
- 相談の写真を検索に入れない … 写真には人形の持ち主の家の中や家族が写ることがあります。写真は工房の中のフォルダに置き、職人だけが見ます
- 安全管理を決める … 同法第23条は、個人データの漏えい等を防ぐ安全管理の措置を求めています。写真のフォルダと記録の表計算の権限を、職人と受付だけに絞ります
- 受けるかの判断と見積の額を人に残す … 検索が返すのは過去の事例で、今回の人形の傷みの重さと持ち主の思いは入っていません。 受けるか、どこまで手を入れるか、確定の額は職人が決めます
- データの置き場所を確かめる … 公式ページでは、データストアの場所は
globalのほかus、euのマルチリージョンで、日本のリージョンは載っていません。 修理の記録を国外に置いてよいかを工房で決めます
誤りが起きた場合のリスクは、傷みの見立てを誤ったまま軽い事例の幅を返すことと、答えの文の金額を受付が返信に写すことの2つです。 前者は職人の区分の確かめで、後者は金額を属性からの計算に分けることで防ぎます。
10まず何から始めるか
1週目:区分の表を作る
職人の長が、人形の種類・部位・傷みの決まった言葉を決めます。表面のひびと木地の割れのように、手順と額の違うものは分けます。 記録に書かれてきた言い方を、決まった言葉に対応させます。
2週目:60件の記録を整える
よく受ける3つの区分の記録から60件を選び、傷みの言い方をそろえ、1体1文書にします。相談した人の名前や住所が本文に残っていないかを最優先で見ます。
3週目:10件で試す
第8章の手順でデータストアを作り、最近の相談の10件で確かめます。答えに金額が入っていないかと、記録の番号が添えられているかを最優先で見ます。
あわせて、利用の目的の書き方を確かめ、相談の窓口の案内に、過去の修理の記録を見積の材料に使う旨を書きます。
4週目:断った事例の登録を始める
修理の記録の登録の画面に結果の欄を足し、断った・別の方法をすすめた相談を受付が登録し始めます。古い職人に、覚えている断った事例を書き出してもらいます。
2か月目: 2014年以降の記録を全部取り込み、職人が使い始めます。3か月目以降: 幅の計算と、確定の額との差の記録を足し、1件30分が何分になったかを実測します。古い職人がいない日にも、職人が見積の相談ごとに、同じ区分の事例と手順と注意点、期間と額の幅を件数付きで確かめ、受付がその日のうちに返信を書けるようになった時点で、この構成は完成です。
11関連ユースケース
12この仕組みを理解するための記事
13技術仕様の確認日・参考情報
| 確認した内容 | 情報源 | 確認日 |
|---|---|---|
answer メソッドが引用付きの答えを作ること。前置き(preamble)。ignoreLowRelevantContent。filteringLevel が FILTERING_LEVEL_LOW/FILTERING_LEVEL_HIGH で未設定なら絞り込みが掛からないこと。maxReturnResults が既定10・最大25。引用の位置が UTF-8 のバイト単位。Enterprise エディションの機能。Agent Search へ改称中であること | Google Cloud: Get answers and follow-ups | 2026-11-16 |
ANY が完全一致であること。日時の項目を ISO 8601 の日時と比べられること。AND・OR で式をつなげること | Google Cloud: Filter custom search for structured or unstructured data | 2026-11-16 |
文書ごとに structData で属性を付け、本文を Cloud Storage の PDF・HTML で指定する形 | Google Cloud: Prepare data for ingesting | 2026-11-16 |
| 日本語(ja-JP)が検索の機能と answer の両方に対応していること | Google Cloud: Languages | 2026-11-16 |
データストアの場所が global と us・eu のマルチリージョンで、日本のリージョンの記載が無いこと | Google Cloud: Agent Search locations | 2026-11-16 |
| 個人情報保護法第17条(利用目的の特定)、第21条(取得に際しての利用目的の通知等)、第23条(安全管理措置)。2026-11-02 施行の版 | e-Gov 法令API: 個人情報の保護に関する法律 | 2026-11-16 |
修理を受けるか、どこまで手を入れるか、見積の額は、工房の職人が判断してください。 本記事は、上記の公開情報で確認できた範囲だけを扱っています。
実装ステータス:構成例。 公開仕様に基づいて設計した構成であり、当社で実際に構築・検証したものではありません。工数の数値はモデル条件による試算です。
自社の業務に使えるAI活用候補を整理します
このユースケース(UC-3104)についてのご相談はこちらから。
