20260720_クラウド女子会×PyLadiesTokyoコラボ Amazon Bedrock ハンズオン用資料

クラウド女子会さんとPyLadies Tokyoのコラボイベントに使用した、ハンズオンの補足説明用資料です！

イベントリンクはこちら↓
https://jawsug-cloudgirl.connpass.com/event/395492/

Workshopのコンテンツはこちら↓
https://catalog.us-east-1.prod.workshops.aws/workshops/0da6f9f4-c42f-4d47-90df-f89f4ab57e41/ja-JP

Transcript

1. クラウド女子会 ×PyLadies Tokyoコラボ会 Amazon Bedrockハンズオン 2026/07/20 yuuuka@PyLadies Tokyo
2. 自己紹介@yuuuka • 文系20卒 • 某外資系企業のエンジニア • PyLadies Tokyo staff(since 2023/06) • Like:Python,AWS,猫, Kiro
3. 初同人誌寄稿 📖 ゆめみより '26 「ゆめみより製作委員会」合同技術書 📝 EC2で Pythonのデータ分析ライブラリを比較した話 📝 Kiroの有料サブスクリプションを無料で適用した話 0円 でダウンロードできます techbookfest.org
4. この資料について 難しい用語は「ぜんぶ覚えなくてOK」です! 用語を先取り 手順書に出てくる用語を、初心者向けにやさしく解説します。 辞書として使ってください 「これなんだっけ?」となったら戻ってくればOK。暗記は不要! 動かして体感するのがいちばん 手を動かしたあとに「こういうことか!」とつながります。 4
5. ハンズオンのインフラ構成図 📖 ハンズオン手順書はこちら(クリックでWorkshop Studioが開きます)
6. ハンズオンのお品書き AIに質問できるWebアプリを、作って学んでみましょう! 作成する環境のイメージ あなた 質問する API ⇄ Amplify ⇄ Gateway 画面を公開 受付窓口 ⇄ Lambda ⇄ Bedrock コード実行 AIが回答 ① Amplifyで画面を公開 ② LambdaでAIを呼ぶ ③ API Gatewayでつなぐ ④ Bedrockでモデルを設定する リージョンはオレゴン(us-west-2) / 余裕があれば発展編にも挑戦! 6
7. はじめる前に : 環境の確認 AWS公式の無料ハンズオン環境(Workshop Studio)を使います ☑ Workshopの利用申請はお済みですか ? connpassイベントページの案内から、事前の利用申請が必要です。 ☑ 当日はアクセスコードでサインイン イベントアクセスコードを入れるだけ。個人のAWSアカウントは不要で す。 ⚠ 個人アカウントでの代用は非推奨 Claudeの初回利用はユースケース申請が必要+新しいアカウントは 利用上限が低く動かないことも。 7
8. ① クラウドの基本用語 まずは「クラウドってどんな世界?」を知ることばから
9. クラウドの基本用語 (1/2) AWS(Amazon Web Services) Amazonのクラウドサービス。サーバーやAIなど200以上の機能を、必要 なぶんだけ借りられます。 たとえるなら … ITのレンタルショップ。使ったぶんだけ払う。 リージョン AWSのデータセンターがある地域のこと。画面右上のリージョン表示を最 初に必ず確認しましょう! 本日はオレゴン(us-west-2)リージョンを使用します。 9
10. クラウドの基本用語 (2/2) マネジメントコンソール ブラウザからAWSを操作する画面。上部の検索バーにサービス名を入れ て移動します。 たとえるなら … AWSの総合受付。ここから全サービスへ。 IAM 「誰が何をしてよいか」の管理。権限のルール書が「ポリシー」、束ねた役 割が「ロール」です。 たとえるなら … 建物の入館証。持つ権限のドアだけ開く。 10
11. ② 生成AIの基本用語 生成AIに共通する、基本のことば
12. 生成AIの基本用語 (1/2) 生成AI(Generative AI) 文章や画像を「新しく作り出す」AIのこと。Claudeも生成AIの一種です。 LLM / 基盤モデル 大量のデータで事前学習された、さまざまな用途に使えるAIモデルのこと です。 本日はClaude Sonnet 4.5を使用します。 12
13. 生成AIの基本用語 (2/2) プロンプト AIへの指示文。AIの役割を決める指示は「システムプロンプト」と呼びま す。 たとえるなら … 注文と、お店の接客マニュアル。 トークン AIが文章を処理する単位。Bedrockの料金は入出力のトークン数で決まり ます。 たとえるなら … 文字の従量課金メーター。 13
14. ③ 今日使う AWSサービス Amplify・Lambda・API Gateway・Bedrock
15. 今日使う AWSサービス (1/2) AWS Amplify Webページを簡単に公開できるサービス。 今回はindex.htmlをZipにしてドラッグ&ドロップする方法で行います。 AWS Lambda サーバー管理なし(サーバーレス)でコードを実行できるサービス。 今回はBedrockを呼ぶPython処理を担当します。 15
16. 今日使う AWSサービス (2/2) Amazon API Gateway アプリの受付窓口(API)を作るサービス。POSTメソッドとLambdaを紐づけ ます。 たとえるなら … WebとLambdaをつなぐ電話交換手。 Amazon Bedrock いろいろな会社の生成AIモデルを、APIひとつで使えるサービス。 詳しくは次のページで! たとえるなら … AIのフードコート。窓口は1つ。 16
17. Bedrockって結局なんですか ? 今日の主役、Amazon Bedrockのこと いろいろな会社の AIモデルを、 APIひとつで使えるサービス •ClaudeやNovaを切り替えて使える Lambda関数 ▼ boto3で呼び出し •サーバーレスで従量課金 Amazon Bedrock •入力データは学習に使われない ▼ モデルを選択 •モデルは「モデルID」で指定 Claude ※停止するのは別機能「Agents Classic」。本体は対象外! Nova etc 17
18. ④ 開発と操作の基本用語 コード・Web・手順書に出てくることば
19. Webアプリのことば (1/2) index.htmlまわりで登場 HTML / JavaScript HTMLは見た目、JavaScriptは動きを作る言語。 「押したら送信」を書いています。 JSON データの書き方。{"key1": "質問文"} の形でブラウザとLambdaの間を流 れます。 たとえるなら … 誰でも読める、宛名つきの荷札。 19
20. Webアプリのことば (2/2) index.htmlまわりで登場 API / POSTメソッド APIはプログラム同士の窓口。そこにデータを送る方式がPOSTです。 たとえるなら … 注文カウンターに、注文票を渡す。 CORS 別ドメインのAPIをブラウザが呼べるようにする仕組み。有効化しないとエ ラーに! たとえるなら … 「他のお店の注文も受けます」の貼り紙。 20
21. PythonからAIを呼ぶ (1/2) Lambda関数のコードに登場 boto3 AWS SDK for Python PythonからAWSを呼び出す公式ライブラリ。 import boto3 で使用するこ とができます。 たとえるなら … AWS注文カウンター用のPython電話機。 Converse API Bedrockと会話するための共通API。どのモデルでも同じ書き方で使えま す。 たとえるなら … モデルの方言を吸収する通訳さん。 21
22. PythonからAIを呼ぶ (2/2) Lambda関数のコードに登場 推論パラメータ 回答の調整つまみ。temperatureはランダム性、maxTokensは長さの上 限です。 たとえるなら … AIの味付け。今日は真面目モード。 lambda_handler / event Lambdaの入口の関数。届いたデータはeventに入り、event["key1"]で取 り出します。 たとえるなら … 玄関と、届いた荷物。 22
23. 手を動かすときのことば (1/2) 手順書のボタン名で登場 デプロイ (Deploy) 作ったものを使える状態にすること。押し忘れると変更が反映されません! たとえるなら … 料理でいう配膳。作るだけでは届かない。 ステージ API Gatewayの公開先の区分。デプロイするとAPIのURLが発行されま す。 例えば、本番環境用の場合は「prd」、 開発環境用は「dev」と言うような使 い方をします 23
24. 手を動かすときのことば (2/2) 手順書のボタン名で登場 テストイベント Lambdaの動作を試すためにJSONを入力してテストすることができます。 今回はkey1を質問に書き換えてTestを押します。 タイムアウト 処理の制限時間。初期値の3秒ではAIに足りないので、3分に延長しま す。 24
25. ⑤ 発展編のことば RAG・文書要約・画像読み取りに挑戦する人向け
26. RAG(ラグ)とは? 検索+生成=自分のデータに詳しいAI AIが答える前に資料を検索し、その内容をもとに回答させる仕組みです。 ① 質問 ② 検索 ③ 生成 ④ 回答 製品の 仕様は? S3の文書 を探す 文書を元に 回答を作成 根拠ある 答えを返す たとえるなら … 持ち込み資料OKの試験。資料を見て答えるので正確! 26
27. 発展編の AWSサービス Knowledge Bases RAGを丸ごと用意してくれるBedrockの機能。S3の文書を「同期」して検 索できます。 たとえるなら … RAGのフルセットレンタル。 Amazon S3 ファイルの保存サービス。文書はまずS3の「バケット」という入れ物に置き ます。 たとえるなら … 容量無制限の、クラウド上のフォルダ。 27
28. 発展編の基本用語 埋め込みとベクトル DB OpenSearch Serverless 文章の意味を数値に変換して保存し、「意味の近さ」で検索する仕組みで す。 たとえるなら … 文章を地図の座標にして、近さで探す。 マルチモーダル / base64 画像も扱えるAIの能力。画像は文字列(base64)に変換してJSONで送り ます。 たとえるなら … 写真を暗号にして、手紙に同封する。 28
29. 料金と後片付け 安心して楽しむために 従量課金 使ったぶんだけ課金。Bedrockはトークン数。 今回はサンドボックス環境を使用して無料で実施できていますが、通常は 少額(数十円程度)がかかります。 環境の削除 クリーンアップ 終わったらAmplify・Lambda・API Gatewayを削除。発展編組はS3とKB も忘れずに。 ※サンドボックス環境を使用しているため、そのままでも問題ありません。 29
30. 当日、困ったときは エラーの原因はだいたいこの4つ ☑ リージョンは オレゴン (us-west-2) ? ☑ Lambdaの Deploy ボタンを押した ? ☑ タイムアウトを 3分に延長した ? CORSを有効化した ? ★ 解決しなければ挙手 ! 教え合いも大歓迎です 30
31. ハンズオン完了 🎉 いかがでしたか？ yuuuka@PyLadies Tokyo | #クラウド女子会 31