with notte.Session() as session:
    agent = notte.Agent(session=session)
    agent.run(task="go to notte.cc and explain what their product is")
This function is synchronous and will block the main thread until the agent is completed.
Websockets are used to stream the agent logs to the standard output to provide live logs to the user.

​
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.