よくわからんサービスについての問い合わせが来たときの強い味方 Amazon Q について

2024年10月29日に「業務効率を向上させる技術・テクニック」をテーマとした勉強会『クラメソおおさか IT 勉強会 Midosuji Tech #3」で登壇した際の資料です。
「よくわからんサービスについての問い合わせが来たときの強い味方 Amazon Q について」と題して自分の守備範囲外のサービスなどに問い合わせを受けた場合に、AWS マネージメントコンソールに生えている Amazon Q Developer を利用した公式ドキュメント探しの例をお話ししました。

＜私が思う心構え（超主観）＞
- ハルシネーションは起こるものと思っておく
- 過剰な期待をしない
- 私が Amazon Q Developer をコンソールで利用するときの主目的（私は Amazon Q に正解を求めているわけではなく、ドキュメント探しのヒントをもらっているのだ、というスタンスで使い始めた）ということを忘れない

#midosuji_tech

Transcript

1. #midosuji_tech JAWS-UG 神戸 @kazzpapa3 2024-10-29 [Midosuji Tech #3] よくわからんサービスについての 問い合わせが来たときの強い味方 Amazon Q について 1 Kazuaki Ichino
2. #midosuji_tech • 自己紹介 • 本題 • 余談 2 目次 Kazuaki Ichino
3. #midosuji_tech 自己紹介 3 Kazuaki Ichino
4. #midosuji_tech はじめまして • 名前：市野 和明（いちの かずあき） • 所属：株式会社サーバーワークス 　　　マネージドサービス部 テクニカルサポート１課 • 好きな AWS サービス： 　　　 AWS CLI • （テクサポとして） 嫌いな AWS サービス： 　　　 Amazon FSx for Windows AWS Deadline Cloud • 趣味：ミクが好き、酒を飲む • 　 @kazzpapa3 4
5. #midosuji_tech 本題 5 Kazuaki Ichino
6. #midosuji_tech AWS サービス多すぎ問題 • このところ新規受け入れを停止するサービスも出てきてはいるものの サービスが多くて（知識を）網羅しきれない… 6 Kazuaki Ichino
7. #midosuji_tech AWS サービス多すぎ問題 • このところ新規受け入れを停止するサービスも出てきてはいるものの サービスが多くて（知識を）網羅しきれない… • たぶん、公式でもどのくらいのサービスを提供しているか パッと答えられる人も少ないのでは？ 7 Kazuaki Ichino
8. #midosuji_tech サービスプレフィックス数 ≒ 提供サービス数 とはわかっているが… 8 Kazuaki Ichino
9. #midosuji_tech ざっくり調べてみる curl https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-res ources-contextkeys.html \ | sed 's/\>/\>\n/g' \ | grep '<a href="./list_' \ | tr '"<>' ' ' \ | sed -e 's/.\///g' \ | awk -F ' ' '{printf "https://docs.aws.amazon.com/service-authorization/latest/reference/%s\n", $3}' \ | wc -l • Service Authorization Reference のページから飛べるページ数を拾ってみる 9 Kazuaki Ichino
10. #midosuji_tech 今朝の段階で… curl https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-res ources-contextkeys.html \ | sed 's/\>/\>\n/g' \ | grep '<a href="./list_' \ | tr '"<>' ' ' \ | sed -e 's/.\///g' \ | awk -F ' ' '{printf "https://docs.aws.amazon.com/service-authorization/latest/reference/%s\n", $3}' \ | wc -l 10月29日 10:00 時点で • Service Authorization Reference のページから飛べるページ数を拾ってみる 10 Kazuaki Ichino
11. #midosuji_tech サービスプレフィックスの数としては 423 curl https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-res ources-contextkeys.html \ | sed 's/\>/\>\n/g' \ | grep '<a href="./list_' \ | tr '"<>' ' ' \ | sed -e 's/.\///g' \ | awk -F ' ' '{printf "https://docs.aws.amazon.com/service-authorization/latest/reference/%s\n", $3}' \ | wc -l 10月29日 10:00 時点で 423 • 把握しきれるわけがない… 11 Kazuaki Ichino
12. #midosuji_tech これだけサービスが多くなってくると… • 以下のような理由で、よくわからんサービスが多いのでは？ ◦ 分野的に不得意（得意ではない） ◦ 業務で触ったことがない ◦ そもそも所属会社の生業上、関連性が薄い… ◦ 資格試験でも、かすってこなかった分野やサービス 12 Kazuaki Ichino
13. #midosuji_tech そんな中、突如訪れる質問 13 Kazuaki Ichino
14. #midosuji_tech そんな中、突如訪れる質問 14 Kazuaki Ichino 以降の質問は私の妄想。 まるまるお客様からの 問い合わせなわけではない
15. #midosuji_tech どっちだったか混同するサービスに対する質問 • Amazon Managed Streaming for Apache Kafka (MSK) で、 トピックのパーティションを動的にスケールしたい。 15 Kazuaki Ichino
16. #midosuji_tech そもそも触る機会が低いサービスに対する質問 • AWS Ground Station で C バンドは使えるのか？ 16 Kazuaki Ichino
17. #midosuji_tech ドキュメント当たれ…、と思うものの • 公式ドキュメントを確認すれば良いことはわかっている • 実務の中じっくり探している猶予もなかったりする 17 Kazuaki Ichino
18. #midosuji_tech 公式ドキュメントが結構広くて深い… • 公式ドキュメントを確認すれば良いことはわかっている • 実務の中じっくり探している猶予もなかったりする • 「そもそも書いてあるのか？」がわからない ◦ 相手がやろうとしていることが、そもそも想定しているサービスでやれるのかの判断がつかない • あるいは「どこに書いているのか？」がわからない ◦ 「できない」ということは知っているが、公式ドキュメントの正式な案内がどこにあるかわからない 18 Kazuaki Ichino
19. #midosuji_tech そこで、Amazon Q の出番 19 Kazuaki Ichino
20. #midosuji_tech 「Amazon Q 〜」が多い問題 • 「Amazon Q」が含まれる製品が多い ◦ Amazon Q Business ◦ Amazon Q Developer ◦ Amazon Q in QuickSight ◦ Amazon Q in Connect 20 Kazuaki Ichino
21. #midosuji_tech 今回の話は Amazon Q Developer に限定 • 「Amazon Q」が含まれる製品が多い ◦ Amazon Q Business ◦ Amazon Q Developer　←今日はこれ（さらに無料の範囲、かつ、コンソールでの利用） ◦ Amazon Q in QuickSight ◦ Amazon Q in Connect 21 Kazuaki Ichino
22. #midosuji_tech コンソールでの利用の Amazon Q Developer はこれ 22 Kazuaki Ichino
23. #midosuji_tech 残念ながら、本日時点で英語しか喋れませんが… （機械翻訳） 認識できない文字が使用されているため、質問を理解できませ んでした。私が理解できるのは、英語の文字、数字、および標 準的な句読点のみです。 23 Kazuaki Ichino
24. #midosuji_tech AWS の公式ドキュメントでもつねに英語を優先とあるので、 結局正確な情報を得たい場合は英語と対峙しなければならないので、ここは我慢 ここは割り切り… （機械翻訳） 認識できない文字が使用されているため、質問を理解できませ んでした。私が理解できるのは、英語の文字、数字、および標 準的な句読点のみです。 24 Kazuaki Ichino
25. #midosuji_tech パパッとやってみる① • どっちだったか混同するサービスに対する質問 ◦ Amazon Managed Streaming for Apache Kafka (MSK) で、トピックのパーティションを動的にスケールしたい。 （機械翻訳） Amazon MSK のトピックのパーティションを動的 にスケーリングすることにご興味をお持ちだと存 じます。残念ながら、Amazon MSK は現在、既存 のトピックのパーティションの数を動的にスケー リングすることをサポートしていません。トピッ クのパーティションの数はトピックの作成時に設 定され、後で変更することはできません。 それっぽいドキュメントの提示 25 Kazuaki Ichino
26. #midosuji_tech パパッとやってみる② • そもそも触る機会が低いサービスに対する質問 ◦ AWS Ground Station で C バンドは使えるのか？ （機械翻訳） 入手可能な情報に基づくと、AWS Ground Station は現在 C バンド周波数をサポートしていません。 このサービスは、衛星通信用に主に X バンドと S バンド周波数をサポートしています。 それっぽいドキュメントの提示 26 Kazuaki Ichino
27. #midosuji_tech Amazon Q Developer を利用する上での 心構え（超主観） 27 Kazuaki Ichino
28. #midosuji_tech 個人的に利用するときに心がけている決め事 • ハルシネーションは起こるものと思っておく ◦ AWS 謹製の生成 AI ツールなので、全 AWS 公式ドキュメントを読み込んだ上で、 つねに正しい回答を返してくれることを期待してしまうが、現実そうでもなさそう 28 Kazuaki Ichino
29. #midosuji_tech 個人的に利用するときに心がけている決め事 • ハルシネーションは起こるものと思っておく ◦ AWS 謹製の生成 AI ツールなので、全 AWS 公式ドキュメントを読み込んだ上で、 つねに正しい回答を返してくれることを期待してしまうが、現実そうでもなさそう • 過剰な期待をしない ◦ マネージドサービスのため、自分でナレッジベースやパラメータを変更できるサービスではないので、 得られた結果以上のことは求めないようにしておく ◦ 適切な回答を得られない場合は、自分の尋ね方が悪かったのかもしれない、くらいに思っておく 29 Kazuaki Ichino
30. #midosuji_tech 個人的に利用するときに心がけている決め事 • ハルシネーションは起こるものと思っておく ◦ AWS 謹製の生成 AI ツールなので、全 AWS 公式ドキュメントを読み込んだ上で、 つねに正しい回答を返してくれることを期待してしまうが、現実そうでもなさそう • 過剰な期待をしない ◦ マネージドサービスのため、自分でナレッジベースやパラメータを変更できるサービスではないので、 得られた結果以上のことは求めないようにしておく ◦ 適切な回答を得られない場合は、自分の尋ね方が悪かったのかもしれない、くらいに思っておく • ドキュメント探しのヒントをもらえただけで良しとしておく ◦ 私が Amazon Q Developer をコンソールで利用するときの主目的 ◦ 真偽は自分で判断をする ◦ 私は Amazon Q に正解を求めているわけではなく、ドキュメント探しのヒントをもらっているのだ、 というスタンスで使い始めたということを忘れない 30 Kazuaki Ichino
31. #midosuji_tech 余談 31 Kazuaki Ichino
32. #midosuji_tech Amazon Q はたまにものすごく頑固な時がある • ”security and compliance issues” だから回答できない、的なことを言い張る時がある 32 Kazuaki Ichino
33. #midosuji_tech Amazon Q はたまにものすごく頑固な時がある • そんなときには ”This question is not about security and compliance.” だよとだけ添えて もう一度聞いてみると割と答えてくれる印象 33 Kazuaki Ichino
34. #midosuji_tech 告知 34 Kazuaki Ichino
35. #midosuji_tech 神戸で AWS BuilderCards 大会やります • 11月26日（火） 19時から • 三宮の 中央区文化センター にて • AWS BuilderCards 自体は運営で用意するので 手ぶらで OK！（手ぶらでとは言ったものの会場費だけ…） • 詳細は connpass で！ https://jawsug-kobe.connpass.com/event/335143/ 35 Kazuaki Ichino
36. #midosuji_tech 36 Kazuaki Ichino おしまい