feat: Improve Docs

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browser-use%2Fbrowser-use-3a9488448292a0736b08b2d6427e702eaf7106d86345ca2e65b64bed4398b036.yml
-openapi_spec_hash: 5ff2781dcc11a0c9aa353f5cb14bcc16
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browser-use%2Fbrowser-use-9f5ca0cd0a64c620cebceaebf7c6f8c3a917aa6fbc2ea6b9d2a6e3b9d17aaea4.yml
+openapi_spec_hash: 3d30ebd2ed6ab3a5b42b6b267a45d34f
 config_hash: 9d52be5177b2ede4cb0633c04f4cc4ef

src/browser_use_sdk/resources/tasks.py

@@ -69,12 +69,12 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskCreateResponse:
         """
-        Create and start a new AI agent task.
+        Create and start a new Browser Use Agent task.
 
         This is the main endpoint for running AI agents. You can either:
 
-        1. Start a new session with a new task
-        2. Add a follow-up task to an existing session
+        1. Start a new session with a new task.
+        2. Add a follow-up task to an existing session.
 
         When starting a new session:
 
@@ -95,9 +95,8 @@ def create(
         - Browser profiles: Control browser settings and environment (only used for new
           sessions)
         - File uploads: Include documents for the agent to work with
-        - Structured output: Define the format you want results in
-        - Task metadata: Add custom data for tracking and organization (useful when
-          using webhooks)
+        - Structured output: Define the format of the task result
+        - Task metadata: Add custom data for tracking and organization
 
         Args:
 
@@ -564,12 +563,12 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskCreateResponse:
         """
-        Create and start a new AI agent task.
+        Create and start a new Browser Use Agent task.
 
         This is the main endpoint for running AI agents. You can either:
 
-        1. Start a new session with a new task
-        2. Add a follow-up task to an existing session
+        1. Start a new session with a new task.
+        2. Add a follow-up task to an existing session.
 
         When starting a new session:
 
@@ -590,9 +589,8 @@ async def create(
         - Browser profiles: Control browser settings and environment (only used for new
           sessions)
         - File uploads: Include documents for the agent to work with
-        - Structured output: Define the format you want results in
-        - Task metadata: Add custom data for tracking and organization (useful when
-          using webhooks)
+        - Structured output: Define the format of the task result
+        - Task metadata: Add custom data for tracking and organization
 
         Args: