ブログ
Strands Agents SDK デプロイ — OpenTelemetry でエージェントのトレースを可視化する
Strands Agents SDK に組み込まれた OpenTelemetry サポートを有効化し、エージェントの推論・ツール呼び出しをトレースとして Jaeger で可視化する。エージェントコードの変更は 2 行だけ。
← すべてのタグ
タグ: #bedrock
「bedrock」タグが付いたコンテンツ一覧
ブログ記事
ブログ
Strands Agents SDK デプロイ — AgentCore CLI でマネージドデプロイする
AgentCore CLI（Node.js）を使い、agentcore create + deploy の 2 コマンドで Strands エージェントを Bedrock AgentCore にデプロイする。セッション分離による会話継続も検証する。
ブログ
Strands Agents SDK デプロイ — Lambda にサーバーレスデプロイする
Strands Agents SDK の公式 Lambda Layer を使い、ハンドラー関数を書くだけでサーバーレスエージェントをデプロイする。コールドスタートとウォームスタートの実測値も共有する。
ブログ
Strands Agents SDK デプロイ — エージェントを HTTP API 化して Docker コンテナにする
Strands Agents SDK のエージェントを FastAPI でラップして HTTP API 化し、Docker コンテナとしてパッケージングする。async def のハングや SSO 認証の問題など、実際に遭遇したハマりポイントも共有する。
ブログ
Stateful MCPを実戦投入する前に検証したエッジケース
DynamoDB連携の家計簿MCPサーバーでStateful MCPの3機能を検証。Elicitationのdecline/cancel時のデータ整合性とSampling失敗時のフォールバック挙動を実測し、実戦投入に必要な判断材料を示す。
ブログ
Strands Agents SDK マルチエージェント — マルチエージェントパターンの選び方
Strands Agents SDK の Agents as Tools・Swarm・Graph の 3 パターンで同じタスクを実行し、構造的な違いをメトリクスで比較する。ユースケースに応じたパターン選択の基準を整理する。
ブログ
Strands Agents SDK マルチエージェント — Swarm と Graph をネストして組み合わせる
Strands Agents SDK で Swarm を Graph のノードとして埋め込み、自律協調と構造化ワークフローを組み合わせる。ネスト構成の実行結果とマルチエージェント Hooks によるノード監視をコードで確認する。
ブログ
Strands Agents SDK マルチエージェント — Graph でワークフローを構造化する
Strands Agents SDK の Graph パターンで決定論的なワークフローを構築する。GraphBuilder で逐次・並列・条件分岐・フィードバックループを実際に動かし、Graph の全体像をコードと実行結果で確認する。
ブログ
Strands Agents SDK マルチエージェント — Swarm でエージェントを自律的に協調させる
Strands Agents SDK の Swarm パターンを実際に動かし、エージェント同士が自律的にハンドオフしながらタスクを遂行する仕組みをコードと実行結果で確認する。Agents as Tools との違いも比較する。
ブログ
AWS Agent Registry の承認ワークフロー・検索精度・MCP エンドポイントを実機検証する
Agent Registry のレジストリ作成からレコード登録・承認・検索までを CLI で検証。セマンティック検索の精度、日本語クエリと英語クエリの差、MCP エンドポイント経由の検索を実測データで評価する。
ブログ
Strands Agents SDK 実践 — メトリクスでエージェントを最適化する
Strands Agents SDK の result.metrics を深掘りし、サイクル数・トークン量・ツール実行時間を分析する。ツール設計の違いがパフォーマンスに与える影響をメトリクスで比較し、エージェントの最適化ポイントを特定する。
ブログ
Strands Agents SDK 実践 — Guardrails で入出力をフィルタリングする
Strands Agents SDK に Bedrock Guardrails を適用し、エージェントの入出力を自動フィルタリングする。ガードレール発動時の挙動と、Hooks を使ったシャドーモード（監視のみ）の実装をコードで確認する。
ブログ
Strands Agents SDK 実践 — Hooks でエージェントループを制御する
Strands Agents SDK の Hooks でエージェントループに処理を差し込む。ツール呼び出しのログ記録、回数制限、結果の加工を実際のコードで確認し、エージェントの動作をリアルタイムで制御する方法を学ぶ。
ブログ
Strands Agents SDK 実践 — セッション管理で会話を永続化する
Strands Agents SDK の FileSessionManager で会話をファイルに永続化し、プロセス再起動後も復元できることを確認する。保存されるデータ構造と S3 への切り替え方法もコードで解説する。
ブログ
Strands Agents SDK 実践 — Structured Output で LLM の出力を型安全にする
Strands Agents SDK の Structured Output を実際に動かし、Pydantic モデルで LLM の出力を型安全なオブジェクトに変換する。ツールとの併用やバリデーション自動リトライの仕組みをコードとメトリクスで確認する。
ブログ
Lambda Durable Functions 不正検知実践 — デプロイ・テスト・運用の知見
SAMデプロイのハマりポイント、LocalDurableTestRunnerによるローカルテスト、実行履歴の追跡方法を実体験ベースで整理。修飾付きARN必須の罠が最初の関門。
ブログ
Lambda Durable Functions 不正検知実践 — 6つのベストプラクティスを実機検証する
冪等性・DurableExecutionName・並行コールバック・タイムアウト設定を実機検証。「リプレイされる前提で設計する」が全BPの共通原則だと分かった。
ブログ
Lambda Durable Functions 不正検知実践 — デモで理解する基本動作と3つの分岐
AWS公式の不正検知デモをデプロイし、リスクスコア別の3分岐とサスペンド動作を実機検証。チェックポイント＆リプレイでwait中の課金ゼロを確認した。
ブログ
エージェント型AIのセキュリティは「人間と同じ扱い」から始まる：金融業界の7原則を読み解く
AWS Security Blogの金融サービス向けエージェント型AIセキュリティ記事を解説。7つの設計原則を「権限」「追跡」「制御」の3軸で整理し、Bedrock AgentCoreによる実装アプローチを示す。
ブログ
Bedrock の tool use で AI 駆動 A/B テストの意思決定エンジンを検証する
AWS ブログで紹介された AI 駆動 A/B テストエンジンの核心 — Bedrock Converse API の tool use を活用したモデルによる意思決定 — を実装・検証。プロンプトに含める文脈情報の有無でバリアント選択が逆転する現象を確認し、tool use でモデルに意思決定させる際の設計指針を整理した。
ブログ
Bedrock AgentCore Runtimeのマネージドセッションストレージでエージェントの作業状態を停止・再開をまたいで永続化する
AgentCore Runtimeに追加されたマネージドセッションストレージを検証。停止・再開後のファイル復元、pip/gitワークスペースの永続化、セッション間隔離、グレースフルシャットダウンの挙動を実測データとともに共有する。
ブログ
AgentCore CLI 実践 — 主要機能を統合して技術トレンドアドバイザーを構築する
AgentCore CLI の Runtime・Memory・Gateway・Evaluations を1つのプロジェクトに統合し、ユーザーの専門分野を記憶して最新技術トレンドをパーソナライズ検索する技術トレンドアドバイザーを構築。シリーズの総集編として主要機能の統合手順と動作を検証する。
ブログ
AgentCore CLI 実践 — Evaluations でエージェントの品質を計測する
AgentCore CLI の Evaluations 機能を検証。LLM-as-a-Judge でカスタム評価器を定義し、エージェントの応答品質を on-demand で計測する手順と、リージョン制約やトレース反映のタイミングなど実運用で知っておくべきポイントを共有する。
ブログ
AgentCore CLI 実践 — Gateway で外部MCPサーバーを接続する
AgentCore CLI の Gateway 機能を検証。外部 MCP サーバーをターゲットとして登録し、エージェントから Gateway 経由でツールを呼び出す手順と、プロジェクト構成の順序やデプロイ時の接続検証など実運用で知っておくべきポイントを共有する。
ブログ
AgentCore CLI 実践 — Memory で会話の記憶を永続化する
AgentCore CLI の Memory 機能を検証。SEMANTIC・USER_PREFERENCE・SUMMARIZATION・EPISODIC の4戦略で会話の記憶をセッション横断で永続化する手順と、抽出の非同期性やセッション ID の制約など実運用で知っておくべきポイントを共有する。
ブログ
AgentCore CLI 実践 — 4コマンドでAIエージェントをAWSにデプロイする
AgentCore CLIを使ってStrands Agentsプロジェクトの作成からローカル開発、AWSデプロイ、動作確認までを検証。CDKの知識なしに約1分半でエージェントをデプロイできる開発者体験と、OpenTelemetryベースのログ基盤を共有する。
ブログ
Agentic AI on EKS 実践 — A2Aプロトコルでマルチエージェント連携
Travel AgentからWeather AgentへのA2A委譲をEKS上で検証。エージェントカードのURL問題とS3セッション履歴によるLLMコンテキスト汚染という2つのハマりどころを解説する。
ブログ
Agentic AI on EKS 実践 — AIエージェントをデプロイする
AWS公式ワークショップ「Agentic AI on EKS」を検証。Strands Agents SDKとMCPによるツール自動発見の仕組みと、KanikoによるEKS上コンテナビルドの実践知見を共有する。
ブログ
Bedrock AgentCore Runtime の WebRTC サポートで音声エージェントを構築する
AgentCore Runtime に追加された WebRTC サポートを使い、Nova Sonic による双方向音声ストリーミングエージェントを構築・デプロイする。TURN only 設定の重要性を検証で確認した。
ブログ
Strands Evalsで AIエージェントを体系的に評価する — 6つの機能を実機検証
Strands Agents SDKの評価フレームワーク Strands Evals の主要機能を実際に動かして検証した。決定的評価からLLM判定、マルチターンシミュレーション、テストケース自動生成まで網羅する。
ブログ
Bedrock AgentCore Code Interpreterでプリインストールされていないライブラリをインストールして使う
AgentCore Code InterpreterのS3インテグレーションとPUBLICモードを検証。pip install、S3 wheel経由のオフラインインストール、sys.path直接importの3手法とクロスセッション永続性の実挙動を共有する。
ブログ
Bedrock AgentCore RuntimeのInvokeAgentRuntimeCommand APIでエージェントセッション内からシェルコマンドを実行する
AgentCore Runtimeに追加されたシェルコマンド実行APIを検証。HTTP/2ストリーミング、セッション内ファイル永続化、セッション間microVM隔離、並行実行の実挙動を実際のテスト結果とともに共有する。
ブログ
Bedrock AgentCore RuntimeのAG-UIプロトコルでエージェントUIをストリーミング配信する
AG-UIプロトコルをBedrock AgentCore Runtimeにデプロイし、SSEイベントストリームでリアルタイムにエージェント応答を配信する手順を検証。agentcore CLIによるDirect Code Deployの実体験を共有する。
ブログ
Bedrock AgentCore Policyで自然言語からCedarポリシーを生成しエージェントのツールアクセスを制御する
Bedrock AgentCore PolicyのGA発表を受け、CedarポリシーによるGatewayのツールアクセス制御と自然言語からのCedar生成を実際に検証。default denyや自動推論バリデーションの挙動を実体験ベースで共有する。
ブログ
Bedrock AgentCore Memory のストリーミング通知で長期メモリの変更をリアルタイムに検知する
AgentCore Memory の新機能 Memory Record Streaming を検証。Kinesis Data Streams へのプッシュ配信、FULL_CONTENT / METADATA_ONLY の挙動差、非同期抽出イベントの実測結果を共有する。
ブログ
Bedrock AgentCore RuntimeのStateful MCPサーバーでElicitation・Sampling・Progress Notificationsを動かす
AgentCore Runtimeに追加されたStateful MCP機能を検証。Elicitation（サーバー主導の入力取得）、Sampling（LLM生成要求）、Progress Notifications（進行状況通知）の実挙動をローカルとリモートの両方で確認した。
ブログ
Strands Agents SDK 入門 — マルチエージェントで専門家チームを作る
Strands Agents SDK の Agents as Tools パターンで複数エージェントを協調させる。要約エージェントと翻訳エージェントをオーケストレーターが連携させる実例をコードとメトリクスで確認する。
ブログ
Strands Agents SDK 入門 — 会話の記憶とコンテキスト管理
Strands Agents SDK のマルチターン会話と SlidingWindowConversationManager を実際に動かし、エージェントが会話を記憶する仕組みとコンテキストウィンドウの管理方法をコードで確認する。
ブログ
Strands Agents SDK 入門 — MCP で外部ツールを接続する
Strands Agents SDK に MCP (Model Context Protocol) サーバーを接続し、外部ツールでエージェントを拡張する。AWS ドキュメント検索 MCP サーバーを実際に動かし、自作ツールとの併用パターンをコードとメトリクスで確認する。
ブログ
Strands Agents SDK 入門 — カスタムツールの設計パターン
Strands Agents SDK のカスタムツールを深掘りする。ツールの連鎖でマルチステップ動作を実現し、エラー時の LLM の挙動やシステムプロンプトによる出力制御を実際のコードとメトリクスで確認する。
ブログ
Strands Agents SDK 入門 — Quickstart でエージェントループを理解する
Strands Agents SDK の Python Quickstart を実際に動かし、エージェントループ・カスタムツール・メトリクスの仕組みをコード付きで解説する。わずか数十行で動くエージェントの手軽さと設計思想が見えてくる。
TIL
TIL
サイクルがある Graph では set_entry_point が必須
Strands Agents SDK の Graph でサイクル（フィードバックループ）を含む場合、build() の自動エントリポイント検出が失敗して ValueError が発生する。set_entry_point で明示的に指定する必要がある。
TIL
Graph の result.execution_time は 0ms を返すのでノード合計で計算する
Strands Agents SDK の Graph で result.execution_time が 0ms を返す。ノードごとの execution_time は正しく記録されるので、合計値を自分で計算する必要がある。
TIL
Swarm でハンドオフしたエージェントのテキスト出力は空になる
Strands Agents SDK の Swarm でハンドオフしたエージェントの result にテキストブロックがない。handoff_to_agent ツール呼び出しで終了するため。最終出力はハンドオフしなかったエージェントが生成する。
TIL
Bedrock Guardrails 発動時にユーザー入力が自動で書き換えられる
Strands Agents で Bedrock Guardrails がブロックすると、会話履歴のユーザー入力が [User input redacted.] に自動書き換えされる。会話履歴をデバッグしていて入力が消えていたらこれが原因。
TIL
Strands Agents の Structured Output は内部的にツールとして動作する
structured_output_model に渡した Pydantic モデルがメトリクスの tool_usage にツールとして表示される。デバッグ時に見慣れないツール名が出たらこれが原因。
TIL
Bedrock Converse API の tool use はモデルが1ターンで複数ツールを並列呼び出しする
Bedrock Converse API の tool use で 3 種類・計 4 回のツール呼び出しが必要なシナリオで、モデルが 1 回のレスポンスですべてを同時に要求した。逐次呼び出しを想定していたが、並列対応が必要だった。
TIL
agentcore remove allはAWSリソースを削除しない
agentcore remove all --force はローカルの設定ファイルをリセットするだけで、AWS上のリソースは残る。実際の削除には追加で agentcore deploy が必要。
TIL
agentcore destroy 後の VPC 削除で DependencyViolation が出たら ENI の解放を待つ
AgentCore Runtime が VPC 内に作成した ENI は destroy 後も数時間 in-use のまま残ることがある。サブネットや VPC の削除は ENI が available になってから再試行する。
TIL
Bedrock Foundation Model の IAM ポリシーではアカウント ID を空にする
Foundation Model の ARN は arn:aws:bedrock:region::foundation-model/... のようにアカウント ID が空。サンプルの ACCOUNT_ID プレースホルダーをそのまま置換すると権限が効かない。
TIL
AgentCore の boto3 クライアントはコントロールプレーンとデータプレーンで分かれている
bedrock-agentcore-control（作成・削除）と bedrock-agentcore（セッション操作・コード実行）を混同すると AttributeError になる。
TIL
AgentCore Runtimeのコード構成はS3にZIPで置かないとValidationExceptionになる
create-agent-runtimeでコード構成を使う際、S3にPythonファイルを直接置くと「S3 object must be in .zip format」エラーになる。ZIPに固めてからアップロードする必要がある。
TIL
AgentCore RuntimeのInvokeAgentRuntimeCommandはStatelessと書いてあるがファイルシステムは同一セッション内で永続化する
ドキュメントには「Stateless between commands」とあるが、実際にはファイルシステムは同一セッション内で共有される。引き継がれないのはシェルヒストリーや環境変数だけだった。
TIL
AgentCore Runtimeのコード構成でentryPointに「python3 main.py」を指定するとバリデーションエラーになる
codeConfigurationのentryPointにスペースを含む値やドットで始まる値を指定すると「Invalid entrypoint value」エラーが出る。Pythonランタイムなら["main.py"]のようにファイル名だけを指定する。
TIL
agentcore deployのX-Ray ValidationExceptionはメモリリソース限定で無害
agentcore deploy中に「X-Ray Delivery Destination is supported with CloudWatch Logs as a Trace Segment Destination」が出るが、メモリリソース作成時のみの問題でランタイムには影響しない。
TIL
agentcore CLIのDirect Code Deployにはuvが必要
agentcore configureでDirect Code Deployを選択すると「Direct Code Deploy deployment unavailable (uv not found)」エラーが出る。pip install uvで解決するが公式ドキュメントに記載がない。
TIL
AgentCore Policyで条件なしのCedar permitはOverly Permissiveで自動拒否される
Bedrock AgentCore PolicyでCedar permitにwhen句を付けずに作成するとCREATE_FAILEDになる。FAIL_ON_ANY_FINDINGSの自動推論が原因。
TIL
AgentCore GatewayとPolicy Engineで命名規則が異なる
Bedrock AgentCore GatewayはハイフンのみでPolicy Engineはアンダースコアのみ。同じプレフィックスを使い回すとValidationExceptionになる。
TIL
AgentCore Memory の CLI パラメータ名はドキュメントのスキーマと異なる箇所がある
batch-update-memory-records の timestamp 必須や、memory-strategies のキー名 semanticMemoryStrategy / namespaceTemplates など、ドキュメントと AWS CLI の差異をまとめた。