# 基础安装
# 包括 OpenAI-, Gemini-, and Ollama-compatible model support
pip install robotframework-aitester

# 支持 web 测试
pip install robotframework-aitester[web]

# 支持 API 测试
pip install robotframework-aitester[api]

# 支持 mobile 测试
pip install robotframework-aitester[mobile]

# 支持所有测试模式
pip install robotframework-aitester[all]

# 支持 Bedrock
pip install robotframework-aitester[all,bedrock]

# 支持 Anthropic
pip install robotframework-aitester[all,anthropic]

# Development
pip install robotframework-aitester[all,anthropic,bedrock,dev]

pip install robotframework-aitester[web]     基于Selenium的UI测试
pip install robotframework-aitester[api]     基于RequestsLibrary的API测试
pip install robotframework-aitester[mobile]     基于Appium的移动端测试

基础安装已通过 strands-agents[openai,ollama,gemini] 包含 OpenAI、Gemini 和 Ollama 提供者的支持
仅在您选择的 GenAI 后端需要这些可选提供者时，才添加 [anthropic] 或 [bedrock]

*** Settings ***
Library    SeleniumLibrary
Library    AITester    platform=OpenAI    api_key=%{OPENAI_API_KEY}    model=gpt-4o

*** Test Cases ***
AI Login Flow Test
    [Documentation]    AI agent autonomously tests the login functionality
    Open Browser    https://myapp.example.com    chrome
    ${TEST_STEPS}=    Set Variable
    ...    Test Steps:
    ...    1. Open the login page
    ...    2. Attempt login with valid credentials and verify success
    ...    3. Attempt login with invalid credentials and verify error message
    ${status}=    Run AI Test
    ...    test_objective=Test the login functionality including valid credentials,
    ...        invalid credentials, empty fields, and password recovery flow
    ...    app_context=E-commerce web application with email/password login
    ...    test_steps=${TEST_STEPS}
    ...    max_iterations=50
    Log    ${status}
    [Teardown]    Close All Browsers

AI Exploratory Testing
    [Documentation]    AI agent freely explores and tests the application
    Open Browser    https://myapp.example.com    chrome
    ${status}=    Run AI Exploration
    ...    app_context=E-commerce platform with product catalog, shopping cart and checkout
    ...    focus_areas=navigation, search, product filtering, cart operations
    ...    max_iterations=100
    Log    ${status}
    [Teardown]    Close All Browsers

API 测试

*** Settings ***
Library    RequestsLibrary
Library    AITester    platform=Ollama    model=llama3.3

*** Test Cases ***
AI REST API Test
    Create Session    api    https://api.example.com
    ${TEST_STEPS}=    Set Variable
    ...    Test Steps:
    ...    1. Create a user via POST /users
    ...    2. Fetch the user via GET /users/{id}
    ...    3. Update the user via PUT /users/{id}
    ...    4. Delete the user via DELETE /users/{id}
    ${status}=    Run AI API Test
    ...    test_objective=Test the user management API endpoints including
    ...        CRUD operations, authentication, error handling, and edge cases
    ...    base_url=https://api.example.com
    ...    api_spec_url=https://api.example.com/openapi.json
    ...    test_steps=${TEST_STEPS}
    ...    max_iterations=30
    Log    ${status}

Mobile 测试

*** Settings ***
Library    AppiumLibrary
Library    AITester    platform=Gemini    api_key=%{GEMINI_API_KEY}

*** Test Cases ***
AI Mobile App Test
    Open Application    http://localhost:4723/wd/hub
    ...    platformName=Android    app=com.example.app
    ${TEST_STEPS}=    Set Variable
    ...    Test Steps:
    ...    1. Complete the onboarding flow
    ...    2. Navigate to the main dashboard
    ...    3. Open settings and verify key options
    ${status}=    Run AI Mobile Test
    ...    test_objective=Test the onboarding flow, main navigation and settings screen
    ...    app_context=Android banking application
    ...    test_steps=${TEST_STEPS}
    ...    max_iterations=40
    Log    ${status}
    [Teardown]    Close Application

　　对于移动端测试，AITester 需要一个活跃的 AppiumLibrary 会话，并且当 app_context 和编号的 test_steps 能够明确目标屏幕、账户状态和预期路径时，效果最佳。现在它能够等待加载指示器、处理常见的选择器、隐藏屏幕键盘、切换混合上下文，并使用返回导航，而无需降级到原始的 Appium 命令。

　　对于移动探索性测试，导入库时使用 test_mode=mobile ，然后调用 Run AI Exploration 。

4.支持的 AI 平台

模型参数

　　如果你使用别名导入 SeleniumLibrary/RequestsLibrary/AppiumLibrary，请传递相应的 *_library 参数，以便 AI 工具连接到已打开的会话。

　　对于 platform=DockerModel ，AITester 会自动将 api_key=dummy 传递给兼容 OpenAI 的 Strands 客户端。对于该平台，无需设置环境变量或构造函数参数。

　　对于 platform=Manual ，请自行提供与 OpenAI 兼容的端点详细信息，通常需要同时包含 model= 和 base_url= ，如有需要，还需包含 api_key= 。

　　重要提示：AITester 只能驱动由 SeleniumLibrary/AppiumLibrary 创建的会话。如果你手动打开浏览器/应用或通过其他工具打开，代理将无法与其交互。

5.关键字