AgentCore
AWS Bedrock AgentCore 提供带有 SigV4 认证的云浏览器会话。当您在 AWS 环境中运行 agent-browser，或需要由 AWS 基础设施支持的托管云浏览器时，请使用它。
设置¶
凭据会自动从以下位置解析：
- 环境变量（
AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY） - AWS CLI（
aws configure export-credentials），支持 SSO、配置文件、IAM 角色等。
或者在 CI/脚本中使用环境变量：
-p 标志优先于 AGENT_BROWSER_PROVIDER。
配置¶
| 变量 | 描述 | 默认值 |
|---|---|---|
AGENTCORE_REGION | AgentCore 端点的 AWS 区域 | us-east-1 |
AGENTCORE_BROWSER_ID | 浏览器标识符 | aws.browser.v1 |
AGENTCORE_PROFILE_ID | 用于持久化状态（cookies、localStorage）的浏览器配置文件 | （无） |
AGENTCORE_SESSION_TIMEOUT | 会话超时时间（秒） | 3600 |
AWS_PROFILE | 用于凭据解析的 AWS CLI 配置文件 | default |
AWS_ACCESS_KEY_ID | AWS 访问密钥（在 AWS CLI 回退之前检查） | （无） |
AWS_SECRET_ACCESS_KEY | AWS 秘密访问密钥 | （无） |
AWS_SESSION_TOKEN | 临时会话令牌（用于 STS/SSO 凭据） | （无） |
浏览器配置文件¶
使用 AGENTCORE_PROFILE_ID 跨会话持久化浏览器状态（cookies、localStorage）：
设置配置文件后，AgentCore 会在会话之间自动存储和恢复浏览器状态。
实时视图¶
会话启动时，AgentCore 会将实时视图 URL 打印到 stderr：
Session: abc123-def456
Live View: https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#
在浏览器中打开此 URL，即可从 AWS 控制台实时查看代理会话。
凭据解析¶
AgentCore 使用轻量级的手动 SigV4 签名（不依赖 AWS SDK）。凭据按以下顺序解析：
- 环境变量（
AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY，可选AWS_SESSION_TOKEN） - AWS CLI（
aws configure export-credentials --format env），支持 SSO、IAM 角色、凭据文件和配置文件
如果使用 SSO，请在启动 agent-browser 之前运行 aws sso login。设置 AWS_PROFILE 以选择特定的命名配置文件。
示例¶
# Basic usage (credentials auto-resolved via AWS CLI)
agent-browser -p agentcore open https://example.com
# With a browser profile for persistent login state
AGENTCORE_PROFILE_ID=my-profile agent-browser -p agentcore open https://x.com/home
# With explicit region
AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://example.com
# With SSO profile
AWS_PROFILE=my-sso-profile agent-browser -p agentcore open https://example.com
启用后，agent-browser 将连接到 AgentCore 云浏览器会话，而不是启动本地浏览器。所有命令的工作方式完全相同。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 agen/agent-browser