TIL
AWS SSO の認証情報は Docker コンテナに直接渡せない
~/.aws をマウントしても SSO トークンの解決に失敗する。boto3 から一時認証情報を取得して環境変数で渡す方法が確実。
TIL
Today I Learned — 日々の学びを記録
TIL
FastAPI の async def で Strands agent() を呼ぶとハングする
Strands Agents SDK の agent() はブロッキング呼び出しなので、FastAPI の async def エンドポイント内で呼ぶとイベントループがブロックされてリクエストがハングする。def に変えれば解決する。
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
Agent Registry の AGENT_SKILLS レコードは CLI と REST API でパラメータ名が異なる
AWS Agent Registry で AGENT_SKILLS レコードを作成する際、CLI では skillMd（dict 型）、REST API では skillMarkdown（文字列型）。descriptorType も SKILL ではなく AGENT_SKILLS。
TIL
Agent Registry の MCP レコード作成は server.json スキーマの制約に注意
AWS Agent Registry で MCP レコードを作成する際、name の reverse-DNS 形式、description の 100 文字制限、schemaVersion の必須指定でバリデーションエラーになる。ドキュメントの Minimal example だけでは分からない。
TIL
RDS Proxy 経由の Blue/Green Switchover では AdminShutdown ではなく SSL 切断が発生する
Aurora PostgreSQL の Blue/Green Switchover 中、ドキュメントでは AdminShutdown エラーが記載されているが、RDS Proxy 経由では SSL connection has been closed unexpectedly が発生する。エラーハンドリングの設計時に注意が必要。
TIL
EKS Auto Mode クラスターにマネージドノードグループを追加するには vpc-cni 等のアドオンが必要
EKS Auto Mode で作成したクラスターにマネージドノードグループを追加すると NodeCreationFailure (cni plugin not initialized) で失敗する。vpc-cni、kube-proxy、coredns アドオンの手動インストールで解決する。
約1分
TIL
amazon-efs-utils v2.x がインストール済みだと公式インストーラーで v3.0.0 にアップグレードされない
S3 Files に必要な amazon-efs-utils v3.0.0 を公式インストーラースクリプトでインストールしようとしたが、v2.x が既に入っていると v3.0.0 にならなかった。未インストール状態で実行すれば解決する。