OpenAI Agents Behaviour

[nhessler]

Describe the feature or improvement you're requesting

A lot of what's required for defining an agent is also part of the documentation process for methods. maybe there is a behaviour or something that could be used to define similar or use the existing options like @doc and spec.

I'd be happy to help with this, and could put something together for a more formal proposal as well.

Additional context

No response