fix: set USE_DOCSTRING as default for ai_callable

[longcw]

@llm.ai_callable need a explicit description=llm.USE_DOCSTRING to use the docstring as the description.

[changeset-bot]

🦋 Changeset detected

Latest commit: 8d8b11b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
livekit-agents	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[davidzhao]

this is rather annoying tho as a requirement.. wdyt about just making that the default behavior?

if no explicit description is provided, it'll use docstring. if docstring isn't set, it raises

[longcw]

I think that makes sense, most people will explicitly set a description or write that in the docstring.

At least the current example is very misleading, I've always assumed that I just need to set the description at docstring, but it actually also needs description=llm.USE_DOCSTRING to take effect.

[davidzhao]

I think that makes sense, most people will explicitly set a description or write that in the docstring.

At least the current example is very misleading, I've always assumed that I just need to set the description at docstring, but it actually also needs description=llm.USE_DOCSTRING to take effect.

honestly I did too.. 🤦 I think it should just "do the obvious thing" here..

[davidzhao]

@longcw do you wanna take a stab at making it the default behavior?

[longcw]

@davidzhao sure, updated.