概要前提条件ブラウザプロファイルの開始方法ブラウザプロファイルオペレーションユースケース考慮事項

ブラウザプロファイルの使用

ブラウザプロファイルを使用すると、複数のブラウザセッションでブラウザプロファイルデータを永続化および再利用できます。ブラウザプロファイルは、Cookie やローカルストレージなどのセッション情報を保存します。

たとえば、ブラウザセッションで 1 回ウェブサイトに認証し、プロファイルデータをブラウザプロファイルリソースに保存できます。その保存されたプロファイルで新しいブラウザセッションを開始すると、認証状態は保持され、ログインしたままになります。これにより、エージェントは手動での介入を必要とせずに、認証されたウェブサイトでタスクを実行できます。

概要

Amazon Bedrock AgentCore のブラウザプロファイルは、次のように機能します。

ブラウザセッション間で再利用されるブラウザプロファイルリソースを作成する
ブラウザセッションを開始し、Cookie とローカルストレージに入力するアクションを実行する (ウェブサイトのログインやショッピングカートへの商品の配置など)
現在のブラウザセッションからブラウザプロファイルリソースにプロファイルデータを保存する
保存したプロファイルを使用して新しいブラウザセッションを開始し、以前の状態を復元する

前提条件

ブラウザプロファイルを使用する前に、以下を確認してください。

一般的なブラウザの前提条件を完了しました

プロファイルリソースを管理するための IAM アクセス許可。IAM ポリシーに次のアクセス許可を追加します。


{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreBrowserProfileManagementAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateBrowserProfile",
                "bedrock-agentcore:ListBrowserProfiles",
                "bedrock-agentcore:GetBrowserProfile",
                "bedrock-agentcore:DeleteBrowserProfile"
            ],
            "Resource": "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-profile/*"
        }
    ]
}

プロファイルを保存およびロードするための IAM アクセス許可。IAM ポリシーに次のアクセス許可を追加します。


{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreBrowserProfileUsageAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:StartBrowserSession",
                "bedrock-agentcore:SaveBrowserSessionProfile"
            ],
            "Resource": [
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-profile/*",
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-custom/*",
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser/*"
            ]
        }
    ]
}

ブラウザプロファイルの開始方法

このセクションでは、ブラウザプロファイルの作成、セッションデータの保存、後続のセッションでのプロファイルの再利用について説明します。

ステップ 1: ブラウザプロファイルを作成する

セッションデータを保存するブラウザプロファイルリソースを作成します。

例

ステップ 2: ブラウザセッションを開始し、アクションを実行する

ブラウザセッションを開始し、ウェブサイトのログインなどのアクションを実行します。Cookie やローカルストレージなどのセッション状態がキャプチャされます。

例

ステップ 3: セッションをプロファイルに保存する

ブラウザセッションでアクションを実行したら、現在の状態をブラウザプロファイルに保存します。これにより、Cookie、ローカルストレージ、およびその他のセッションデータがキャプチャされます。

例

ステップ 4: プロファイルを使用して新しいセッションを開始する

保存したプロファイルを使用して新しいブラウザセッションを開始します。セッションは、認証 Cookie やローカルストレージなど、保存された状態で初期化されます。

例

AWS CLI

AWS CLI を使用してプロファイルでブラウザセッションを開始するには:


aws bedrock-agentcore start-browser-session \
  --region <Region> \
  --browser-identifier "aws.browser.v1" \
  --name "session-with-profile" \
  --session-timeout-seconds 3600 \
  --profile-configuration '{
    "profileIdentifier":"<ProfileId>"
  }'

Boto3

Boto3 を使用してプロファイルでブラウザセッションを開始するには:


import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore', region_name=region)

response = client.start_browser_session(
    browserIdentifier="aws.browser.v1",
    name="session-with-profile",
    sessionTimeoutSeconds=3600,
    profileConfiguration={
        "profileIdentifier": profile_id  # From Step 1
    }
)

new_session_id = response['sessionId']
print(f"New session started with profile: {new_session_id}")
print("Session is now authenticated with saved cookies and state")

API

API を使用してプロファイルでブラウザセッションを開始するには:


awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/start" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "name": "session-with-profile",
    "sessionTimeoutSeconds": 3600,
    "profileConfiguration": {
      "profileIdentifier": "<ProfileId>"
    },
    "clientToken": "8FAAFF7F-7803-4C40-A7BD-139C6D008646"
  }'

ブラウザプロファイルオペレーション

このセクションでは、ブラウザプロファイルを管理するための追加のオペレーションについて説明します。

ブラウザプロファイルの一覧表示

アカウント内のすべてのブラウザプロファイルを一覧表示できます。

例

ブラウザプロファイルの詳細の取得

特定のブラウザプロファイルに関する詳細を取得できます。

例

ブラウザプロファイルの削除

ブラウザプロファイルが不要になった場合は、削除してリソースを解放できます。

例

ユースケース

ブラウザプロファイルは、次の場合に便利です。

永続的認証: 毎回再認証することなく、複数のブラウザ呼び出しでログインセッションを維持します。
マルチステップワークフロー: 状態とコンテキストを保持しながら複数のセッションにまたがる複雑なワークフローを実行する (Cookie またはローカルストレージ内)
自動タスク: AI エージェントは、手動による介入なしで認証されたウェブサイトでタスクを実行できます。

考慮事項

プロファイルの永続性: 保存オペレーションを明示的に呼び出すと、プロファイルデータが保存されます。状態を維持するために、セッションを終了する前に必ずプロファイルを保存してください。
セッションの分離: プロファイルを使用する各ブラウザセッションは独立して動作します。1 つのセッションで行われた変更は、他の同時セッションでは表示されません。
プロファイルのロード: 保存されたプロファイルの変更は、新しいセッションにのみ適用されます。アクティブなセッションは、開始された時点からプロファイル状態を使用し続け、セッション開始後にプロファイルに加えられた更新は反映されません。
セキュリティ: ブラウザプロファイルには、認証 Cookie などの機密データが含まれている場合があります。プロファイルリソースへのアクセスを制限するための適切な IAM ポリシーが設定されていることを確認します。
プロファイルの更新: セッションをプロファイルに保存すると、以前のプロファイルデータが上書きされます。重要な状態情報が失われないように、ワークフローを慎重に検討してください。
Cookie の有効期限: Cookie には、ウェブサイトによって設定された独自の有効期限があります。ブラウザプロファイルは Cookie を保持しますが、期限切れの Cookie は有効期限に従ってブラウザによって自動的に削除されます。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ブラウザ拡張機能

ブラウザプロキシ