Skip to main content
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.
​
session_offset
int | None
[Experimental] The step from which the agent should gather information from in the session. If none, fresh memory

​
Returns

AgentStatusResponse: The final status response after task completion.

​
Raises

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