Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
simplify
mertunsall5e5c84c81c17
diff --git a/examples/sandbox/structured_output.py b/examples/sandbox/structured_output.pyindex 75e951253..7cbda97c1 100644--- a/examples/sandbox/structured_output.py+++ b/examples/sandbox/structured_output.py@@ -1,9 +1,5 @@"""Example of using structured output with sandbox execution-This example demonstrates how to get typed Pydantic output from sandbox:-1. Using return type annotation AgentHistoryList[MyModel] - structured_output property works automatically-2. Using get_structured_output(MyModel) method - works even without type annotation-To run:export BROWSER_USE_API_KEY=your_keypython examples/sandbox/structured_output.py@@ -18,7 +14,6 @@ from browser_use import Agent, Browser, ChatBrowserUse, sandboxfrom browser_use.agent.views import AgentHistoryList-# Define structured output schemaclass IPLocation(BaseModel):"""Structured output for IP location data"""@@ -28,11 +23,9 @@ class IPLocation(BaseModel):region: str | None = Field(default=None, description='Region/state if available')-# Method 1: Return type annotation with generic parameter-# The structured_output property will work automatically@sandbox(log_level='INFO')-async def get_ip_with_type_hint(browser: Browser) -> AgentHistoryList[IPLocation]:- """Sandbox function with typed return - structured_output works automatically"""+async def get_ip_location(browser: Browser) -> AgentHistoryList:+ """Get IP location using sandbox"""agent = Agent(task='Go to ipinfo.io and extract my IP address and location details (country, city, region)',browser=browser,@@ -42,77 +35,22 @@ async def get_ip_with_type_hint(browser: Browser) -> AgentHistoryList[IPLocationreturn await agent.run(max_steps=10)-# Method 2: Return type without generic parameter-# Use get_structured_output(schema) method instead-@sandbox(log_level='INFO')-async def get_ip_without_generic(browser: Browser) -> AgentHistoryList:- """Sandbox function with non-generic return type - use get_structured_output() method"""- agent = Agent(- task='Search DuckDuckGo for "what is my ip" and extract the IP address and location shown in results',- browser=browser,- llm=ChatBrowserUse(),- output_model_schema=IPLocation,- )- return await agent.run(max_steps=10)--async def main():if not os.getenv('BROWSER_USE_API_KEY'):print('❌ Please set BROWSER_USE_API_KEY environment variable')print(' Get a key at: https://cloud.browser-use.com/new-api-key')return- print('=' * 60)- print('Sandbox Structured Output Example')- print('=' * 60)-- # Example 1: With type hint - structured_output property works- print('\n📍 Method 1: Using return type annotation')- print(' Return type: AgentHistoryList[IPLocation]')- print(' Access via: result.structured_output')- print('-' * 60)-- result1 = await get_ip_with_type_hint()+ result = await get_ip_location()+ location = result.get_structured_output(IPLocation)- # structured_output property works because return type was annotated- location1 = result1.structured_output- if location1:- print('\n✅ Got structured output via property:')- print(f' IP Address: {location1.ip_address}')- print(f' Country: {location1.country}')- print(f' City: {location1.city or "N/A"}')- print(f' Region: {location1.region or "N/A"}')+ if location:+ print(f'IP: {location.ip_address}')+ print(f'Country: {location.country}')+ print(f'City: {location.city or "N/A"}')+ print(f'Region: {location.region or "N/A"}')else:- print('❌ No structured output (check if task completed successfully)')- print(f' Final result: {result1.final_result()}')-- # Example 2: Without generic type parameter - use get_structured_output method- print('\n' + '=' * 60)- print('\n📍 Method 2: Using get_structured_output() method')- print(' Return type: AgentHistoryList (no generic parameter)')- print(' Access via: result.get_structured_output(IPLocation)')- print('-' * 60)-- result2 = await get_ip_without_generic()-- # structured_output property returns None (no generic type parameter)- assert result2.structured_output is None, 'Expected None without generic type parameter'- print('\n result.structured_output is None (expected - no generic param)')-- # But get_structured_output with explicit schema works- location2 = result2.get_structured_output(IPLocation)- if location2:- print('\n✅ Got structured output via method:')- print(f' IP Address: {location2.ip_address}')- print(f' Country: {location2.country}')- print(f' City: {location2.city or "N/A"}')- print(f' Region: {location2.region or "N/A"}')- else:- print('❌ No structured output (check if task completed successfully)')- print(f' Final result: {result2.final_result()}')-- print('\n' + '=' * 60)- print('Done!')+ print(f'No structured output. Final result: {result.final_result()}')if __name__ == '__main__':