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
77
第151回 雲勉 プロジェクトのドキュメントにおける課題をAmazon Bedrockで解決してみる
下記、勉強会での資料です。
https://youtu.be/CeN9sHB9GnA
iret.kumoben
January 17, 2025
Tweet
Share
More Decks by iret.kumoben
See All by iret.kumoben
第159回 雲勉 Amazon Bedrock でブラウザを操作する AI エージェントを作ってみた
iret
0
51
第158回 雲勉 AWS CDK 入門 ~ プログラミング言語で書くインフラ Python 編 ~
iret
0
42
第157回 雲勉 AWSインフラ監視をNew Relicで行う際の個人的Tips
iret
0
41
第156回 雲勉 AWS on Windows入門
iret
0
77
第155回 雲勉 サーバレスアーキテクチャを 用いたコスト重視 AI サービス
iret
0
54
第154回 雲勉 AWS Codeシリーズ盛り上げ隊 ~ Codeシリーズは砕けない ~
iret
0
57
第153回 雲勉 トラシューが秒で終わる新機能 Amazon Q Developer operational investigations
iret
0
67
第150回 雲勉 AWS AppSyncではじめるGraphQL体験
iret
0
66
第152回 雲勉 シームレスなマルチリージョンへの移行と検討 ~Amazon EKSとAWS Global Acceleratorを使用した環境〜
iret
0
87
Other Decks in Technology
See All in Technology
「経験の点」の位置を意識したキャリア形成 / Career development with an awareness of the “point of experience” position
pauli
4
100
Cross Data Platforms Meetup LT 20250422
tarotaro0129
1
690
アセスメントで紐解く、10Xのデータマネジメントの軌跡
10xinc
1
440
サーバレス、コンテナ、データベース特化型機能をご紹介。CloudWatch をもっと使いこなそう!
o11yfes2023
0
180
C++26アップデート 2025-03
faithandbrave
0
630
読んで学ぶ Amplify Gen2 / Amplify と CDK の関係を紐解く #jawsug_tokyo
tacck
PRO
1
160
Spring Bootで実装とインフラをこれでもかと分離するための試み
shintanimoto
7
850
SDカードフォレンジック
su3158
1
630
LLM as プロダクト開発のパワードスーツ
layerx
PRO
1
240
Devinで模索する AIファースト開発〜ゼロベースから始めるDevOpsの進化〜
potix2
PRO
8
3.5k
日経電子版 for Android の技術的課題と取り組み(令和最新版)/android-20250423
nikkei_engineer_recruiting
0
410
AWS全冠芸人が見た世界 ~資格取得より大切なこと~
masakiokuda
5
6.3k
Featured
See All Featured
Being A Developer After 40
akosma
91
590k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
251
21k
The Power of CSS Pseudo Elements
geoffreycrofte
75
5.8k
Adopting Sorbet at Scale
ufuk
76
9.3k
Java REST API Framework Comparison - PWX 2021
mraible
30
8.5k
Into the Great Unknown - MozCon
thekraken
37
1.7k
Building Applications with DynamoDB
mza
94
6.3k
What’s in a name? Adding method to the madness
productmarketing
PRO
22
3.4k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
231
53k
The Language of Interfaces
destraynor
157
25k
I Don’t Have Time: Getting Over the Fear to Launch Your Podcast
jcasabona
32
2.2k
Save Time (by Creating Custom Rails Generators)
garrettdimon
PRO
31
1.1k
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で開発プロセス・運用フローを楽にしよう!