Strands Agents SDK デプロイ — AgentCore CLI でマネージドデプロイする
AgentCore CLI(Node.js)を使い、agentcore create + deploy の 2 コマンドで Strands エージェントを Bedrock AgentCore にデプロイする。セッション分離による会話継続も検証する。
「agentcore」タグが付いたコンテンツ一覧
AgentCore CLI(Node.js)を使い、agentcore create + deploy の 2 コマンドで Strands エージェントを Bedrock AgentCore にデプロイする。セッション分離による会話継続も検証する。
DynamoDB連携の家計簿MCPサーバーでStateful MCPの3機能を検証。Elicitationのdecline/cancel時のデータ整合性とSampling失敗時のフォールバック挙動を実測し、実戦投入に必要な判断材料を示す。
Agent Registry のレジストリ作成からレコード登録・承認・検索までを CLI で検証。セマンティック検索の精度、日本語クエリと英語クエリの差、MCP エンドポイント経由の検索を実測データで評価する。
SAMデプロイのハマりポイント、LocalDurableTestRunnerによるローカルテスト、実行履歴の追跡方法を実体験ベースで整理。修飾付きARN必須の罠が最初の関門。
冪等性・DurableExecutionName・並行コールバック・タイムアウト設定を実機検証。「リプレイされる前提で設計する」が全BPの共通原則だと分かった。
AWS公式の不正検知デモをデプロイし、リスクスコア別の3分岐とサスペンド動作を実機検証。チェックポイント&リプレイでwait中の課金ゼロを確認した。
AWS Security Blogの金融サービス向けエージェント型AIセキュリティ記事を解説。7つの設計原則を「権限」「追跡」「制御」の3軸で整理し、Bedrock AgentCoreによる実装アプローチを示す。
AgentCore Runtimeに追加されたマネージドセッションストレージを検証。停止・再開後のファイル復元、pip/gitワークスペースの永続化、セッション間隔離、グレースフルシャットダウンの挙動を実測データとともに共有する。
AgentCore CLI の Runtime・Memory・Gateway・Evaluations を1つのプロジェクトに統合し、ユーザーの専門分野を記憶して最新技術トレンドをパーソナライズ検索する技術トレンドアドバイザーを構築。シリーズの総集編として主要機能の統合手順と動作を検証する。
AgentCore CLI の Evaluations 機能を検証。LLM-as-a-Judge でカスタム評価器を定義し、エージェントの応答品質を on-demand で計測する手順と、リージョン制約やトレース反映のタイミングなど実運用で知っておくべきポイントを共有する。
AgentCore CLI の Gateway 機能を検証。外部 MCP サーバーをターゲットとして登録し、エージェントから Gateway 経由でツールを呼び出す手順と、プロジェクト構成の順序やデプロイ時の接続検証など実運用で知っておくべきポイントを共有する。
AgentCore CLI の Memory 機能を検証。SEMANTIC・USER_PREFERENCE・SUMMARIZATION・EPISODIC の4戦略で会話の記憶をセッション横断で永続化する手順と、抽出の非同期性やセッション ID の制約など実運用で知っておくべきポイントを共有する。
AgentCore CLIを使ってStrands Agentsプロジェクトの作成からローカル開発、AWSデプロイ、動作確認までを検証。CDKの知識なしに約1分半でエージェントをデプロイできる開発者体験と、OpenTelemetryベースのログ基盤を共有する。
AgentCore Runtime に追加された WebRTC サポートを使い、Nova Sonic による双方向音声ストリーミングエージェントを構築・デプロイする。TURN only 設定の重要性を検証で確認した。
AgentCore Code InterpreterのS3インテグレーションとPUBLICモードを検証。pip install、S3 wheel経由のオフラインインストール、sys.path直接importの3手法とクロスセッション永続性の実挙動を共有する。
AgentCore Runtimeに追加されたシェルコマンド実行APIを検証。HTTP/2ストリーミング、セッション内ファイル永続化、セッション間microVM隔離、並行実行の実挙動を実際のテスト結果とともに共有する。
AG-UIプロトコルをBedrock AgentCore Runtimeにデプロイし、SSEイベントストリームでリアルタイムにエージェント応答を配信する手順を検証。agentcore CLIによるDirect Code Deployの実体験を共有する。
Bedrock AgentCore PolicyのGA発表を受け、CedarポリシーによるGatewayのツールアクセス制御と自然言語からのCedar生成を実際に検証。default denyや自動推論バリデーションの挙動を実体験ベースで共有する。
AgentCore Memory の新機能 Memory Record Streaming を検証。Kinesis Data Streams へのプッシュ配信、FULL_CONTENT / METADATA_ONLY の挙動差、非同期抽出イベントの実測結果を共有する。
AgentCore Runtimeに追加されたStateful MCP機能を検証。Elicitation(サーバー主導の入力取得)、Sampling(LLM生成要求)、Progress Notifications(進行状況通知)の実挙動をローカルとリモートの両方で確認した。
AWS Agent Registry で AGENT_SKILLS レコードを作成する際、CLI では skillMd(dict 型)、REST API では skillMarkdown(文字列型)。descriptorType も SKILL ではなく AGENT_SKILLS。
AWS Agent Registry で MCP レコードを作成する際、name の reverse-DNS 形式、description の 100 文字制限、schemaVersion の必須指定でバリデーションエラーになる。ドキュメントの Minimal example だけでは分からない。
aws-targets.json に us-east-1 を指定しても、AWS_REGION=ap-northeast-1 が設定されていると ap-northeast-1 にデプロイされる。CLI のドキュメントに明記されていない挙動。
agentcore deploy で Unrecognized resource types: [AWS::BedrockAgentCore::Evaluator] が出たら、リージョンが原因。us-east-1 では動く。
Gateway ターゲットの MCP サーバーが到達不能だと agentcore deploy が CloudFormation ROLLBACK で失敗する。エラーメッセージは Failed to connect and fetch tools from the provided MCP target server。
agentcore remove all --force はローカルの設定ファイルをリセットするだけで、AWS上のリソースは残る。実際の削除には追加で agentcore deploy が必要。
agentcore invoke --session-id に短い文字列を指定すると Member must have length greater than or equal to 33 エラーになる。UUID 形式か十分な長さの識別子を使う。
AgentCore Runtime が VPC 内に作成した ENI は destroy 後も数時間 in-use のまま残ることがある。サブネットや VPC の削除は ENI が available になってから再試行する。
bedrock-agentcore-control(作成・削除)と bedrock-agentcore(セッション操作・コード実行)を混同すると AttributeError になる。
create-agent-runtimeでコード構成を使う際、S3にPythonファイルを直接置くと「S3 object must be in .zip format」エラーになる。ZIPに固めてからアップロードする必要がある。
ドキュメントには「Stateless between commands」とあるが、実際にはファイルシステムは同一セッション内で共有される。引き継がれないのはシェルヒストリーや環境変数だけだった。
codeConfigurationのentryPointにスペースを含む値やドットで始まる値を指定すると「Invalid entrypoint value」エラーが出る。Pythonランタイムなら["main.py"]のようにファイル名だけを指定する。
agentcore deploy中に「X-Ray Delivery Destination is supported with CloudWatch Logs as a Trace Segment Destination」が出るが、メモリリソース作成時のみの問題でランタイムには影響しない。
agentcore configureでDirect Code Deployを選択すると「Direct Code Deploy deployment unavailable (uv not found)」エラーが出る。pip install uvで解決するが公式ドキュメントに記載がない。
Bedrock AgentCore PolicyでCedar permitにwhen句を付けずに作成するとCREATE_FAILEDになる。FAIL_ON_ANY_FINDINGSの自動推論が原因。
Bedrock AgentCore GatewayはハイフンのみでPolicy Engineはアンダースコアのみ。同じプレフィックスを使い回すとValidationExceptionになる。
batch-update-memory-records の timestamp 必須や、memory-strategies のキー名 semanticMemoryStrategy / namespaceTemplates など、ドキュメントと AWS CLI の差異をまとめた。