Skip to main content

​
run

Method
This is a method of the Agent class in the agent module.
Execute agent silently and return structured result. Production-friendly execution. Always uses silent mode with no streaming or verbose display, regardless of TTY status. Use this for programmatic, scripted, or automated usage where you want just the result.

​
Signature

def run(prompt: str) -> Any

​
Parameters

​
prompt
str
required
The input prompt to process **kwargs: Additional arguments: - stream (bool): Force streaming if True. Default: False - output (str): Output preset override (rarely needed)

​
Returns

​
Returns
Any
The agent’s response as a string

​
Usage

```python
    agent = Agent(instructions="You are helpful")
    result = agent.run("What is 2+2?")  # Silent, returns "4"
    print(result)
Note: Unlike .start() which enables verbose output in TTY for interactive use, .run() is always silent. This makes it suitable for:
  • Production pipelines
  • Automated scripts
  • Background processing
  • API endpoints