Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
第151回 雲勉 プロジェクトのドキュメントにおける課題をAmazon Bedrockで解決してみる
Search
iret.kumoben
January 17, 2025
Technology
0
58
第151回 雲勉 プロジェクトのドキュメントにおける課題をAmazon Bedrockで解決してみる
下記、勉強会での資料です。
https://youtu.be/CeN9sHB9GnA
iret.kumoben
January 17, 2025
Tweet
Share
More Decks by iret.kumoben
See All by iret.kumoben
第154回 雲勉 AWS Codeシリーズ盛り上げ隊 ~ Codeシリーズは砕けない ~
iret
0
35
第153回 雲勉 トラシューが秒で終わる新機能 Amazon Q Developer operational investigations
iret
0
50
第150回 雲勉 AWS AppSyncではじめるGraphQL体験
iret
0
42
第152回 雲勉 シームレスなマルチリージョンへの移行と検討 ~Amazon EKSとAWS Global Acceleratorを使用した環境〜
iret
0
52
第149回 雲勉 AWS ベストプラクティスの最新と実際 AWS Well-Architected
iret
0
85
第148回 雲勉 Web アプリケーションセキュリティ
iret
0
50
第147回 雲勉 Amazon CloudWatchをウォッチ!
iret
0
65
第146回 雲勉 BLEAを眺めてCDKの書き方について学ぶ
iret
1
71
第145回 雲勉 Amazon ECSでサービス間通信する方法を調べてみよう
iret
0
74
Other Decks in Technology
See All in Technology
Goで作って学ぶWebSocket
ryuichi1208
3
2.3k
生成 AI プロダクトを育てる技術 〜データ品質向上による継続的な価値創出の実践〜
icoxfog417
PRO
5
1.8k
開発組織のための セキュアコーディング研修の始め方
flatt_security
3
2.7k
Amazon S3 Tablesと外部分析基盤連携について / Amazon S3 Tables and External Data Analytics Platform
nttcom
0
150
抽象化をするということ - 具体と抽象の往復を身につける / Abstraction and concretization
soudai
27
14k
地方拠点で エンジニアリングマネージャーってできるの? 〜地方という制約を楽しむオーナーシップとコミュニティ作り〜
1coin
1
250
Oracle Cloud Infrastructure:2025年2月度サービス・アップデート
oracle4engineer
PRO
1
320
なぜ私は自分が使わないサービスを作るのか? / Why would I create a service that I would not use?
aiandrox
0
870
Reading Code Is Harder Than Writing It
trishagee
2
110
Classmethod AI Talks(CATs) #17 司会進行スライド(2025.02.19) / classmethod-ai-talks-aka-cats_moderator-slides_vol17_2025-02-19
shinyaa31
0
160
2.5Dモデルのすべて
yu4u
2
930
Moved to https://speakerdeck.com/toshihue/presales-engineer-career-bridging-tech-biz-ja
toshihue
2
830
Featured
See All Featured
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
12
980
Chrome DevTools: State of the Union 2024 - Debugging React & Beyond
addyosmani
4
350
XXLCSS - How to scale CSS and keep your sanity
sugarenia
248
1.3M
Understanding Cognitive Biases in Performance Measurement
bluesmoon
27
1.6k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
27
1.9k
A better future with KSS
kneath
238
17k
Designing on Purpose - Digital PM Summit 2013
jponch
117
7.1k
Faster Mobile Websites
deanohume
306
31k
The Art of Delivering Value - GDevCon NA Keynote
reverentgeek
10
1.3k
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
mongodb
45
9.4k
Fontdeck: Realign not Redesign
paulrobertlloyd
83
5.4k
Adopting Sorbet at Scale
ufuk
74
9.2k
Transcript
第151回 雲勉 プロジェクトのドキュメントにおける課題を Amazon Bedrockで解決してみる
講師自己紹介 2 矢原 亮汰 • DX開発事業部 • 2020年アイレットに新卒で入社 • 本日の対象者:
Amazon Bedrockに興味のある方/ドキュメントの運用でお困りの方 • ご質問は YouTubeのコメント欄で受け付けております。 後日回答させていただきます!
アジェンダ 3 1. プロジェクトにおけるドキュメントの課題 2. 生成AI導入前の解決したい課題の整理 3. 生成AIを利用した課題の対処法 4.
まとめ
1. プロジェクトにおけるドキュメントの課題 4
このような経験はありませんか? ケース① 5 色々な場所に情報が保存されていて、情報の更新が止まってしまう
このような経験はありませんか? ケース② 6 なぜこの仕様 なんでしたっけ? 仕様はドキュメントに書かれているが、 引き継いだプロジェクトで前任者がおらず、当時の経緯が残ってない・・・
このような経験はありませんか? ケース② 7 設計書 • システム上で決められたことは書かれている • 経緯が抜けていることが多い
◦ Whyの部分 サービスが運用に入ると「なぜこの仕様になったか?」という 疑問が生じることが往々にしてある 1年2年後には担当者が変わっていることが多い → 経緯に辿り着けず仕様を変更するのが怖い
このような経験はありませんか? ケース② 8 ただ、経緯を全て書くのはとても大変で工数がかかる メモ程度に書いていても後でその情報に辿り着くのが難しい
それぞれのケースの問題点 9 ケース① • ツールが乱立し情報を一元化されておらずドキュメントの 保守性が低い
ケース② • 欲しい情報に辿り着けない/情報が残っていない
2. 生成AI導入前に解決したい課題の整理 10
解消したい課題の整理 11 ケース① • ツールが乱立し情報を一元化されておらずドキュメントの 保守性が低い 改善したいこと
• 常に情報が最新化されている • 更新コストを下げる
解消したい課題の整理 12 ケース② • 欲しい情報に辿り着けない/情報が残っていない 改善したいこと •
欲しい情報を残す • 経緯の部分も含めて情報に辿りつきやすくする
解消したい課題の整理 13 ケース 問題点 対処法 ケース① 情報が様々なところにあり、更新が大変で保守性が低い 常に情報を最新化する 更新が楽になるような仕組みづくり
ケース② 欲しい情報が残っていない/情報に辿り着けない 欲しい情報を残す 情報に辿り着くための検索が容易になる仕組みづくり
解消したい課題の整理 14 ケース 問題点 対処法 ケース① 情報が様々なところにあり、更新が大変で保守性が低い 常に情報を最新化する 更新が楽になるような仕組みづくり
ケース② 欲しい情報が残っていない/情報に辿り着けない 欲しい情報を残す 情報に辿り着くための検索が容易になる仕組みづくり 生成AI(Amazon Bedrock)を利用して これらの問題の対処法の 1例をご紹介!
3. 生成AIを利用した課題への対処法 15
課題への対処法 16 ケース 問題点 対処法 ケース① 情報が様々なところにあり、更新が大変で保守性が低い 常に情報を最新化する 更新が楽になるような仕組みづくり
ケース② 欲しい情報が残っていない/情報に辿り着けない 欲しい情報を残す 情報に辿り着くための検索が容易になる仕組みづくり
常に情報を最新化する/更新が楽になる仕組みづくり 17 メインのツールを決め、表現が難しいものはサブツールを利用する
常に情報を最新化する/更新が楽になる仕組みづくり 18 Docusaurusとは • Meta社が作成したドキュメントサイトなどを 簡単に構築できるサイトジェネレータ
• Reactベースで作られている • Markdownでドキュメントを記載
常に情報を最新化する/更新が楽になる仕組みづくり 19 設計書をGitHubで管理 • フロントエンドやバックエンドのソースコードと同じリポジトリで管 理(Monorepo)
→ 同じPull Requestで設計書とソースコードの変更を確認できる → 仕様に対するやりとりなどをGitHub上に履歴として残せる → 変更しようとするときにブラウザであちこち遷移して確認する必要 がなくなり、更新が楽になる(更新のストレスが減る) → 設計書もレビューした状態で最新化できる → 設計書を生成AIに読み取られせて情報を最新化できる仕組みを 作れる / ├─ docs ├─ frontend └─ backend
常に情報を最新化する/更新が楽になる仕組みづくり 20 ドキュメントを一元管理し、テスト仕様書を生成AIで作成する
常に情報を最新化する/更新が楽になる仕組みづくり 21 ドキュメントを一元管理し、テスト仕様書を生成AIで作成する
常に情報を最新化する/更新が楽になる仕組みづくり 22 ドキュメントを一元管理し、テスト仕様書を生成AIで作成する
常に情報を最新化する/更新が楽になる仕組みづくり 23
常に情報を最新化する/更新が楽になる仕組みづくり 24
常に情報を最新化する/更新が楽になる仕組みづくり 25
常に情報を最新化する/更新が楽になる仕組みづくり 26
常に情報を最新化する/更新が楽になる仕組みづくり 27
課題への対処法(情報の最新化) 28 設計書 Bedrockから返された テストケース
4.課題への対処法(情報の最新化) 29
欲しい情報(経緯)を残す仕組みづくり 30 経緯を設計書に残しておくことで「なぜ?」の部分が少なくなる
欲しい情報(経緯)を残す仕組みづくり 31 経緯は参考情報として記載 • 載せすぎると邪魔な情報になる • トグルで表示・非表示を切り替えられるように
4. まとめ 32
まとめ 33 • 課題を見つけてそれを解決するのに生成AIを一つの選択肢として考える → OSSのツールなどで利用できるのを何も考えずに生成AIを使用するのはよくない(お金がかかる) •
ドキュメントとソースコードを近くで管理することで、これからの生成AIアップデートでより活用しやすくなる • 生成AIで開発プロセス・運用フローを楽にしよう!