Symfonyが 簡単にAI agentになる

PHP勉強会@東京 第190回の発表資料です。
https://phpstudy.connpass.com/event/401438/

Transcript

1. あなたのSymfonyが 簡単にAI agentになるって 聞きました？ 第190回 PHP勉強会＠東京 Hideki Kinjyo GitHub: o0h / X: @o0h_ [公開用]
2. 2 今日の話の前にあったこと 77webさん！！ https://speakerdeck.com/77web/boost?slide=9
3. 3 今日の登場人物 Symfony AI Agent Component AIエージェント簡単つくれる君
4. 4 えーじぇんと？ ◦◦について教えて〜 model ユーザーさん thinking...
5. 5 えーじぇんと？ ◦◦について教えて〜 コレを受け取って ユーザーさん
6. 6 えーじぇんと？ コッチに渡す役 model thinking...
7. 7 えーじぇんと？ 色々と複雑な振る舞いは modelにお任せだよ model thinking...
8. 8 DEMO
11. 11 のアプリが どんな風に実現しているのかを 紹介します
12. 12 自己紹介 • 金城秀樹 / きんじょうひでき • GitHub: @o0h / : @o0h_ • アイコンは美味しい鮭親子丼の写真です • 最近はPodcastをやっています ハッシュタグ: #readlinefm 𝕏 •
13. 13 話すこと・話さないこと • 話すこと: symfony/ai-agentで簡単になること ➡ このパッケージ(バンドル)が何を助けているのか • 話さないこと: Symfony自体の話 ➡ よくフルスタックFWに備わっている基本的な機能と繋ぎ込まれているんだな、 を感じてもらえるとハッピー
14. アプリの概要
15. 15 概要 • 「Slack過去ログ調べる君」みたいなもの • 普通のSlack bot • チャットから入力文章を受けつけて、 Slackの過去ログを多段サーチして、 そこから得た知識で回答を出す
16. 16 処理の流れ LLMの何か (AnthropicのAPIとか) Slack App 弊App Slack API
17. 17 処理の流れ - Phase1 Slack 弊App • Slackの仕様上、 リクエストを受け取ったら素早くレスポンスを返さなければならない • そのため、最初の応答はWeb Controllerを作って同期処理している
18. 18 処理の流れ - Phase1.5 弊App(web) 弊App(worker) • LLM側の処理＋Slack検索は凄く時間がかかる。 これを同期的に扱うと、Webリクエストがタイムアウトする • そのため、ジョブワーカーを利用した非同期処理に流している
19. 19 処理の流れ - Phase2 弊App(worker) LLMの何か (AnthropicのAPIとか) Slack API • ワーカーは、指示内容を整えてLLMにリクエストを実行 • 結果が返ってきたら、Slackにチャットメッセージをポストする
20. Symfony + Ai Agent Bundle目線の話
21. 21 Symfonyは強力なフレームワークだよ！ • Slackとの連携だけアプリ独自の実装だけど・・・ • といっても、よくある「外部SaaS連携」の範疇 • 以下は「いつも通りのSymfony」で実装されている Web用のコントローラー(Phase 1) • ジョブワーカー(Phase 1.5) • • 以下が「AI Bundle」が助けてくれる部分 modelに向けたリクエストの構築＆リクエストの送信 • 独自サービスのTools化 •
22. 基本的なリクエストの投げ方
23. 23 基本的なリクエストの投げ方 https://symfony.com/doc/current/ai/index.html
24. 24 基本的なリクエストの投げ方 プロンプトをDTOに入れて https://symfony.com/doc/current/ai/index.html
25. 25 基本的なリクエストの投げ方 agentインスタンスは DIで入れておくと楽だし、 Symfony的に自然 https://symfony.com/doc/current/ai/index.html
26. 26 基本的なリクエストの投げ方 作った$messagesを セットされた$agentに call()させる！それだけ！ https://symfony.com/doc/current/ai/index.html
27. 27 基本的なリクエストの投げ方 応答を取得してｺﾞﾆｮる https://symfony.com/doc/current/ai/index.html
28. 設定ファイルにお任せできること
29. 29 弊Appの設定例 config/packages/ai.php
30. 30 弊Appの設定例 利用するプラットフォーム(LLMベンダー)は サクッと設定＆乗り換えできる config/packages/ai.php
31. 31 弊Appの設定例 複数のagent設定を持つことが可能で config/packages/ai.php
32. 32 弊Appの設定例 リクエストのベース設定も簡単に指定OK (システムプロンプト、利用できるTools) config/packages/ai.php
33. 33 弊Appの設定例 依存注入している様子が こんな感じになる
34. Toolsの用意
35. https://openai.com/ja-JP/index/unrolling-the-codex-agent-loop/
36. 36 $agent->call()に「利用可能なtools」を添付しておく • 今回で言うと、 モデルに「Slack検索ツールが利用可能」という事を 最初のリクエストで提示している • そのため、 (agentは何も複雑な思考をしていないのに) モデルが気の済むまで「この検索よろしくね！」と 試行錯誤をしてくれるようになる
37. ◦◦について教えて〜 弊App LLMの何か (AnthropicのAPIとか)
38. ◦◦について教えて〜 ちなみに、 Slack検索ツールもあるよ 弊App LLMの何か (AnthropicのAPIとか)
39. OK、〇〇ね〜 弊App LLMの何か (AnthropicのAPIとか)
40. Slackで ◯◯検索して結果plz 弊App LLMの何か (AnthropicのAPIとか)
41. ◯◯ [検索] Slack API 弊App ◯◯ とは〜 ◯◯ △□ 本当の◯◯
42. LLMの何か (AnthropicのAPIとか) 弊App ◯◯ とは〜 ◯◯ △□ 本当の◯◯
43. 弊App LLMの何か (AnthropicのAPIとか) △□についても調べて
44. 何度も何度も往復する 弊App LLMの何か (AnthropicのAPIとか) Agentic Loop！
45. 45 が、とても簡単に手に入る
46. 46 Tools
47. 47 Tools Class Attributeで、 ツール名と説明を付けて
48. 48 Tools __invoke()メソッドを 実装すればOK
49. 49 Tools - 余談 1クラスで 複数メソッドを 登録することも出来るし https://symfony.com/doc/current/ai/components/agent.html#tool-return-value
50. 50 Tools - 余談 より精緻な パラメータの 提供もできる https://symfony.com/doc/current/ai/components/agent.html#tool-return-value
51. Toolsの利用とイベント(オブザーバー)
52. 52 Toolsの利用とイベント(オブザーバー) • ユーザーは、高度な出力が期待できる場合なら比 較的長い待ち時間にも寛容になりやすい。ただし 一般には、「なぜ待っているのか」を知りたいと 考える。タスクの内容を説明したり、テキストで プロセスの流れを説明したりすることで、ユー ザーに状況を伝え続けることができる。 [AIインターフェースデザイン ―AI時代の対話・可視化・制御の原則 第4章]より
53. 53 Toolsの利用とイベント(オブザーバー) • ストリーミング表示、待機中にどのタイミングで 情報を示すかの調整、進捗インジケーターのよう な機能は、ユーザーの目的や利用状況に応じて選 択的に使うべきである。適切に使えば、明確さと 信頼を高められる。 [AIインターフェースデザイン ―AI時代の対話・可視化・制御の原則 第4章]より
56. 56 symfony/ai-agentの場合 • Toolsの利用に関するイベントが自動で発火されている • ToolCallRequested / ToolCallArgumentsResolved / ToolCallSucceeded / ToolCallFailed • それらをリッスンすることで、 ユーザーに「今なにが起きているのか」の通知に(も)利用できる
57. 57 Tools関連イベント
58. 58 Tools関連イベント Toolの「呼び出し」「完了」の リスナーとして登録
59. 59 Tools関連イベント • 今回は小さいアプリなので実装を端折って、 「利用されるToolはSlack検索しかない」という大胆設計！ • 利用開始イベント => 「Slackを検索中」 • 実行完了イベント => 「検索結果を分析しています」
60. 以上です！
61. 61 いかがでしたか？ • 一般的な「FWの知識・資産」をそのまま使える感じ良い◎ • DBの検索とかファイルの操作とかAPI連携とか、 そのまま「Toolsとして使う」が出来る • symfony/tuiとか繋ぎこんだら面白いことが出来そうですね！
62. 62 関連読み物 • Symfony AI - Agent Component (Symfony Docs) https:// symfony.com/doc/current/ai/components/agent.html • Symfony AI Bundle使ってみた - AIチャット編 - #LLM - Qiita https://qiita.com/ippey_s/items/7a6ac28d513bac9ca5e3 • symfony/aiとlaravel/boost - Speaker Deck https:// speakerdeck.com/77web/boost • symfony/mcp-bundleで、既存アプリケーションもお手軽にMCPサーバー 化 - Speaker Deck https://speakerdeck.com/o0h/phpconkagawa-lt-6
63. おしまい！ お付き合いいただき ありがとうございました!!