Customise AI Agent Searching with Amazon Bedrock AgentCore Browser Proxies, Profiles, and Extensions

AI brokers that browse the online want greater than primary web page navigation. Our clients say they need an agent that maintains session state all through the interplay, routes visitors by means of the corporate’s proxy infrastructure, and runs with a customized browser configuration. AgentCore Browser offers a safe, remoted browser setting for brokers to work together with net functions. Beforehand, the Agent Core Browser began every browser session with a clean slate with default settings and direct web entry, limiting what brokers might accomplish in a real-world company setting.

At present, we’re saying three new options that tackle these necessities: Proxy Configuration, Browser Profiles, and Browser Extensions. Collectively, these options offer you fine-grained management over how your AI brokers work together with the online.

These three options can help you management how AgentCore browser classes hook up with the Web, the state they preserve, and their conduct. Proxy configuration means that you can route browser visitors by means of your individual proxy server, offering IP stability and integration along with your company community infrastructure. Browser profiles persist cookies and native storage between classes, permitting brokers to renew authenticated workflows with out repeating the login movement. Browser extensions load Chrome extensions into your session to customise browser conduct in your use case. This submit explains every function with configuration examples and real-world utilization examples that can assist you get began.

How persistent browser profiles preserve AI brokers operating easily

Prospects constructing brokers for e-commerce testing, authenticated workflows, and multi-step person journeys require browser classes that keep in mind state. With out persistent profiles, brokers should re-authenticate and rebuild context in the beginning of every session, including delays and vulnerabilities to automated workflows. Browser profiles resolve this drawback by saving and restoring cookies and native storage between classes. So an agent who logged into the portal yesterday can choose up the place they left off immediately.

IP stability can be a standard requirement. Healthcare and monetary portals validate classes primarily based on supply IP tackle, however when AWS IP addresses are rotated, re-authentication cycles happen steadily, disrupting long-running workflows. Proxy assist permits visitors to be routed by means of a server with a steady egress IP, thus sustaining session continuity and assembly IP whitelisting necessities. Organizations that route visitors by means of company proxies ought to prolong this observe to AI brokers for browser classes. Proxy configuration permits entry to inside net pages and sources that require proxy-based connections.

Browser extensions allow customized configurations equivalent to advert blocking, authentication helpers, and different browser-level customizations. These options, mixed with proxy logging, may also help present proof for entry management and auditing. Could compliance program FedRAMP, HITRUST, PCI, and so on..

Characteristic 1: Proxy configuration

browser Now helps routing browser visitors by means of your individual exterior proxy server. If you create a browser session utilizing a proxy configuration, AgentCore configures your browser to route HTTP and HTTPS visitors by means of the desired proxy server.

construction

you name StartBrowserSession and proxyConfiguration Specify a proxy server. When utilizing authentication, AgentCore obtains proxy credentials from AWS Secrets and techniques Supervisor. Your browser session begins along with your proxy settings utilized, and your browser visitors is routed by means of the proxy server primarily based in your area routing guidelines.

Begin utilizing a proxy

Please meet these conditions earlier than continuing.

import boto3 
import json 
consumer = boto3.consumer('secretsmanager') 
consumer.create_secret( 
    Title="my-proxy-credentials", 
    SecretString=json.dumps({ 
        'username': '<your-username>', 
        'password': '<your-password>' 
    }) 
) 

Step 2: Create a browser session utilizing proxy configuration

session_client = boto3.consumer('bedrock-agentcore', region_name="<area>") 
 
response = session_client.start_browser_session( 
    browserIdentifier="aws.browser.v1", 
    title="my-proxy-session", 
    proxyConfiguration={ 
        "proxies": [{ 
            "externalProxy": { 
                "server": "<your-proxy-hostname>", 
                "port": 8080, 
                "credentials": { 
                    "basicAuth": { 
                        "secretArn": "arn:aws:secretsmanager:<region>:<account-id>:secret:<secret-name>" 
                    } 
                } 
            } 
        }] 
    } 
) 
print(f"Session ID: {response['sessionId']}")

Credentials fields are non-compulsory for unauthenticated proxies.

domain-based routing

use domainPatterns route a particular area by means of a specified proxy, and bypass.domainPatterns For domains that require a direct connection:

proxyConfiguration={ 
    "proxies": [ 
        { 
            "externalProxy": { 
                "server": "corp-proxy.example.com", 
                "port": 8080, 
                "domainPatterns": [".company.com", ".internal.corp"] 
            } 
        }, 
        { 
            "externalProxy": { 
                "server": "general-proxy.instance.com", 
                "port": 8080 
            } 
        } 
    ], 
    "bypass": { 
        "domainPatterns": [".amazonaws.com"] 
    } 
}

This configuration makes the next requests: and inside.corp Route by way of firm proxy, request to amazonaws.com Bypass all proxiesevery part else is routed by means of the generic proxy. These discipline enamel This is only one instance. bypass area can match bypass.domainPatterns Join on to exterior proxy can turn into legitimate agent’s domainPatterns Route by means of that proxy (first match takes priority primarily based on array order).

Routing precedence

When the AgentCore Browser processes outbound requests, it follows three layers of routing guidelines to find out the place to ship the visitors. First test the bypass listing. If the vacation spot area matches, bypass.domainPatterns After including the entry, requests will join on to the web with out utilizing a proxy. If the area doesn’t match the bypass guidelines, AgentCore will domainPatterns Route the request by means of the primary proxy that matches the sample, so as. If neither proxy sample matches, the request is forwarded to the default proxy. The default proxy is domainPatterns Outlined.

