aws / aws/bedrock-agentcore-sdk-python

browser_session() and BrowserClient.start() do not support proxyConfiguration

オープン
#275 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
enhancement tools
主要言語
Python
スター
764
フォーク
148
平均マージ
1日 23時間
マージ済み PR(30日)
7

説明

### Description

The [Browser Proxy](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/browser-proxies.html) feature launched GA on February 10, 2026, and the underlying `StartBrowserSession` Boto3 API fully supports the `proxyConfiguration` parameter. However, the `bedrock-agentcore` SDK (v1.3.1) does not expose this parameter in `browser_session()` or `BrowserClient.start()`.

Customers who want to use proxy configuration through the high-level SDK are forced to drop down to raw Boto3 calls, bypassing the SDK's session lifecycle management, WebSocket header generation, and live view URL generation.

### Expected behavior

```python
from bedrock_agentcore.tools.browser_client import browser_session

proxy_config = {
"proxies": [
{
"externalProxy": {
"server": "proxy.example.com",
"port": 8080,
"domainPatterns": [".example.com", ".internal.corp"],
"credentials": {
"basicAuth": {
"secretArn": "arn:aws:secretsmanager:us-east-1:123456789012:secret:proxy-creds"
}
}
}
}
],
"bypass": {
"domainPatterns": [".amazonaws.com", "169.254.169.254"]
}
}

with browser_session("us-east-1", proxy_configuration=proxy_config) as client:
ws_url, headers = client.generate_ws_headers()
# ... use proxied session
```

### Current behavior

`browser_session()` accepts only `region`, `viewport`, and `identifier`. There is no way to pass proxy configuration through the SDK.

### Proposed changes

1. Add `proxy_configuration: Optional[Dict] = None` parameter to `BrowserClient.start()`, passing it as `proxyConfiguration` to the Boto3 `start_browser_session` call
2. Add `proxy_configuration: Optional[Dict] = None` parameter to `browser_session()`, forwarding it to `BrowserClient.start()`
3. Add TypedDict definitions for the proxy configuration structure (improves developer experience with IDE autocomplete)
4. Bump minimum `boto3`/`botocore` to `>=1.42.54` (the version that added `proxyConfiguration` to the `bedrock-agentcore` service model)

### SDK version

`bedrock-agentcore` v1.3.1

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

browser_session() と BrowserClient.start() のエントリーポイントを特定し、start_browser_session がどのように呼び出されているかを確認します。既存のパラメータ転送と依存関係の宣言を追跡し、proxy_configuration が Boto3 リクエストに到達すること、両方の公開エントリーポイントがこれを受け付けること、必要なサービスモデルのバージョンがサポートされていることを確認します。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
aws, python
領域
api, cloud
issue の種類
機能追加
難易度
3/5
見積もり時間
1〜2日
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
55/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。