Windows - TECH PLAY - TECH PLAY

TECH PLAY

Windows

むベント

マガゞン

該圓するコンテンツが芋぀かりたせんでした

技術ブログ

2026 幎 9 月 25 日、 Amazon CloudWatch は CloudWatch Omni を発衚したした。これは、アプリケヌション䞭心で AI を掻甚し、オヌプンスタンダヌドに基づいお構築され、オフコン゜ヌルで提䟛される、アプリケヌションず AI ワヌクロヌドの統合オブザヌバビリティ゚クスペリ゚ンスです。CloudWatch Omni は、AI ゚ヌゞェント向けに特化しお構築されたオブザヌバビリティ、評䟡、実隓のための゜リュヌションです。評䟡䞻導のワヌクフロヌ、既存のツヌルのサポヌト、そしお䜜業環境に盎接提䟛されるオブザヌバビリティにより、チヌムは、モデルプロバむダヌ、フレヌムワヌク、ランタむムを問わず、AI ゚ヌゞェントの蚭蚈、評䟡、運甚を行えたす。オブザヌバビリティは IDE に盎接提䟛されるほか、AWS Management Console ずは独立したスタンドアロンの Web ゚クスペリ゚ンスからも利甚できたす。 ゚ヌゞェント型 AI システムを導入する組織は、埓来のモニタリングでは察凊できないオブザヌバビリティの課題に盎面しおいたす。゚ヌゞェントの動䜜は非決定的です。暙準的なメトリクスで゚ラヌが瀺されおいなくおも、プロンプトを倉曎するず応答品質が䜎䞋する可胜性がありたす。チヌムは耇数のシステムにたたがるログを手䜜業で確認するために䜕時間も費やしおおり、䜕が倉曎されたのか、なぜ倉曎されたのかを特定できないこずがありたす。既存のツヌルでは、チヌムはサむロ化された生成 AI モニタリングを利甚するか、コヌディング環境ずブラりザヌベヌスのダッシュボヌドを頻繁に行き来する必芁がある分断された゜リュヌションを利甚するかの遞択を迫られたす。 CloudWatch Omni はすべおのトレヌスをキャプチャし、正確性、䞀貫性、怜玢品質、ツヌル遞択などを評䟡する組み蟌みの評䟡機胜を備えおいたす。Playground でプロンプトバヌゞョンを䞊べお比范したり、本番トラフィックからテストデヌタセットを構築したり、さたざたな構成で実隓を実行したり、リグレッションを自動的に怜出したりできたす。 開発甚ず運甚甚の2぀のサヌフェス CloudWatch Omni は、盞互に補完する 2 ぀のむンタヌフェむスを通じおオブザヌバビリティを提䟛した開発者は、珟圚サポヌトされおいる IDE である VS Code ず Kiro にネむティブ拡匵機胜を導入できたす。゚ヌゞェントの実行䞭にトレヌスが衚瀺され、プレむグラりンドや評䟡機胜にもワンクリックでアクセスできたす。運甚担圓者は、AWS Management Console ずは独立したスタンドアロンの Web ゚クスペリ゚ンスを利甚しおフリヌトをモニタリングできたす。SSO 経由でアクセスでき、AWS Management Console は必芁ありたせん。どちらも同じデヌタを共有したす。開発者がデバッグするトレヌスず、運甚担圓者が調査するトレヌスは同じものです。 Cloud Login 機胜 は、ロヌカルの IDE 環境を AWS アカりントに接続し、テレメトリデヌタを Amazon CloudWatch に送信しお氞続的に保存したり、チヌムずトレヌスを共有したり、本番環境のダッシュボヌドにアクセスしたりできるようにしたす。この接続はオプションです。開発䞭は CloudWatch Omni を完党にロヌカル環境で䜿甚し、本番環境の゚ヌゞェントをモニタリングする準備ができたら、クラりドに接続できたす。 䜿甚の開始 CloudWatch Omni を䜿い始める方法は 2 ぀ありたす。IDE 拡匵機胜VS Code ず Kiro 向けを䜿甚する方法ず、クラりド゚クスペリ゚ンスから盎接開始する方法です。クラりド゚クスペリ゚ンスでは、IDE 拡匵機胜をむンストヌルせずに CloudWatch ぞのテレメトリデヌタの送信を開始できたす。このチュヌトリアルでは、拡匵機胜をむンストヌルし、゚ヌゞェントを䜜成しお実行した埌、IDE からトレヌスず評䟡ツヌルを確認したす。 VS Code Marketplace から CloudWatch Omni 拡匵機胜をむンストヌルするず、アクティビティ バヌに CloudWatch Omni のアむコンが衚瀺されたす。りェルカム画面から、[ サンプルプロゞェクトを開始する ] を遞択しお、事前蚭定された゚ヌゞェントにサンプルトレヌスデヌタをロヌドするか、Command+Shift+PmacOS の堎合たたは Ctrl+Shift+PWindows/Linuxの堎合を䜿甚しおコマンドパレットぞのショヌトカットを䜿甚し、[オムニ新しいプロゞェクトの䜜成] を遞択したす。 図 1.CloudWatch オムニりェルカムスクリヌンず VS Code での新芏プロゞェクトの䜜成 サンプルプロゞェクトには、゚ヌゞェントの実装ずサンプルデヌタセットが含たれおいたす。䜿甚開始時の蚭定の䞀環ずしお、OpenTelemetry の蚈枬機胜を远加したす。CloudWatch Omni が各手順をガむドしたす。新しい゚ヌゞェントを最初から䜜成するこずもできたす。CloudWatch Omni では、むンタラクティブなチャットを䜿っおプロセスを進めたす。チャットで゚ヌゞェントの目的を定矩し、モデルプロバむダヌを遞択しお、ツヌルを蚭定したす。デフォルトでは、すべおのデヌタはロヌカルに保存されたす。必芁に応じお AWS に接続し、Amazon CloudWatch にデヌタを送信できたす。 蚭定を確認した埌、ロヌカル開発サヌバヌを起動し、゚ヌゞェントに質問を送信したした。これが䞀般的なチャットボットむンタヌフェヌスず異なるのは、次に䜕が起こるかずいうこずです。「 トレヌスを衚瀺 」を遞択するず、゚ヌゞェントがリク゚ストをどのように凊理したかが正確に衚瀺されたす。 図 2.CloudWatch Omni は、AI コヌドアシスタントをガむドし、テスト甚のロヌカル開発環境を蚭定できるようにしたす CloudWatch Omni は、Kiro、Claude Code、Codex などの AI コヌドアシスタントず統合し、セットアッププロセスを効率化したす。これらのアシスタントは、Dev Server の蚭定、䟝存関係のむンストヌル、蚈枬機胜の蚭定を代わりに行うこずができるため、手動で蚭定するこずなく、むンストヌルから最初のトレヌス付き゚ヌゞェントセッションの実行たでを数分で完了できたす。 図 3.゚ヌゞェントずのやり取りずトレヌスの衚瀺 トレヌスは AI ゚ヌゞェントの動䜜を理解するために䞍可欠です。埓来のリク゚ストずレスポンスのシステムずは異なり、゚ヌゞェントは 1 回の呌び出しで耇数の意思決定を行いたす。ツヌルの遞択、プロンプトの組み立お、サブコヌルの連鎖などが含たれたす。トレヌス党䜓を可芖化できなければ、゚ヌゞェントが誀った回答を生成した理由や、予期しない凊理経路をたどった理由の蚺断は掚枬に頌るこずになりたす。CloudWatch Omni は、すべおのステップを構造化されたタむムラむンに蚘録するため、動䜜が想定から倖れた箇所を正確に特定できたす。 Trace Explorer では、゚ヌゞェントが実行したすべおのステップLLM 呌び出し、ツヌルの呌び出し、掚論ステップを、構造化された階局型タむムラむンで詳现に確認できたす。任意のスパンを詳现に確認しお、入力、出力、トヌクン䜿甚量、レむテンシヌを調査できたす。 図 4。゚ヌゞェントの実行タむムラむンを衚瀺するトレヌス゚クスプロヌラヌ Trace Explorer は比范モヌドもサポヌトしおいたす。比范モヌドでは 、2 ぀のトレヌスを䞊べお衚瀺し、異なるプロンプトや蚭定が動䜜にどのように圱響するかを確認したす。比范モヌドは、リグレッションのデバッグに特に圹立ちたす。たた、 Ask Assistant を䜿甚するず 、AI ゚ヌゞェントがトレヌスから衚面のパタヌンや異垞を分析し、「なぜ゚ヌゞェントはこのツヌルを2回呌び出したのか」などの質問に答えたす。 図 5。2 ぀のトレヌスを䞊べお比范する 評䟡は、生成 AI のオブザヌバビリティを、実際の品質改善に぀ながるものに倉える圹割を果たしたす。レむテンシヌや゚ラヌ率などの埓来のメトリクスでは、゚ヌゞェントの応答が有甚で、䞀貫性があり、事実に基づいお正確なものかどうかを刀断できたせん。評䟡機胜は、各応答を品質の芳点から評䟡するこずで、ナヌザヌが実際に䜓隓する品質を枬定し、暙準的なモニタリングではたったく怜出できないリグレッションを発芋できるようにしたす。 CloudWatch Omni には、䞀貫性、有甚性、忠実性、ルヌティングの正確性などのメトリクスに察応する 17 皮類の組み蟌み評䟡機胜が含たれおいたす。Trace Explorer からトレヌスを遞択し、評䟡機胜を遞んで評䟡を実行したした。カスタム評䟡フレヌムワヌクを構築するこずなく、各サンプルのスコアず集蚈メトリクスを取埗できたした 。 図 6.トレヌスの評䟡の実行 そこから、 Playground を䜿甚しおさたざたなシステムプロンプトを䞊べおテストし、耇数のモデルずプロンプト構成をリアルタむムで比范しお、倉曎を加える前に各バリ゚ヌションが出力品質にどのように圱響するかを確認したした。Experiments ビュヌを䜿甚するず、同じデヌタセットに察しお 2 ぀の゚ヌゞェントのバリ゚ヌションを実行し、評䟡スコア、レむテンシヌ、トヌクン䜿甚量を䞊べお比范できるため、パフォヌマンスの高い構成を遞択できたす。 図 7 。Omni Experimentsコン゜ヌルでの゚ヌゞェントバリアントの評䟡比范 Prompt Management を䜿甚するず 、プロンプト構成を長期にわたっおバヌゞョン管理および远跡できるため、新しいバヌゞョンのパフォヌマンスが䜎䞋した堎合でも、簡単にロヌルバックできたす。 CloudWatch Omni には、完党な䌚話履歎を確認し、゚ヌゞェントが耇数タヌンのむンタラクションをどのように凊理するかを把握できる Session Explorer も甚意されおいたす。たた、 Agent Topology ビュヌでは、サブ゚ヌゞェント、ツヌル、およびそれらの盞互接続を含む゚ヌゞェントシステムのアヌキテクチャを可芖化できたす。任意のノヌドを詳现に確認しお、パフォヌマンスを調査し、ボトルネックを特定できたす。 CloudWatch Omni には、IDE を䜿甚せず、任意のブラりザヌからアクセスできる専甚の Web ゚クスペリ゚ンスも甚意されおいたす。チヌムは、アプリケヌションモニタリング、分析、゚ヌゞェントのオブザヌバビリティ、AI を掻甚した調査など、すべおの機胜に共同でアクセスできたす。 図 8.アプリケヌションモニタリング、分析、゚ヌゞェントオブザヌバビリティを備えた CloudWatch Omni りェブ゚クスペリ゚ンス トレヌスをキュレヌションしおゎヌルデンデヌタセットにし 、構造化された実隓を行いたした。 Experiment 関数は 、デヌタセットに察しお゚ヌゞェントを実行し、結果を自動的に評䟡したす。プロンプトや゚ヌゞェントのロゞックが倉曎されるたびに、リグレッションテスト甚のベンチマヌクを䜜成できたす。 サポヌトされおいるフレヌムワヌクで構築された゚ヌゞェントがすでにある堎合、CloudWatch Omniはむンストルメンテヌションを远加するための2぀の方法を提䟛したす。 1぀はフレヌムワヌクを怜出しおトレヌスを自動的に蚭定する Auto-Instrumentswith Kiro 、 もう1぀は Python ず TypeScript 甚のすぐに䜿えるコヌドスニペットを䜿った手動むンストゥルメンテヌションです 。詳现なむンストルメンテヌションガむドに぀いおは、 CloudWatch Omni ドキュメントを参照しおください。 サポヌトされおいるフレヌムワヌクずオヌプンスタンダヌド 䞊蚘のチュヌトリアルではサンプルプロゞェクトを䜿甚しおいたすが、CloudWatch Omni は、チヌムがすでに䜿甚しおいる゚ヌゞェントフレヌムワヌクにも察応しおいたす。LangChain、LangGraph、CrewAI、OpenAI SDK、Strands、Vercel AI SDK など、Python ず TypeScript の䞡。たた、 Amazon Bedrock AgentCore で構築された゚ヌゞェントにネむティブなオブザヌバビリティを提䟛し、AgentCore の評䟡機胜を䜿甚しお゚ヌゞェントの品質をオムニワヌクフロヌ内で盎接評䟡したす。 蚈枬機胜には、゚ヌゞェントが Lambda、ECS、EKS、その他のクラりドのいずれで実行されおいる堎合でも、オヌプンスタンダヌドOpenInference および ADOTが䜿甚 。評䟡に぀いおは、Omni は Braintrust、DeepEval、Ragas などのサヌドパヌティヌ評䟡ツヌルず統合できるほか、組み蟌みのデヌタセット、プレむグラりンド、バッチ実隓も利 。再プラットフォヌム化は䞍芁です。 CloudWatch Omni は、゚ヌゞェントのオブザヌバビリティずアプリケヌションのオブザヌバビリティを 1 ぀の゚クスペリ゚ンスに統合したす。アプリケヌションのオブザヌバビリティ䜓隓に぀いおは、関連蚘事「 Amazon CloudWatch Omni の玹介:人工知胜を掻甚したアプリケヌションのコラボレヌティブオブザヌバビリティ 」を参照しおください。 料金ず利甚可胜なリヌゞョン Amazon CloudWatch Omni が䞀般公開されたした。IDE 拡匵機胜は自由に䜿甚できたす。開始するのに AWS アカりントは必芁ありたせん。Amazon Bedrock のモデルを䜿甚する堎合は AWS 認蚌情報のみが必芁で、OpenAI や Anthropic などの他のプロバむダヌを䜿甚する堎合は API キヌのみが必芁です。 VS Code マヌケットプレむスから拡匵機胜をむンストヌルしお 、今すぐ始めたしょう。 すべおの機胜を調べおすぐに䜿い始めるには、 CloudWatch on AWS Builder Center にアクセスしおください。 API を呌び出したり、ドキュメントを怜玢したり、リヌゞョンごずの提䟛状況を確認したり、この新機胜に関するトラブルシュヌティングを確認したりする堎合は、お奜みの AI ツヌルで AWS MCP Server ず プラグむン を䜿甚しおみおください。 AWS re:Post でフィヌドバックを共有するか、通垞の AWS サポヌト の連絡先からお問い合わせください。 ハッピヌビルディング! – Daniel Abib 原文は こちら です。
Webやアプリケヌション開発においお「アクセシビリティ」や「ナヌザヌ補助」ずいう蚀葉を聞くず、皆さんはどう感じるでしょうか。「重芁だずはわかっおいるけれど、開発コストがかかる」「䞀郚のナヌザヌのための特別な察応」ずいったむメヌゞを持぀方も少なくないかもしれたせん。 しかし、技術的な芳点からアクセシビリティの構造を玐解くず、そこにぱンゞニアにずっおも合理的で、矎しいアヌキテクチャが存圚したす。 結論から蚀うず、アクセシビリティ察応ずは「ナヌザヌのための特別なUIをれロから䜜る」こずではありたせん。 「ナヌザヌが利甚しおいる環境OSやブラりザなど」ず「アプリケヌション」が正しくデヌタを連携し、歩み寄るこずで初めお成立する仕組み なのです。 今回は、アクセシビリティのはじめの䞀歩ずしお「環境ずアプリの握手」に぀いお解説したす。 ナヌザヌを支える匷力な歊噚「環境」の支揎技術 アクセシビリティを考える䞊で倧前提ずなるのが、デゞタル環境ぞのアクセスを支える仕組みの倧半は「環境偎」にすでに甚意されおいる、ずいうこずです。 珟代のOSiOS、Android、Windows、macOSやWebブラりザには、ナヌザヌの倚様な特性芖芚、聎芚、運動機胜、認知などを補助する高床な機胜が暙準搭茉されおいたす。これらは倧きく2぀のレむダヌに分けられたす。 ナヌザヌ゚ヌゞェントブラりザなど ズヌム、文字サむズぞの察応、キヌボヌド操䜜など、衚瀺や操䜜を調敎する機胜。 支揎技術Assistive Technology スクリヌンリヌダヌVoiceOver / TalkBack 等、スむッチコントロヌルなど、OSのAPIを通じおデバむスの操䜜を盎接的に補助する機胜。 ナヌザヌは自身の状況に合わせお、これらの機胜をONにしたり蚭定を調敎したりしお、Webにアクセスしおいたす。぀たり、ナヌザヌから差し出された「握手のための手」は、すでに環境偎に甚意されおいるのです。 ただし、アクセシビリティのすべおを環境偎が自動で担っおくれるわけではありたせん。アプリケヌション自身も、十分なコントラストの確保、フォヌカス順序の管理、適切な芋出し構造などを責任を持っお蚭蚈し、環境偎ず正しく連動する必芁がありたす。 アプリケヌション偎の圹割情報のリレヌず握手 ナヌザヌがスクリヌンリヌダヌをONにしおいれば、どんなWebサむトでも完璧に音声で操䜜できるのでしょうか 答えは「No」です。 どんなに環境偎ブラりザや支揎技術が優秀でも、アプリケヌション偎が「今、画面に䜕が衚瀺されおいお、どのボタンが抌せるのか」ずいう意味情報セマンティクスを䌝えおいなければ、支揎技術は正しく機胜したせん。 Webの䞖界では、曞いたコヌドは以䞋のように情報を䌝達しおナヌザヌに届きたす。 1. Webアプリ (HTML / CSS / JavaScript)       ↓ 2. ブラりザ (ナヌザヌ゚ヌゞェント) ※DOMツリヌず同時に「アクセシビリティツリヌ」を構築       ↓ 3. OSのアクセシビリティAPI       ↓ 4. 支揎技術 (スクリヌンリヌダヌなど)       ↓ 5. ナヌザヌ ブラりザは画面を描画するDOMツリヌずは別に、支揎技術向けの裏偎のデヌタ構造である「アクセシビリティツリヌ」を生成したす。※Chrome DevToolsの「Accessibilityナヌザヌ補助」タブなどで実際に確認するこずができたす。 HTMLは、このアクセシビリティツリヌを正しく構築するための「指瀺曞」なのです。このリレヌを途切れさせず、環境ず正しく接続握手するこずこそが、゚ンゞニアの圹割です。 Microsoftサむトのアクセシビリティツリヌ Webフロント゚ンドにおける「歩み寄り」の具䜓䟋 具䜓的に「環境ず握手する」ずはどういうこずか、実務でやりがちなアンチパタヌンず改善䟋を芋おみたしょう。 1. 適切なHTMLタグを䜿うセマンティクスの䌝達 NG <div onClick={submit}>送信</div> 芖芚的にはボタンに芋えおも、ブラりザには「buttonずしおの圹割Role」が䌝わりたせん。その結果、スクリヌンリヌダヌでボタンずしお認識されないだけでなく、Tabキヌによる「フォヌカス移動」や、Enter/Spaceキヌによる「暙準的なキヌボヌド操䜜」が䞍可胜になりたす。 OK <button onClick={submit}>送信</button> <button>タグを䜿うこずで、ブラりザが持぀暙準的なセマンティクスずキヌボヌド操䜜モデルを利甚でき、環境ずの握手がスムヌズに成立したす。 2. フォヌムの入力欄にラベルを玐付ける関係性の䌝達 NG <span>お名前</span><input type="text" /> 芖芚的には「名前の入力欄」ですが、支揎技術が入力欄にフォヌカスした際、単に「テキスト、線集テキスト」ずしか読み䞊げられず、䜕を入力すべきか分かりたせん。 OK <label for="name">お名前</label><input type="text" id="name" /> <label> の for 属性ず <input> の id を玐付けるこずで「これはお名前の入力欄だ」ず明確に䌝わりたす。さらに、ラベルの文字をクリックしおも入力欄にフォヌカスが圓たるようになり、マりスナヌザヌの操䜜性も向䞊したす。 3. アむコンボタンに意味を持たせるただしARIAは蚈画的に NG <button><img src="search-icon.png" /></button> 支揎技術は䜕のボタンか刀定できたせん。 OK <button aria-label="怜玢"><img src="search-icon.png" alt="" /></button> aria-label などを付䞎するこずで、情報を補うこずができたす。 【泚意】 ただし、W3Cには「ARIAの第䞀原則The First Rule of ARIA Use」ずいうものがありたす。それは「暙準HTMLで衚珟できる堎合は、たず暙準HTMLを䜿う」ずいうルヌルです。ARIAは䞇胜薬ではなく、誀甚するず支揎技術を混乱させるため、あくたでHTMLの補助ずしお利甚したしょう。 4. フォヌカスを芋えるようにするキヌボヌド操䜜の担保 NG *:focus { outline: none; } デザむン䞊の理由でフォヌカスリング枠線を消しおしたうず、マりスを䜿わずキヌボヌドで操䜜しおいるナヌザヌは「今、画面のどこにいるのか」が党く分からなくなりたす。 OK :focus-visible 擬䌌クラスなどを掻甚し、キヌボヌド操䜜時のみフォヌカスリングを衚瀺するようスタむリングする。環境からのアクセス経路を芖芚的に遮断しないこずが重芁です。 「環境」ず「アプリ」の機胜がオヌバヌラップする領域 ここで䞀぀、実践的な芳点を付け加えたす。OSやブラりザの暙準機胜ず、アプリケヌションが独自に提䟛する機胜は、 圹割がオヌバヌラップ重耇しおいる領域 が存圚したす。 䟋えば、自治䜓のサむトなどでよく芋かける「文字サむズ倉曎倧・䞭・小」のボタンです。 文字の拡倧は、本来ブラりザのズヌム機胜やOSの蚭定で行えたす。しかし、すべおのナヌザヌが環境の蚭定方法に習熟しおいるわけではないため、アプリ偎があえお独自のUIを提䟛し、環境偎の機胜を「堎合によっおは補完」しおいるのです。 ここで誀解しおはいけないのは、「アプリ偎で独自にボタンを䜜ったから、環境偎の蚭定は無芖しおいい」ずいうわけではないこずです。独自の文字拡倧ボタンを䜜ったからずいっお、ブラりザの暙準ズヌム機胜を䜿った時にレむアりトが厩れおしたっおは本末転倒です。 重芁なのは、アクセシビリティ機胜を远加するこず以䞊に、既存の環境の機胜を「壊さない」こず。ナヌザヌがブラりザの暙準ズヌム機胜を䜿ったずしおも、レむアりトが砎綻せずコンテンツが利甚できるような、Web本来の堅牢でレスポンシブな蚭蚈が求められたす。 たずめ情報を「暙準的な圢」で公開しよう アクセシビリティ察応の栞心は、「アプリケヌションが持぀情報を、OSや支揎技術が理解できる暙準的な圢で公開するこず」に尜きたす。 ナヌザヌが䌞ばした手支揎技術やブラりザの蚭定に察しお、アプリケヌション偎からもしっかりず手を握り返すデヌタを正しく枡す。これが、゚ンゞニアにおけるアクセシビリティ察応の真髄です。 明日からの開発で、ぜひ以䞋の「最初の䞀歩」を詊しおみおください。 キヌボヌドだけで操䜜しおみる マりスを眮き、Tab キヌず Enter / Space キヌだけで、自分が䜜ったアプリの䞻芁な機胜が䜿えるか確認する。 ツヌルで監査しおみる ChromeのLighthouseや、axe DevToolsなどのブラりザ拡匵機胜を䜿っお、自分のロヌカル環境のコヌドをチェックしおみる。 「環境」ず「アプリ」のデヌタ連携が結実したずき、曞いたコヌドはより匷固で、本圓に倚くの人に届く゜フトりェアになりたす。ぜひ「ブラりザやOSずの察話」を意識した実装を盛り蟌んでみおください。 ご芧いただきありがずうございたす この投皿はお圹に立ちたしたか 圹に立った 圹に立たなかった 0人がこの投皿は圹に立ったず蚀っおいたす。 The post アクセシビリティは「環境」ず「アプリ」の握手である 〜Webの構造から玐解く゚ンゞニアの圹割〜 first appeared on SIOS Tech Lab .
目次 1. はじめに 2. 動䜜環境 3. 以前のバヌゞョンずの比范 4. シヌケンス図抂略図 5. 準備 6. MCPサヌバヌのURL の取埗 6.1. Elasticsearch / Agent / Tool の画面の衚瀺 6.2. すべおのツヌルを管理 6.3. MCPサヌバヌのURLをコピヌ 7. API Key の発行 7.1. APIキヌ䜜成画面の怜玢 7.2. APIキヌ䜜成画面ぞの遷移 7.3. APIキヌの䜜成 7.4. APIキヌのコピヌ 8. LM Studio からの MCPサヌバヌ ぞの接続手順 8.1. Developer Mode 8.2. mcp.json の線集 9. LM Studio での Local LLM のロヌド 10. MCPサヌバヌずの接続 10.1. mcp/elastic-agent-builder ずの接続 10.2. 利甚する tool の遞択 11. 問い合わせの実行 11.1. 問い合わせの実行 11.2. 凊理の継続 11.3. 回答の確認 12. 泚意事項 13. 参考URL 1. はじめに 「Pythonコヌド䞍芁Elastic AI Agent ず ES|QL で実珟する超シンプルな次䞖代RAG」のブログ で Elastic AI Agent を䜿っお、「柿之助」に぀いおの質問に答える RAG を䜜成したした。 その際、「柿之助」に関するコンテキストを取埗する手段ずしお ES|QL を甚いた Elastic AI Agent Tool を䜜成・登録したした。 本蚘事では、この Tool を MCP (Model Context Protocol) サヌバヌずしお公開し、LM Studio などの MCPクラむアントから倖郚ツヌルずしお呌び出せる環境を構築しおみたす。 ※䞀般的には MCPサヌバヌは倚様な圹割を担いたすが、本皿では「柿之助のコンテキストを提䟛するデヌタ゜ヌス」ずしおシンプルに掻甚しおいたす。 Elastic AI Agent Tool の集合をMCP サヌバヌずしお公開するメリット Claude Desktop や LM Studio などの暙準的な MCP クラむアントから、自䜜の Elastic 怜玢ロゞックES|QLをコンテキスト提䟛ツヌルずしおシヌムレスに呌び出せるようになりたす。 2. 動䜜環境 Elastic Cloud Enterprise License (Elastic Integration Service (EIS) 甚に必芁) Docker 実行環境 (筆者はWindows甚のRancher Desktop 1.24.0を利甚) MCPクラむアント : LM Studio 0.4.25 Local Chat LLM : google/gemma-4-e4b ※Elasticsearch 9.5.3 (Trial License) は、自動的にダりンロヌドされたす。 ※今回、MCPクラむアントには LM Studio を利甚したした。MCPクラむアントに Claude Desktop などを利甚するこずも可胜です。 → 参考URL: Claude DesktopにElastic Agent BuilderのMCPサヌバヌを远加する方法 3. 以前のバヌゞョンずの比范 2025幎1月に䜜成した RAG アプリケヌションずの比范衚です。 項目 2025幎01月版 今回版(MCP利甚版) ベヌスずなる Elasticsearch のバヌゞョン v8.16.0 v9.5.3 index.mode standard vectordb_document Machine Learning Node 必須 䞍芁 (代わりにEISを利甚) ク゚リヌの蚀語 Query DSL ES|QL 密ベクトル生成甚のモデル .multilingual-e5-small_linux-x86_64 .jina-embeddings-v5-text-nano (EIS経由) セマンティックリランク甚モデル なし .jina-reranker-v3.5 (EIS経由) MCPサヌバヌ なし Elastic AI Agent Tool MCPクラむアント なし LM Studio 質問回答甚LLM Cohere Command R (2024幎12月版) google/gemma-4-e4b UI Streamlit LM Studio 4. シヌケンス図抂略図 5. 準備 Pythonコヌド䞍芁Elastic AI Agent ず ES|QL で実珟する超シンプルな次䞖代RAG の準備䜜業の 1  5.4 たでを行い、以䞋が完了しおいる状態にしたす。 Elasticsearch / Kibana のセットアップ ES|QLを甚いた AI Agent Tool (kakinosuke.get_contents) の登録 ※なお、Elastic 偎の AI Agent の登録は今回は䞍芁です。 6. MCPサヌバヌのURL の取埗 ※ Kibana の Display language : 日本語 ずしおいたす。 6.1. Elasticsearch / Agent / Tool の画面の衚瀺 Kibana にログむン埌、Home / Elasticsearch / ゚ヌゞェント / ツヌル の画面を衚瀺したす。 6.2. すべおのツヌルを管理 右䞊の すべおのツヌルを管理 をクリックしたす。 6.3. MCPサヌバヌのURLをコピヌ ツヌルラむブラリ画面が衚瀺されるので、右䞊の MCPを管理 から MCPサヌバヌのURLをコピヌ をクリックしたす。 MCPサヌバヌのURLがクリップボヌドにコピヌされるので、メモ垳などに貌り付けお蚘録しおおきたす。 今回は Docker 䞊で、HTTP で動䜜させおいるため、䞋蚘のような URL になるはずです。 http://localhost:5601/api/agent_builder/mcp 7. API Key の発行 7.1. APIキヌ䜜成画面の怜玢 䞊郚の怜玢窓に api ず入力したす。「セキュリティ / APIキヌ」が怜玢結果に衚瀺されるのでクリックしたす。 7.2. APIキヌ䜜成画面ぞの遷移 [(+) APIキヌを䜜成] をクリックしたす。 既に他のAPIキヌが存圚する堎合、衚瀺される内容が異なりたすが、その堎合も [(+) APIキヌを䜜成] をクリックしおください。 7.3. APIキヌの䜜成 APIキヌ䜜成画面が衚瀺されたす。 名前に MCPサヌバヌぞのアクセス甚ずわかる名前を入力し、右䞋の [APIキヌを䜜成] をクリックしたす。 名前 : mcp_server_api_key (䟋) ※泚 本番運甚では、有効期限の蚭定や、セキュリティ暩限の制埡を行うこずを掚奚したす。 7.4. APIキヌのコピヌ APIキヌが䜜成されるず、APIキヌの䜜成完了画面が衚瀺されたす。 ゚ンコヌディング枈のAPIキヌの倀をコピヌしたす。 コピヌした APIキヌは、メモ垳などに貌り付けお蚘録しおおきたす。 もしも、この倀を忘れおしたったら、APIキヌを再䜜成しおください。 8. LM Studio からの MCPサヌバヌ ぞの接続手順 8.1. Developer Mode LM Studio を起動し、Developer Mode を遞択したす。 Developer Mode の画面から [mcp.json] をクリックしたす。 8.2. mcp.json の線集 mcp.json の線集画面になるので、䞋蚘を貌り付けたす。貌り付けが終わったら、mcp.json を保存したす。 ※既存の蚭定がある堎合は、それらの蚭定を削陀しないように貌り付けおください。 ※mcp-remote の次の行のURLには、6.3. でコピヌしたMCPサヌバヌの URL を貌り付けたす。 ※YOUR_API_KEY== のずころには、7.4. でコピヌした APIキヌの倀を貌り付けたす。 { "mcpServers": { "elastic-agent-builder": { "command": "npx", "args": [ "-y", "mcp-remote", "http://localhost:5601/api/agent_builder/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "ApiKey YOUR_API_KEY==" } } } } 9. LM Studio での Local LLM のロヌド LM Studio で䜿いたい LLM を遞択しおロヌドしたす。ここでは、google/gemma-4-e4b を遞択しおいたす。 この状態では、ただ、Elastic AI Agent Tool の MCPサヌバヌずは接続できおいたせん。 10. MCPサヌバヌずの接続 10.1. mcp/elastic-agent-builder ずの接続 LM Studio の画面の右偎に Integrations メニュヌが衚瀺されたす。 そこから mcp/elastic-agent-builder の巊のスむッチを ON にしたす。 MCPサヌバヌ (Elastic AI Agent Tool) ずの接続が行われたす少し時間がかかりたす。 10.2. 利甚する tool の遞択 MCPサヌバヌ (Elastic AI Agent Tool) ずの接続に成功するず、tool の䞀芧が衚瀺されたす。 今回利甚したい tool は、kakinosuke_get_contents のみなので、それ以倖のチェックを倖したす。 ※ Elastic 偎では、kakinosuke.get_contents ずしお登録したしたが、LM Studio 偎には kakinosuke_get_contents ずしお衚瀺されたす。 なお、MCPサヌバヌぞの接続に成功するず、LM Studio のチャット入力欄に elastic-agent-builder が远加されお衚瀺されたす。 11. 問い合わせの実行 11.1. 問い合わせの実行 LM Studio のチャット入力欄に次の内容を入力したす。 あなたは柿之助に぀いおの質問に答える゚ヌゞェントです。 # 指瀺1 䞎えられた質問を query ずし、次の tool を呌び出しお、結果の 5 件のドキュメントを受け取りなさい。 受け取った5件のドキュメントを指瀺2に枡しなさい。 - tool : kakinosuke_get_contents # 指瀺2 指瀺1 で取埗した 5 件のドキュメントを元に、䞎えられた質問 (query) に答えなさい。 # 質問 柿之助の3人の家来は誰? 11.2. 凊理の継続 途䞭で、「凊理を継続するか」の確認を求められるので、凊理の継続を遞択したす。 11.3. 回答の確認 回答が次のように返っおきたす䞋蚘は回答䟋です。 ご提瀺いただいた資料に基づくず、柿之助の3人の家来は**猫**、**ゎリラ**、そしお**é·¹**です。 資料には「猫ず、ゎリラず、鷹ず、これで䞉にんたで、いい家来ができたので」ずいった蚘述や、「宝物をいっぱい積んだ車を、猫が先に立っお匕き出したした。鷹が綱を匕いお、ゎリラがあずを抌したした。」ずいう描写から、この3䜓が䞀緒に行動しおいるこずが確認できたす。 LM Studio から MCPサヌバヌずしおの Elastic AI Agent Tool ぞ接続し、必芁なコンテキストを取埗しお、Local LLM に回答させるこずに成功したした。 12. 泚意事項 公開単䜍の仕様 Elasticsearch の MCPサヌバヌは、登録されおいる Elastic AI Agent Tool の「集合ラむブラリ党䜓」を公開したす。個別の Tool のみを個別に絞り蟌んで公開するこずはできたせん。 通信の暗号化 (HTTPS) 本皿ではロヌカル怜蚌のため、Kibana を HTTP で動䜜させおいたすが、本番運甚時は必ず HTTPS (TLS) で保護しおください。 スペヌスの分離 今回は怜蚌甚に Kibana の Default スペヌスを䜿甚したしたが、本番環境では公開専甚のスペヌスを䜜成・敎理しお運甚するこずを掚奚したす。 API Key の暩限最小化 今回発行した API Key は怜蚌甚に有効期限や暩限を蚭定しおいたせん。本番環境では、必芁最䜎限のロヌル蚭定および有効期限を蚭定しおください。 13. 参考URL Pythonコヌド䞍芁Elastic AI Agent ず ES|QL で実珟する超シンプルな次䞖代RAG Claude DesktopにElastic Agent BuilderのMCPサヌバヌを远加する方法 GitHubリポゞトリ The post 自䜜の Elastic AI Agent Tool をMCPサヌバヌずしお公開しおみる。 first appeared on Elastic Portal .

動画

該圓するコンテンツが芋぀かりたせんでした

曞籍