amazon-bedrock

概要amazon-bedrock

Amazon Bedrock 上で生成型 AI アプリケーションを構築するための専門知識。Converse API や InvokeModel によるモデルの呼び出し、ナレッジベースを用いた検索拡張生成、Bedrock エージェント、Guardrails によるコンテンツの安全性確保、AgentCore によるエージェントのデプロイとスケーリングなどを網羅しています。 モデルの呼び出し、ナレッジベースの設定、エージェントの作成、ガードレールの適用、AgentCoreへのデプロイ、ThrottlingExceptionやAccessDeniedExceptionなどのBedrockエラーのトラブルシューティング、あるいはClaude、Llama、Nova、Titanなどのモデルの選択を行う際に活用してください。 また、プロンプトのキャッシュ、クォータのヘルスチェック、コスト追跡、モデルの移行、チャンキング戦略、AgentCore Paymentsについても扱っていますが、カスタムモデルのトレーニング、Rekognition、Comprehendについては明示的に対象外としています。 BedrockのAPI、モデルID、設定パラメータは頻繁に変更されるため、このスキルは応答を行う前に、同梱のリファレンスファイルを「主要な情報源」として必ず参照することを推奨しています。

主要なテーマの一つは、Bedrock APIの全体像です。これには5つの独立したエンドポイントが公開されており、それらの誤用はエラーの一般的な原因となっています。具体的には、モデルの一覧表示やアクセス管理を行う「bedrock control plane」、ConverseやInvokeModelを介してモデルを呼び出す「bedrock-runtime」、 OpenAI互換API用の「bedrock-mantle」（新規ユーザーに推奨）；およびエージェントの設定と起動用の「bedrock-agent」と「bedrock-agent-runtime」です。AgentCoreは、独自のコントロールプレーンおよびデータプレーンエンドポイントを持つ独立したサービスです。 このスキルでは、サンドボックス実行と監査ログ記録のために AWS MCP サーバーを推奨していますが、AWS CLI へのアクセス権を持つエージェントであればどれでも動作します。

本スキルでは、重要な警告やセキュリティ対策に重点を置いています。maxTokens は常に明示的に設定する必要があります。設定しないままにすると、必要以上に多くのクォータが予約され、予期せぬスロットリングが発生する可能性があるためです。また、Guardrails による PII マスキングはレスポンスにのみ適用され、マスキングされていないコンテンツは依然として CloudWatch に記録されます。さらに、最新の boto3 および AWS CLI v2 バージョンが必要です。 セキュリティガイダンスでは、ユーザーよりも IAM ロール、スコープ指定された権限、Secrets Manager、confused-deputy 保護、およびエージェントが生成したパラメータを信頼できない入力として扱うことが推奨されています。統一されたリクエスト/レスポンス形式のため、InvokeModel よりも Converse API が推奨されており、機能およびモデル選択テーブルは、より詳細な参照ファイルを指しています。

よくある質問

モデルを呼び出すには、どのBedrock APIを使用すべきですか？

bedrock-runtimeエンドポイントでは、Converse APIがInvokeModelよりも推奨されます。これは、すべてのモデルで統一されたリクエスト/レスポンス形式を提供するためです。InvokeModelは、ごく稀なプロバイダー固有の機能のために予約されており、新しいOpenAI互換の作業にはbedrock-mantleが推奨されます。

なぜ、すべての呼び出しで maxTokens の設定を強調しているのですか？

maxTokens を設定しない場合、デフォルトでモデルの最大値（例：Claude Sonnet では 64K）が適用され、必要以上に多くのクォータが黙って確保されてしまいます。これが予期せぬ ThrottlingException の一般的な原因となります。

Bedrock APIのエンドポイントはいくつあり、それぞれどのような用途ですか？

5つあります：bedrock（コントロールプレーン）、bedrock-runtime（モデルの呼び出し）、bedrock-mantle（OpenAI互換API）、bedrock-agent（エージェントおよびナレッジベースの設定）、bedrock-agent-runtime（エージェントの呼び出しおよびナレッジベースへのクエリ）です。 AgentCoreは、独自のエンドポイントを持つ独立したサービスです。

スキルは、Guardrails および PII についてどのような警告を出しますか？

GuardrailsによるPIIのマスキングはAPIレスポンスにのみ適用されます。PIIを含む元のマスキングされていないコンテンツは、依然として平文でCloudWatch Logsに記録されます。HIPAA/GDPRへの準拠のため、KMSを使用してこれらのログを暗号化し、アクセスを制限することを推奨しています。

このスキルは、カスタムモデルのトレーニングやRekognitionの使用に適していますか？

いいえ。このスキルは、カスタムモデルのトレーニング、Rekognition、またはComprehendを目的としたものではないと明示されています。このスキルは、モデルの呼び出し、RAG、エージェント、ガードレール、およびAgentCoreに重点を置いています。

すべてのファイル