Now take a look at the brand new proxy performance code example.

Characteristic 2: Browser profile

Browser profiles can help you persist and reuse session information equivalent to cookies and native storage throughout a number of browser classes. Brokers who authenticate with the online portal in a single session can restore that state in a later session with out having to log in once more. That is helpful for authenticated workflows the place re-logins enhance latency, e-commerce checks the place buying cart and type information should persist between classes, and multi-step person journeys that span a number of browser calls.

There are 4 phases within the profile lifecycle. Begin by calling create_browser_profile() Create a named profile. On the finish of the session, save_browser_session_profile() Captures present cookies and native storage to that profile. When beginning a brand new session, enter your profile identifier. profileConfiguration parameters of start_browser_session()the saved state might be restored to the brand new browser. For those who not want the profile, delete_browser_profile() To wash it up.

The next instance reveals an agent including gadgets to a buying cart in a single session and guaranteeing that they persist in subsequent classes.

Please meet these conditions earlier than continuing.

import boto3 

control_client = boto3.consumer('bedrock-agentcore-control', region_name="<area>") # change by your area 

session_client = boto3.consumer('bedrock-agentcore', region_name="<area>") # change by your area  
 
# Create a browser profile 
profile = control_client.create_browser_profile(title="ecommerce_profile") 
profile_id = profile['profileId'] 
 
# Session 1: Add gadgets to cart 
session1 = session_client.start_browser_session( 
    browserIdentifier=”aws.browser.v1”, 
    title="shopping-session-1" 
) 
# ... agent navigates and provides gadgets to cart ... 
 
# Save session state to profile 
session_client.save_browser_session_profile( 
    sessionId=session1['sessionId'], 
    browserIdentifier=”aws.browser.v1”, 
    profileIdentifier=profile_id 
) 
session_client.stop_browser_session(sessionId=session1['sessionId'], browserIdentifier="aws.browser.v1") 
 
# Session 2: Resume with saved profile 
session2 = session_client.start_browser_session( 
    browserIdentifier=”aws.browser.v1”, 
    title="shopping-session-2", 
    profileConfiguration={"profileIdentifier": profile_id} 
) 
# Cart gadgets from Session 1 are actually accessible 

Now take a look at the brand new profile function code example.

Characteristic 3: Browser extension

Browser extensions can help you load Chrome extensions into your AgentCore browser session to customise browser conduct. Bundle your extension as a ZIP file and add it to: Amazon Simple Storage Service (Amazon S3), seek advice from them once you begin a browser session. This offers entry to options accessible by means of the Chrome Extension API, from proxy routing and advert blocking to authentication helpers and content material modification. For instance, you’ll be able to inject authentication tokens for inside functions, take away advertisements, observe scripts that intervene with agent navigation, and modify web page content material to enhance how brokers work together along with your web site.

Extensions should observe requirements chrome extension Format and cling to Chromium extension pointers.

Please meet these conditions earlier than continuing.

1. Add your extension to Amazon S3.

   # Add extension to S3 
   
   import boto3 
   s3 = boto3.consumer('s3') 
   s3.upload_file( 
       'my-extension.zip', 
       'amzn-s3-demo-bucket-extensions', 
       'extensions/my-extension.zip' 
   ) 

2. Subsequent, use the extension to begin a session by specifying the Amazon S3 bucket the place you uploaded the zip file.

   import boto3 
   area = "<area>" # change by your area 
   consumer = boto3.consumer('bedrock-agentcore', region_name=area) 
   
   response = consumer.start_browser_session( 
       browserIdentifier="aws.browser.v1", 
       title="my-session-with-extensions", 
       sessionTimeoutSeconds=1800, 
       viewPort={ 
           'peak': 1080, 
           'width': 1920 
       }, 
       extensions=[ 
           { 
               "location": { 
                   "s3": { 
                       "bucket": "amzn-s3-demo-bucket-extensions", 
                       "prefix": "extensions/my-extension.zip" 
                   } 
               } 
           }, 
           { 
               "location": { 
                   "s3": { 
                       "bucket": "amzn-s3-demo-bucket-extensions", 
                       "prefix": "extensions/another-extension.zip", 
                       "versionId": "abc123"  # Optional - for versioned S3 buckets 
                   } 
               } 
           } 
       ] 
   ) 
    
   print(f"Session ID: {response['sessionId']}") 
   print(f"Standing: {response['status']}") 
   print(f"Automation Stream: {response['streams']['automationStream']['streamEndpoint']}") 

Now take a look at your new extension code example.

conclusion

Proxy configurations, browser profiles, and browser extensions present AgentCore Browser with the proxy routing, session persistence, and scalability controls that clients have to deploy web-browsing AI brokers in manufacturing environments. Whereas retaining your credentials secure with AWS Secrets and techniques Supervisor, you’ll be able to route visitors by means of your organization’s proxy infrastructure, preserve session continuity throughout interactions, and customise browser conduct utilizing extensions. Prospects can convey e-commerce context and data between classes, create their very own extensions and take a look at them in a safe setting earlier than launch, and join their browsers to the community by means of a proxy.

See the next tutorials to get began: Amazon Bedrock Agent Core Sample Repositories and Amazon Bedrock AgentCore Browser doc. For pricing particulars, please go to: Amazon Bedrock Agent Core Pricing.

In regards to the creator