翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
注記
インラインエージェント機能の設定と呼び出しは、Amazon Bedrock のプレビューリリースであり、変更される可能性があります。
インラインエージェントを呼び出す前に、次の前提条件を満たしてください。
インラインエージェントの設定に使用する基盤モデル、エージェントを呼び出すリージョン、およびインラインエージェントに実行すべきことを指示する指示を決定します。
インラインエージェントに使用する次の Amazon Bedrock エージェントプロパティを 1 つ以上作成または準備します。
フィールド ユースケース actionGroups アクショングループのリストと、インラインエージェントが実行できるアクションを定義する各アクショングループを指定します。たとえば、CreateAppointment、CreateAppointment、GetAppointment CancelAppointmentを定義できます。 guardrailConfiguration トピックをブロックし、ハルシネーションを防ぎ、アプリケーションの保護を実装するようにガードレールを設定します。 knowledgeBases knowledgeBases をインラインエージェントに関連付けて、モデルによって生成されたレスポンスを補強します。ナレッジベースは、ユーザークエリへの回答やドキュメントの分析だけでなく、プロンプトにコンテキストを提供することで基盤モデルに提供されるプロンプトを強化するためにも使用できます。 promptOverridenConfiguration エージェントシーケンスのさまざまな部分にオーバーライドプロンプトを設定して、インラインエージェントの精度を向上させます。 customerEncryptionArn インラインエージェントの暗号化に使用する AWS KMS キーの Amazon リソースネーム (ARN) を指定します。 -
AWS Identity and Access Management (IAM) ロールを作成し、このステップで説明したポリシーをロールにアタッチします。
インラインエージェントを呼び出す前に、
InvokeInlineAgentAPI を使用し、Lambda 関数、ナレッジベース、基盤モデルなどのリソースにアクセスするために必要なアクセス許可を提供する IAM ロールを作成する必要があります。「IAM ユーザーに権限を委任するロールの作成」の手順に従って、インラインエージェントのカスタムサービスロールを作成します。IAM ロールを作成したら、次のポリシーをロールにアタッチします。
注記
セキュリティ上のベストプラクティスとして、
${region}、${account-id}、*.idsをリージョン、アカウント ID、および特定のリソース ID に置き換えます。{ "Version": "2012-10-17", "Statement": [ { "Sid": "InvokeInlineAgent", "Effect": "Allow", "Action": "bedrock:InvokeInlineAgent" } { "Sid": "InvokeFoundationModel", "Effect": "Allow", "Action": "bedrock:InvokeModel", "Resource": "arn:aws:bedrock:${region}::foundation-model/{modelId}" }, { "Sid": "S3AccessForKBAndActions", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectMetadata" ], "Resource": "arn:aws:s3:::" }, { "Sid": "S3AccessForCodeInterpreter", "Effect": "Allow", "Action": [ "s3:GetObjectVersion", "s3:GetObjectVersionAttributes", "s3:GetObjectAttributes" ], "Resource": "arn:aws:s3:::bucket/path/to/file" }, { "Sid": "KnowledgeBaseAccess", "Effect": "Allow", "Action": [ "bedrock:Retrieve", "bedrock:RetrieveAndGenerate" ], "Resource": "arn:aws:bedrock:${region}:${account-id}:knowledge-base/knowledge-base-id" }, { "Sid": "GuardrailAccess", "Effect": "Allow", "Action": "bedrock:ApplyGuardrail", "Resource": "arn:aws:bedrock:${region}:${account-id}:guardrail/${guardrail-id}" }, { "Sid": "LambdaInvoke", "Effect": "Allow", "Action": "lambda:InvokeFunction", "Resource": "arn:aws:lambda:${region}:${account-id}:function:function-name" }, { "Sid": "KMSAccess", "Effect": "Allow", "Action": [ "kms:GenerateDataKey*", "kms:Decrypt" ], "Resource": "arn:aws:kms:${region}:${account-id}:key/${key-id}" } ] }
