AIを仮想読者にしてドキュメントのインサイトを見つけよう！ / Find insights in your document with AI

Technical Writing Meetup vol.44
2025/06/12(木) 19:00 〜 20:40
https://tw-meetup.connpass.com/event/357895/

Transcript

1. © LY Corporation Dev Content Team 古木 亮太朗 AIを仮想読者にして ドキュメントのインサイトを見つけよう！ Technical Writing Meetup vol. 44 2025.06.12
2. © LY Corporation 2 自己紹介 古木 亮太朗 LINEヤフー株式会社 テクニカルライター • 2019年LINE入社 • 2021年に社内公募でテクニカルライターに転身 • 2023年に会社合併によりLINEヤフー • 職歴 • ソフトウェアエンジニア • 広告代理店 • 副業でゲーム雑誌でライター業 • ウェブサービスの企画・ディレクター • テクニカルライター（現在）
3. © LY Corporation 本日の内容 3
4. © LY Corporation 4 本日の内容 • ライティングチームとしてAIをどう活用するか • 実際にやったこと（llms.txtを作って評価） • その結果得られたこと
5. © LY Corporation Dev Content Team 5
6. © LY Corporation 6 主な仕事 • 社外の開発者向けにドキュメントを提供 • 社内エンジニアが書いた文章のレビュー • 社内Wikiのコンサルティング • 社内用語集の運用 • ライティング教育
7. © LY Corporation 7 主な仕事
8. © LY Corporation • 社外の開発者向けドキュメントを提供 • 文章レビュー • 社内Wikiのコンサルティング • 社内用語集の運用 • ライティング教育 8 主な仕事 ★
9. © LY Corporation 9 LINEプラットフォーム
10. © LY Corporation 10 LINEログイン LINEのアカウントをソーシャルログインとして使える
11. © LY Corporation 11 Messaging API LINE公式アカウントの運用を自動化（ボット化）できる
12. © LY Corporation 12 LINEミニアプリ LINEアプリ上で利用できるミニアプリ
13. © LY Corporation LINEプラットフォーム使いたい！ 13
14. © LY Corporation 14 https://developers.line.biz/ LINE Developersサイト
15. © LY Corporation 15 生産者の顔
16. © LY Corporation 16 チームのミッション 役に立つドキュメントで開発をもっと楽しく （Make development fun with helpful docs）
17. © LY Corporation 17 目標について詳しくは Technical Writing Meetup vol.37
18. © LY Corporation 開発をもっと楽しくしたい！ 18
19. © LY Corporation AI活用 19
20. © LY Corporation 20 コーディングエージェント • Claude Code • Cline • Cursor • Devin • GitHub Copilot Agent • Google Jules • etc…
21. © LY Corporation AIを通じてドキュメントを「読む」 21
22. © LY Corporation チームとして何ができそう？ 22
23. © LY Corporation 23 アイディア • 開発者向けのチャットボット • FAQの充実／拡充 • AIを活用したドキュメント作成 • AI（LLM）向けのドキュメント提供
24. © LY Corporation 24 アイディア • 開発者向けのチャットボット • FAQの充実／拡充 • AIを活用したドキュメント作成 • AI（LLM）向けのドキュメント提供
25. © LY Corporation 25 AI（LLM）向けのドキュメント提供 目的：LLMに最新の情報を正確に提供する
26. © LY Corporation 26 AI（LLM）向けのドキュメント提供 目的：LLMに最新の情報を正確に提供する • llms.txt、llms-full.txtの公開 • GitHubでドキュメントソースを公開 • MCPサーバーの公開
27. © LY Corporation 27 llms.txt llms-full.txt • ウェブサイトのドキュメントをLLMがアクセスしやすいよ うに設計されたMarkdown形式のファイル • コンテンツの取り込みを単純化 -> プロンプト品質の向上 • llms.txtは概要、llms-full.txtは完全なコンテンツ • 現時点で標準規格ではない
28. © LY Corporation 28 GitHub • 狭義のオープンソース化（公開） • ドキュメントソースを公開することで自由に利用できる • GitHubを参照するAIツールも多数 • DeepWiki, Context7 • 副次的な効果として：更新差分、修正提案
29. © LY Corporation 29 MCPサーバー • MCP（Model Context Protocol） • LLMと外部データやサービス間のプロトコル • 開発ドキュメント視点 • 直接ドキュメントを参照させやすくする • LLM向けの検索 • 現時点で標準規格ではない
30. © LY Corporation 全部やりたい！ 30
31. © LY Corporation 全部やりたい！ 31
32. © LY Corporation 32 AI（LLM）向けのドキュメント提供 目的：LLMに最新の情報を正確に提供する • llms.txt、llms-full.txtの公開 • GitHubでドキュメントソースを公開 • MCPサーバーの公開
33. © LY Corporation llms(-full).txtを作ってみた話 33 （外部公開はこれから）
34. © LY Corporation 34 https://developers.line.biz/ LINE Developersサイト
35. © LY Corporation 35 https://developers.line.biz/ LINE Developersサイト
36. © LY Corporation llms.txtの評価 36 NotebookLMに読ませてみた
37. © LY Corporation 37 NotebookLM NotebookLMは、Googleが提供するAI搭載の ノートブックツールで、ユーザーがアップ ロードしたドキュメントをAIが理解し、要約、 検索、質疑応答などをサポートします。主な 機能は、資料のアップロード、AIによる解 析・要約、質疑応答、ノートブックの作成と 共有などです。 引用元：Google検索のAI概要より 引用元： Google Japan Blog NotebookLM を日本語でも提供開始。ウェブサイトや Google スライドにもサポート https://blog.google/intl/ja-jp/company-news/technology/notebooklm-google/
38. © LY Corporation 問題発生 38
39. © LY Corporation 39 私が回答を作成する際は、ユーザーに提供されたソーステキストと、これまでの会話履歴のみを参 照しています。 そのため、ソーステキストに含まれるURLリンクの先のウェブページの内容を直接参照したり、読 み込んだりすることはできません。私の知識は、あくまで提供されたソーステキストの中に書かれ ている情報に限られます。 Q. ソースに記載されているリンク先の情報も参照できますか？ llms.txtだけだと概要しか返してくれない
40. © LY Corporation llms-full.txtの評価 40 NotebookLMに読ませてみた 気を取り直して
41. © LY Corporation これでAIがいろいろ答えてくれる！ 41
42. © LY Corporation 42 評価方法 FAQの質問文（自然言語）をもとに質問 回答が得られるか FAQのページは あえてllms-fullに含めなかった
43. © LY Corporation すごく詳細な情報が取得できた！ ……あれ？ 43
44. © LY Corporation 44 問題点 でも、なんか答えてくれないものもあるぞ？
45. © LY Corporation 45 大きく2つの課題がありそう FAQはあるけどドキュメントには記載がない ドキュメントの内容を理解できてなさそう
46. © LY Corporation 46 大きく2つの課題がありそう FAQはあるけどドキュメントには記載がない ドキュメントの内容を理解できてなさそう
47. © LY Corporation 47 大きく2つの課題がありそう FAQはあるけどドキュメントには記載がない ドキュメントの内容を理解できてなさそう
48. © LY Corporation 48 ドキュメントの内容を理解できてなさそう AIが理解できない：ドキュメントが曖昧なせいかも？ AIが期待した答えを返してくれない：AI（モデル）のせい？
49. © LY Corporation 49 参考：Docs AIツールは、思っているより優れている 引用元：Alex Garnett - Docs AI Tooling is Better (and Better for Us) than You Think https://www.youtube.com/watch?v=6p6LttjaSNM • Alex Garnett氏 • Temporal Technologiesのシニアカリキュラム開発者 • AIのドキュメンテーション分野での活用について • 「既存のコンテンツを統合・活用して、ユーザーが求める情報 に迅速かつ正確にたどり着けるようにすること」に価値がある • AIを使ったライティングよりも価値がある • AIが回答できなかった不確実な回答や会話ログを分析して ドキュメントを改善 • kapa.aiの機能を活用している
50. © LY Corporation 50 参考：Docs AIツールは、思っているより優れている AIが回答に苦労する箇所は、 事前の知識が少ないユーザーにも コンテキストの問題となる
51. © LY Corporation たしかに！ 51
52. © LY Corporation 52 深掘り 質問を詳しく見てみる
53. © LY Corporation 53 Q. メッセージやリッチメニューを 国際化や多言語化できますか？ メッセージ リッチメニュー 現在、ユーザーの言語に応じて、メッセージやリッチ メニューの言語を切り替える機能はありません。 プロフィール情報を取得するエンドポイントを使って、 ユーザーの言語を取得した上で、ユーザーの言語に応 じたメッセージの送信やユーザー単位のリッチメ ニューの設定を行ってください。 引用元：LINE DevelopersサイトのFAQより
54. © LY Corporation 54 Q. メッセージやリッチメニューを 国際化や多言語化できますか？ 提供されたソースには、メッセージやリッチメニュー自体に複数の言語設定を持たせて、ユー ザーの言語設定に応じて自動的に表示を切り替えるといった直接的な「国際化・多言語化」機能 に関する明確な記載はありません。 しかし、Messaging APIの以下の機能を利用することで、開発者側で多言語対応を実現することが 考えられます。 • メッセージの送り分け: • ユーザーごとに異なる言語のメッセージコンテンツ（テキスト、画像、Flex Messageな ど）を作成し、送り分けることが技術的に可能です • リッチメニューのユーザー単位設定: • Messaging APIを使用すると、ユーザーごとに異なるリッチメニューをリンクできます • 開発者側でユーザーの言語などを判断し、そのユーザーに対して言語の異なるリッチメ ニューを割り当てることで、ユーザーごとに表示されるリッチメニューを切り替えること が可能です
55. © LY Corporation 55 Q.応答メッセージはメッセージ通数に カウントされますか？ ソースの情報に基づくと、応答メッセージはメッセージ通数にカウントされます。 ちょっと待って
56. © LY Corporation 何を聞いているかわかりましたか？ 56
57. © LY Corporation 57 質問自体のコンテキストが高い（料金の話） https://developers.line.biz/ja/faq/
58. © LY Corporation 58 料金の話はそもそもちょっとむずかしい https://www.lycbiz.com/jp/service/line-official-account/plan/ 料金プランごとに送れる無料メッセージの通数が異なる これを消費するか という話
59. © LY Corporation 59 メッセージ通数という概念が2つある メッセージ通数： （無料メッセージ通数としてカウントされる送信方法で送った）メッセージ通数： 月毎に送信できる無料メッセージ通数として何通メッセージを送ったか どんな方法（API）で何通メッセージを送ったか Q. 応答メッセージはメッセージ通数にカウントされますか？
60. © LY Corporation 質問文を整理して聞いてみる 60
61. © LY Corporation 61 Q.応答メッセージは無料で送信できますか？ 応答メッセージが無料で送信できるかどうかは、LINE公式アカウントの契約プランによって割り 当てられている月間の無料メッセージ通数の上限内かどうかによります。 難しいよね、ごめん
62. © LY Corporation メッセージ通数の記載に関しては 改善の余地がありそう！ 62
63. © LY Corporation 63 まとめ ドキュメントに記載されていない内容に気づけた NotebookLMにllms-full.txtを入力して AIを仮想読者にすることで 曖昧なコンテキストに気づけた（メッセージ通数） ドキュメントに対するインサイト（改善事項）が得られた
64. © LY Corporation 64 まとめ ここが分かりにくい
65. © LY Corporation Thank you!