为什么值得关注

它将自然语言 Gherkin、云端托管浏览器、并行执行和全链路可观测性整合在一个可直接运行的演示中，还附带一个实时查看浏览器操作的 Web 界面。

适合谁使用

评估 AI 驱动端到端测试的 QA 工程师
使用 Amazon Bedrock AgentCore Browser 的开发者
使用或评估 Langfuse/OpenTelemetry 进行 LLM 追踪的团队
需要 AI QA 演示素材的技术演讲者或 Demo 构建者

典型使用场景

无需 CSS/XPath 选择器，用 Gherkin 场景对真实网站执行测试
以可配置并发数并行运行冒烟测试
在 Langfuse 中查看 agent 的模型调用、token、成本和浏览器动作
在演讲或演示中展示 AWS Console 的 Live View 实时浏览器会话

项目优势

支持西班牙语或英语的自然语言 Gherkin，不需要手写选择器或 Playwright 代码
每个场景在独立的云端浏览器会话中并行运行
每次运行在 Langfuse 中以 session/trace 组织，包含模型调用、token、成本与浏览器动作
单元测试完全 mock 掉 AWS 和网络，当前覆盖率为 100%，并配置了 lint、format 和类型检查

使用前须知

需要 Python 3.12+、uv、具备特定 Bedrock AgentCore 权限的 AWS 凭证，以及 Bedrock 模型访问权限
实时查看功能依赖额外的 AWS 权限和五分钟过期的签名 URL
该项目是演示级别，未定位为完整的生产级测试框架

README 快速开始

QA Agent — Strands Agents + AgentCore Browser + Langfuse

Demo de QA automático con agentes: un agente construido con Strands Agents SDK ejecuta casos de prueba escritos en Gherkin contra un sitio real, usando el browser gestionado de Amazon Bedrock AgentCore. Cada escenario corre en paralelo en su propia sesión de browser en la nube, y toda la ejecución queda trazada en Langfuse vía OpenTelemetry.

Gherkin (.feature) ──► Runner (asyncio, N en paralelo)
                            │  un agente Strands por escenario
                            ▼
                     AgentCore Browser (Chrome gestionado en AWS)
                            │  navega, hace clic, lee la página
                            ▼
                     Veredicto estructurado (PASS/FAIL + evidencia)
                            │
                            ▼            trazas OTel
                     Reporte en consola      ──►  Langfuse

Requisitos

Python 3.12+ y uv
Credenciales AWS configuradas (aws sts get-caller-identity) con permisos bedrock-agentcore:*BrowserSession* y bedrock:InvokeModel*
Model access a Claude habilitado en la consola de Bedrock
Cuenta en Langfuse Cloud (gratis) con API keys del proyecto

Setup

uv sync
cp .env.example .env   # y llena las keys de Langfuse

Uso

# Listar escenarios del feature
uv run qa-agent features/tuasistente.feature --list

# Ver los prompts sin llamar al agente
uv run qa-agent features/tuasistente.feature --dry-run

# Correr UN escenario
uv run qa-agent features/tuasistente.feature -s "La home carga con la propuesta de valor"

# Correr TODOS en paralelo (3 sesiones de browser concurrentes por defecto)
uv run qa-agent features/tuasistente.feature

# Subir la concurrencia
uv run qa-agent features/tuasistente.feature --parallel 5

Exit code 0 si todo pasó, 1 si hubo fallos — listo para CI.

Webapp con Live View

La demo también se puede ejecutar desde una interfaz local que recibe el feature Gherkin y muestra una tarjeta por escenario con el navegador de AgentCore en vivo:

# Terminal 1: API que lanza los agentes
uv run qa-agent-web

# Terminal 2, sólo para desarrollar la interfaz (abre http:

qa-strands-agentcore