docs(api): clarify name parameter behavior in agent task creation

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 64
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-46769b729d89151fb7e7ae15725678af99f55ef32d283e34a1e143057aa87b23.yml
-openapi_spec_hash: 9115c9f283257e0636aba67fadfeda0a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-550d6a4f6985887b66c29240e495469cc0a74e2c966175364321ae2eb15595d8.yml
+openapi_spec_hash: a93e0b4ee276d29ebd1c2f2a4c798f36
 config_hash: 82cb83ac175dbf40265128506294218b

src/agentex/types/agent_rpc_by_name_params.py

@@ -30,10 +30,20 @@ class AgentRpcByNameParams(TypedDict, total=False):
 
 class ParamsCreateTaskRequest(TypedDict, total=False):
     name: Optional[str]
-    """The name of the task to create"""
+    """Optional human-readable name for the task.
+
+    When set it must be globally unique. task/create is get-or-create by name:
+    reusing an existing name returns the existing task (with its prior history)
+    instead of creating a new one, so omit name (or make it unique, e.g. by
+    appending a UUID) whenever each call should produce a fresh task.
+    """
 
     params: Optional[Dict[str, object]]
-    """The parameters for the task"""
+    """The parameters for the task.
+
+    On a get-or-create by name, providing params overwrites the existing task's
+    params (it is not a pure read).
+    """
 
     task_metadata: Optional[Dict[str, object]]
     """Caller-provided metadata to persist on the task row.

src/agentex/types/agent_rpc_params.py

@@ -30,10 +30,20 @@ class AgentRpcParams(TypedDict, total=False):
 
 class ParamsCreateTaskRequest(TypedDict, total=False):
     name: Optional[str]
-    """The name of the task to create"""
+    """Optional human-readable name for the task.
+
+    When set it must be globally unique. task/create is get-or-create by name:
+    reusing an existing name returns the existing task (with its prior history)
+    instead of creating a new one, so omit name (or make it unique, e.g. by
+    appending a UUID) whenever each call should produce a fresh task.
+    """
 
     params: Optional[Dict[str, object]]
-    """The parameters for the task"""
+    """The parameters for the task.
+
+    On a get-or-create by name, providing params overwrites the existing task's
+    params (it is not a pure read).
+    """
 
     task_metadata: Optional[Dict[str, object]]
     """Caller-provided metadata to persist on the task row.

src/agentex/types/agents/deployment_preview_rpc_params.py

@@ -32,10 +32,20 @@ class DeploymentPreviewRpcParams(TypedDict, total=False):
 
 class ParamsCreateTaskRequest(TypedDict, total=False):
     name: Optional[str]
-    """The name of the task to create"""
+    """Optional human-readable name for the task.
+
+    When set it must be globally unique. task/create is get-or-create by name:
+    reusing an existing name returns the existing task (with its prior history)
+    instead of creating a new one, so omit name (or make it unique, e.g. by
+    appending a UUID) whenever each call should produce a fresh task.
+    """
 
     params: Optional[Dict[str, object]]
-    """The parameters for the task"""
+    """The parameters for the task.
+
+    On a get-or-create by name, providing params overwrites the existing task's
+    params (it is not a pure read).
+    """
 
     task_metadata: Optional[Dict[str, object]]
     """Caller-provided metadata to persist on the task row.