This method combines starting the agent and waiting for its completion in one operation. It’s the recommended way to run tasks that need to complete before proceeding

Parameters

task
str
required

The task description to execute (required).

url
str | None

Optional URL to process, defaults to None.

response_format
type[pydantic.main.BaseModel] | None

The response format to use for the agent answer. You can use a Pydantic model or a JSON Schema dict.

Returns

AgentStatusResponse: The final status response after task completion.

Raises

  • TimeoutError: If the agent doesn’t complete within the maximum allowed attempts.