Nova Act SDK

适用于 Amazon Nova Act 的 Python SDK。

Amazon Nova Act 是一项全新的 AWS 服务，旨在构建和管理可靠的 AI Agent 集群，以在大规模生产环境中自动化处理基于 UI 的工作流。Nova Act 能够自动完成浏览器中的重复性 UI 工作流，并在必要时将任务升级给人工监督员处理。你可以结合自然语言的灵活性与 Python 代码来定义工作流。只需几个简单的步骤，即可在 nova.amazon.com/act 的网页端沙盒（Playground）中进行探索，在 IDE 中进行开发和调试，部署至 AWS，并在 AWS 控制台中监控你的工作流。

（预览版）Nova Act 还通过 API 调用、远程 MCP 或智能体框架（如 Strands Agents）与外部工具集成。

⚠️ 重要提示：Nova Act SDK 3.0 以下版本已不再支持。用户必须升级到最新版本，以获取安全更新和新功能。

请遵循以下升级说明：

# 升级到最新版本
pip install --upgrade nova-act

# 检查当前版本
pip show nova-act

目录

• 前提条件
• Nova Act IDE 扩展
• Nova Act 认证与安装
• 快速开始
• 如何向 Nova Act 发送指令
• 工作流
• 从网页中提取信息
• 人工参与 (HITL)
• 工具（浏览器之外，预览版）
• 并行运行多个会话
• 持久化浏览器会话
• 处理敏感数据
• 验证码 (Captchas)
• 网站搜索
• 文件上传与下载
• 处理浏览器对话框
• 处理日期
• 设置浏览器 User Agent
• 使用代理
• 工作时长追踪工具
• 日志记录与查看追踪
• 录制会话视频
• 将会话数据存储在 Amazon S3
• 页面导航
• 查看无头模式会话
• 将 Nova Act SDK 与 Amazon Bedrock AgentCore 浏览器工具结合使用
• 已知限制
• 披露
• 报告漏洞
• 参考：Nova Act 构造函数参数
• 参考：操作浏览器
• 参考：Nova Act CLI

前提条件

1. 操作系统：MacOS Sierra+、Ubuntu 22.04+、WSL2 或 Windows 10+
2. Python：3.10 或更高版本

注意： Nova Act 目前支持英文。

设置

快速设置 IDE 扩展

使用 Nova Act 扩展加速你的开发流程。该扩展可自动配置 Nova Act 开发环境，将整个 Agent 开发体验直接引入你的 IDE，从而实现“对话即生成脚本”、浏览器会话调试以及分步测试功能。有关安装说明和详细文档，请访问扩展代码仓库或网站。

认证

API Key 认证

注意：当使用 Nova Act 沙盒和/或选择通过 API Key 认证使用 Nova Act 开发工具时，访问和使用受 nova.amazon.com 使用条款约束。

前往 https://nova.amazon.com/act 并生成 API Key。

要在终端中将其保存为环境变量，请执行：

export NOVA_ACT_API_KEY="your_api_key"

基于 IAM 的认证

注意：当选择通过 AWS IAM 认证的开发工具和/或将工作流部署到 Nova Act AWS 服务时，适用你的 AWS 服务条款和/或客户协议（或其他规范你使用 AWS 服务的协议）。

Nova Act 也支持使用 IAM 凭证进行认证。有关详细信息，请参阅 Amazon Nova Act 用户指南文档。如需使用基于 IAM 的凭证，请使用 Workflow 构造（见工作流）。请注意，如果你的环境中已经配置了 AWS 凭证，SDK 将自动实例化一个默认的 boto 会话。

安装

pip install nova-act

或者，你可以构建 nova-act。克隆此仓库，然后执行：

pip install .

[可选] 安装 Google Chrome

Nova Act 与 Google Chrome 配合使用效果最佳，但没有权限自动安装此浏览器。如果你已经安装了 Chrome，可以跳过此步骤。